Adr

---
name: adr
description: 重要な判断を、決めた当時の背景・選んだ理由・捨てた選択肢ごと意思決定記録（docs/decisions/）に残す。判断をしたとき、後から「なぜそう決めたか」を辿れるようにしたいときに使う。
disable-model-invocation: true
---

# /adr

## 何をするか

人間が下した判断を、company の意思決定記録（ADR）として `docs/decisions/` に起票する。
記録は `status: proposed` で作る。`accepted` にするのは人間の判断で、CC は人間の指示があったときだけ変える。

```text
proposed → accepted
         → rejected
accepted → superseded（新しい記録に置き換えられた）
```

提案（`docs/proposals/`）との違い：提案は「憲章を変えたい・外部行動をしたい」という承認待ちの下書き。
意思決定記録は「判断をした」という事実と理由の記録で、承認のパイプラインを通らない。

## 何を読むか

1. `${CLAUDE_SKILL_DIR}/../../templates/skill-conventions.md`（共通規約。最初に必ず読む）
2. `${CLAUDE_SKILL_DIR}/../../templates/decisions/_template.md`（雛形）
3. `docs/charter/decision-rules.md`（この判断が承認の要るものかを確かめる）
4. `docs/decisions/` の既存の記録（同じ主題の記録を探す。置き換えにあたるか、矛盾しないか）
5. 判断の根拠になる文書（現況、台帳、レビューなど）。共通規約の鮮度の期限を超えていれば、その日数を告げる

## 手順

1. 質問 1 を聞く。引数（`/adr <主題>`）があればそれを出発点にする
2. `docs/charter/decision-rules.md` に照らし、承認が要る判断（外部に影響が出る行動、憲章の変更）なら、
   意思決定記録に加えて提案（`docs/proposals/`）も要ることを告げる
3. 既存の記録から同じ主題のものを探し、あれば示して質問 2 を聞く
4. 質問 3〜5 を聞く。答えが無い項目は「まだ決めていない」と書く
5. ID を決める：`YYYYMMDD-nn`（今日の日付と、`docs/decisions/` の中で今日の連番）。ファイル名は `<ID>-<英語の短い slug>.md`
6. 雛形から記録を書き出す（`status: proposed`）。数字を根拠にしたなら `as_of` にその数字の基準日を書く。無ければ `n/a`
7. 書き出した記録を示し、質問 6 を聞く
   - 人間が「accepted にする」と答えたら `status: accepted`、`updated` を今日にする
   - 置き換えの場合は、新しい記録に `supersedes: <古い ID>` を足し、古い記録を `status: superseded` にして
     「## 置き換え」に新しい ID を書く（古い記録を変える前に質問 7 を聞く）

## 何を書くか

- `docs/decisions/<ID>-<slug>.md`
- 置き換えのときは古い記録の `status` と「## 置き換え」
- 日報への実行記録（例：`- 14:20 /adr — 20261001-01 を起票（proposed）`）

## 人に何を聞くか

表の番号の順に聞く。聞き方は共通規約の「人への質問」に従う。

| 番号 | 見出し | 質問文 | 答えの形 | 選択肢 | 聞くとき |
|---|---|---|---|---|---|
| 1 | 決めたこと | 何を決めましたか。 | 自由記述 | — | 常に（引数があれば、それを示して確かめる） |
| 2 | 置き換え | 上の既存の記録と同じ主題です。この判断は、既存の記録を置き換えますか。 | 選択肢（単一） | 置き換える / 置き換えない | 同じ主題の既存の記録があるとき |
| 3 | 背景 | この判断の背景を教えてください。何が問題で、なぜ今決めたのですか。 | 自由記述 | — | 常に |
| 4 | 他の選択肢 | 検討した他の選択肢と、選ばなかった理由を教えてください。 | 自由記述 | — | 常に |
| 5 | 影響 | この判断で何が変わりますか。撤退条件があれば教えてください。 | 自由記述 | — | 常に |
| 6 | 記録の確定 | この記録を accepted にしますか。 | 選択肢（単一） | accepted にする / proposed のまま | 記録を書き出した後 |
| 7 | 古い記録の変更 | 古い記録を superseded にし、「## 置き換え」に新しい ID を書いてよいですか。 | 選択肢（単一） | 書く / 書かない | 質問 2 で「置き換える」を選んだとき |
| 8 | コミット | 書いたファイルをコミットしてよいですか。 | 選択肢（単一） | コミットする / しない | 最後（ファイルを書いたとき） |

## 完了条件

- 記録がフロントマターの規約に合い、`id` がファイル名の先頭と一致している
- `status` が人間の答えどおり（`proposed` か `accepted`）になっている
- 置き換えのときは、新旧の記録が互いを参照している
- 日報に実行記録が 1 行ある