Dr

---
name: dr
description: MADR v4 形式で Decision Record (DR) を自動採番付きで作成する。対象はアーキテクチャに限らず、覆しにくく文脈なしでは意外に見える決定すべて。
when_to_use: DR作成, ADR作成, 技術決定, アーキテクチャ決定, decision record
allowed-tools: Read Write Edit LS Bash(mkdir:*) Bash(${CLAUDE_SKILL_DIR}/scripts/*) AskUserQuestion Bash(ugrep:*) Bash(bfs:*)
model: opus
argument-hint: "[decision title]"
---

# /dr - Decision Record 作成

## 入力

決定タイトルは `$ARGUMENTS` で受け取る。空なら AskUserQuestion で New decision/Update existing を確認する。New decision ならタイトルを聞き、Update existing なら `<git-root>/docs/decisions/` の既存 DR から選択させる (§ 既存 DR の更新)。新規に作るタイトルは "Adopt X for Y" のような具体的なアクションに整え、5〜64 文字に収めて `/:*?"<>|` を含めない。保存先は既定で `<git-root>/docs/decisions/` で、`DR_DIR` 環境変数を設定すると変えられる。

`${CLAUDE_SKILL_DIR}/../../rules/conventions/DOCUMENTS.md` に従い、関連 wiki・DR と原本の適用条件・状態を現在の要求へ照合する。必要な文書更新を今回の合意範囲へ含め、実装と同じ評価へ渡す。

## 採用ゲート

下表の 3 条件すべてが成り立つときだけプロセスへ進む。欠けるときは DR を作らず、上から順に当てて最初に該当した記録先へ決定を残す。

| 条件                                                                            | 欠けたときの記録先                                       |
| ------------------------------------------------------------------------------- | -------------------------------------------------------- |
| 覆しにくい。後から決定を変えるには相応のコストがかかる                          | プロジェクトの設計ノート。無ければコミットメッセージ本文 |
| 文脈がないと意外に見える。将来の読み手が「なぜこの形にしたのか」と疑問を持つ    | プロジェクトの設計ノート。無ければコミットメッセージ本文 |
| 実在するトレードオフの結果。本物の代替案が存在し、特定の理由で 1 つを選んでいる | コミットメッセージ本文                                   |

## プロセス

| Step | 工程      | 内容                                                                                                                                                                 |
| ---- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1    | Pre-Check | ${CLAUDE_SKILL_DIR}/scripts/pre-check.ts "$TITLE" を実行する。返り値から使うのは `dr_dir` と `filename` (書き込み先)、`date` (frontmatter)、`similar_drs` (重複判定) |
| 2    | Type      | 決定の意図で決定タイプを判定し、推奨トピックを選ぶ (§ 決定タイプ)                                                                                                    |
| 3    | Sources   | プロジェクトドキュメント、issue、外部リソースを収集する                                                                                                              |
| 4    | Draft     | ${CLAUDE_SKILL_DIR}/templates/madr-template.md を `dr_dir` 配下に `filename` で写し、収集した内容で埋める (§ YAML Frontmatter)                                       |
| 5    | Challenge | 既存 DR の原則に例外を作る、または既存 DR を supersede する場合だけ `/challenge` を通し、verdict と成立条件を More Information に 1 行で残す                         |
| 6    | Validate  | ${CLAUDE_SKILL_DIR}/scripts/validate-dr.ts "$DR_FILE" を実行する。exit 0 なら合格。落ちた項目は `errors[]` に入り、`warnings[]` は参考                               |
| 7    | Index     | ${CLAUDE_SKILL_DIR}/scripts/update-index.ts を実行し、`dr_dir/README.md` を再生成する                                                                                |

## 決定タイプ

決定タイプの違いが影響するのは、More Information に置く推奨トピックの選択のみ。分量は全タイプ共通で、Context は 3 行、Options は各 3〜5 行、Consequences は箇条書き 2〜3 項目とする。Reassessment Triggers はタイプを問わず More Information に置く。新規 DR は必ず More Information を持つので h3 になる。既存構造の削除や統合を提案する側がこの節を読んで判定するので、欠けると判定材料が無い。

| 決定タイプ           | ユースケース                   | 推奨トピック                                                                  |
| -------------------- | ------------------------------ | ----------------------------------------------------------------------------- |
| technology-selection | ライブラリ、フレームワーク選定 | Migration Strategy, Rollback Plan, Success Criteria                           |
| architecture-pattern | 構造、設計方針                 | Architecture Diagram, Quality Attributes, Trade-offs                          |
| process-change       | ワークフロー、ルール変更       | Before / After 比較, Transition Plan, Review Schedule                         |
| deprecation          | 技術の廃止                     | Deprecation Target, Migration Plan, Deprecation Warning Period, Rollback Plan |

## YAML Frontmatter

frontmatter は任意。書くなら下表のフィールドを使う。

| フィールド      | 備考                                                                                                                  |
| --------------- | --------------------------------------------------------------------------------------------------------------------- |
| status          | ${CLAUDE_SKILL_DIR}/references/madr-format.md の Status ライフサイクルから選ぶ。YAML quote 必須、識別子のみリンク不可 |
| date            | 作成日 YYYY-MM-DD。supersede 時のみ更新                                                                               |
| decision-makers | 名前または役割のリスト。v4 で `deciders` から改名                                                                     |
| consulted       | 相談した専門家。やり取りは双方向                                                                                      |
| informed        | 結果を共有する利害関係者。一方向                                                                                      |

## 既存 DR の更新

status が proposed なら本文を直接編集し、Validate と Index を実行する。accepted 以降は次の手順で新しい DR へ置き換える。旧 DR で変えるのは `status` と `date` だけで、決定内容は保持する。

1. プロセスで新規 DR を作成する。置き換える決定は既に記録済みなので、採用ゲートは通さない
2. 新規 DR の More Information で先行 DR を引用する (例: `Supersedes DR-NNNN`)
3. 旧 DR の `status:` を `superseded by DR-NNNN` に変更する
4. 旧 DR の `date:` を当日に更新する
5. ${CLAUDE_SKILL_DIR}/scripts/update-index.ts を実行してインデックスを更新する

## エラー処理

各 script が失敗を JSON かエラー出力で返す。対応は下表。

| エラー                         | 扱い                                                                    |
| ------------------------------ | ----------------------------------------------------------------------- |
| git リポジトリの外だと報告     | `DR_DIR` を設定して保存先を明示する                                     |
| 保存先に SKILL.md があると報告 | skill ディレクトリを指しているので `DR_DIR` を DR 置き場へ向け直す      |
| `similar_drs` が非空           | 重複候補を提示し、続行するか更新へ切り替えるかを確認 (§ 既存 DR の更新) |
| `errors[]` が非空              | 返った項目を直し、Validate をやり直す                                   |

## 参照

| 迷うこと                       | リソース                                      |
| ------------------------------ | --------------------------------------------- |
| 任意セクションを残すか落とすか | ${CLAUDE_SKILL_DIR}/references/madr-format.md |
| 決定を説明し切る要素は何か     | ${CLAUDE_SKILL_DIR}/references/fowler-adr.md  |

## 根拠と現在形

Context に対象 repo・目的・適用条件を書き、More Information に原本の相対パス・必要な版と合意の出典を残す。採用を確認できない判断は proposed/未確認のままにする。DR を置換するときは由来がその DR を指す wiki の本文も同じ変更単位で照合・更新する。リンクの張り替えだけでは完了にしない。