applejxd/adr

ADR 作成・更新スキル

引数

• $ARGUMENTS で決定内容・タイトル・ADR 番号を受け取る。
• 指定がなければ現在の作業コンテキストから推定するか、ユーザーに確認する。

前提確認

docs/adr/ ディレクトリを探して以下を確認する:

• 既存 ADR ファイルの一覧と最大番号（次番号の決定に使用）
• docs/adr/README.md の有無（存在すれば完了時に更新）

docs/adr/ が存在しない場合はユーザーに確認してから最初の ADR ファイル作成時に自動生成する。

実行フロー

1. 情報収集（不足分のみ 1 メッセージで質問）

以下が未確定の場合に限り、1 メッセージにまとめて質問する:

• 決定の背景・問題・制約（Context）
• 採用した解決策（Decision）
• 検討した他の選択肢とその却下理由
• 決定者・関係者（任意）

既存の会話から読み取れる情報は確認不要。

2. 番号・ファイル名の決定

• 既存 ADR の最大番号 + 1 を新規番号とする（4 桁ゼロ埋め）
• ファイル名: NNNN-kebab-case-title.md（例: 0003-use-postgresql.md）

3. ADR ドラフト作成

${CLAUDE_SKILL_DIR}/references/adr-template.md をベースに ADR を作成する。

品質基準:

• ステータス: 決定済みなら Accepted、検討中なら Proposed
• Context: 「なぜこの決定が必要か」を具体的に記述する
• Decision: 「何を」「なぜ」採用したかを明確に記述する
• Consequences: トレードオフを正直に記述する（隠さない）
• Options Considered: 採用案を含め 2 つ以上

4. レビュー出力（書き込み前に必ず実施）

ユーザーに以下を提示し、明示承認を待つ:

1. 作成予定のファイルパス（docs/adr/NNNN-title.md）
2. ADR ドラフト全文
3. 不明・要確認の項目（ある場合のみ）

5. 承認後に反映

ユーザーが明示承認したら:

1. docs/adr/NNNN-title.md を作成（または既存ファイルを更新）する
2. docs/adr/README.md が存在する場合は ADR 一覧に新規エントリを追記する

---

終了条件

以下のいずれかを達成したときのみスキルを終了できる。 達成前にスキルを終了することは禁止する。

| 条件 | 完了の定義 | | --- | --- | | 新規 ADR 作成完了 | docs/adr/NNNN-title.md が作成され、ユーザーに承認された | | 既存 ADR 更新完了 | ステータスまたは内容の変更がファイルに反映され、ユーザーに承認された | | ADR 不要と確定 | ユーザーが明示的に「不要」と判断し、その理由をチャットに記録した |

---

作業完了時の更新（必須）

スキル終了前に以下を必ず実施する:

1. docs/adr/README.md が存在する場合は ADR 索引を更新する
2. 以下の完了サマリーを出力する:

## ADR 作業完了

### 作成・更新したファイル
- `docs/adr/NNNN-title.md` — <ステータス>: <1行サマリー>
- `docs/adr/README.md` — 索引を更新（該当する場合）

### 決定内容サマリー
- **タイトル**: <ADR タイトル>
- **ステータス**: Accepted / Proposed / Deprecated
- **決定**: <決定内容の1行要約>
- **主なトレードオフ**: <肯定的影響> / <否定的影響>

### 次のアクション（推奨）
- `git add docs/adr/ && git commit -m "docs(adr): add ADR-NNNN <title>"` でコミット

---

制約

• ユーザーの明示承認前にファイルを書き込まない
• 未決定の情報を推測で埋めない
• docs/adr/ 以外にファイルを作成しない
• 既存 ADR のステータス変更時は変更理由を必ず記載する

参照ファイル

• テンプレート: ${CLAUDE_SKILL_DIR}/references/adr-template.md