ADR/意思決定ログをコミットタイミングで作成・更新するための運用スキル。既存ADR/DECISIONSの形式に合わせ、会話履歴と差分から決定内容を要約して記録する。
references/ 内テンプレート を参照する| 変数 | 必須 | 取得方法 | 例 |
|---|---|---|---|
{ADR_DIR} | 必須 | プロジェクト構成から特定 | docs/08_adr |
{DECISIONS_PATH} | 必須 | {ADR_DIR}/DECISIONS.md | docs/08_adr/DECISIONS.md |
{ADR_PREFIX} | 必須 | 既存ADRファイル名から推定 |
ADR |
{DATE} | 自動 | 実行日(YYYY-MM-DD) | 2026-02-08 |
{DATE_NOSEP} | 自動 | 実行日(YYYYMMDD) | 20260208 |
{NEXT_ID} | 自動 | DECISIONS.md の最終連番 +1 | 005 |
{TITLE} | 必須 | ユーザー指定またはコミット内容から要約 | API認証方式の選定 |
Bash: git diff --cached)と、直前のやり取りを整理する{ADR_DIR} 内の最新ADRを確認し(Glob + Read)、構成・見出し・語調を合わせる{DECISIONS_PATH} を確認し(Read)、次の連番 {NEXT_ID} を決めるWrite): {ADR_DIR}/{ADR_PREFIX}-{DATE_NOSEP}-{NEXT_ID}.mdDECISIONS.md の ADR 一覧に1行追記(Edit)Read + Edit)Bash: git add && git commit)以下の変数でADRとDECISIONS.mdを作成してください。
手順は「実行フロー」、制約は「基本ルール」に従うこと。
- ADRディレクトリ: {ADR_DIR}
- DECISIONS.md: {DECISIONS_PATH}
- ファイル名: {ADR_PREFIX}-{DATE_NOSEP}-{NEXT_ID}.md
- 決定日: {DATE}
- タイトル: {TITLE}
references/ADR.md と references/DECISIONS.md をテンプレートとして使用する| {ADR_PREFIX}-{DATE_NOSEP}-{NEXT_ID} | {TITLE} | 採用 | {DATE} | 例)追従性/再現性/運用負荷 | 例)Docs/API/Automation |
docs: ADR {ADR_PREFIX}-{DATE_NOSEP}-{NEXT_ID} を追加docs: 意思決定ログに {TITLE} を追加feat: 実装差分の内容についての説明{ADR_DIR}/{ADR_PREFIX}-{DATE_NOSEP}-{NEXT_ID}.md として存在する{DECISIONS_PATH} に正しい連番で1行追記されている