القائمة
MADR v4 形式で Decision Record (DR) を自動採番付きで作成する。対象はアーキテクチャに限らず、覆しにくく文脈なしでは意外に見える決定すべて。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
issue が build に投入できる形かを検分し、verdict (build-ready / needs-plan / needs-fix) と指摘を返す。起票には使わない (/issue)。PR のスクリーニングには使わない (/preview)。
Inspect whether an issue is in shape to hand to build, returning a verdict (build-ready / needs-plan / needs-fix) and the findings. Do NOT use to file an issue (use /issue) or to screen a PR (use /preview).
critic-design による敵対的批判を伴う設計探索。生き残った案を構造化 plan にまとめ、自己点検して呼び出し元に返す。plan の永続先は issue の Plan 節が唯一。計画意図のないコードベース調査には使わない (代わりに /research)。
Design exploration with adversarial critique by critic-design. Assembles the surviving approach into a structured plan, self-checks it, and returns it to the caller. The issue's Plan section is the plan's only persistent home. Do NOT use for codebase investigation without planning intent (use /research instead).
構造化されたタイトルと本文で GitHub Issue を生成する。単独で成立し、前段を要求しない。challenge / research の成果物が会話にあれば本文の根拠に使い、/think の plan 下書きがあれば `## Plan` 節へ移設する。issue 番号を渡すと、起票済みで Plan 節を持たない issue へ plan を転記する。
Generate GitHub Issue with structured title and body. Standalone; requires no upstream stage. When challenge / research artifacts exist in the conversation, they feed the body's evidence; when a /think plan draft exists, it is transferred into the `## Plan` section. Given an issue number, it transfers a plan into a filed issue that has no Plan section.
| name | dr |
| description | MADR v4 形式で Decision Record (DR) を自動採番付きで作成する。対象はアーキテクチャに限らず、覆しにくく文脈なしでは意外に見える決定すべて。 |
| when_to_use | DR作成, ADR作成, 技術決定, アーキテクチャ決定, decision record |
| allowed-tools | Read Write Edit LS Bash(mkdir:*) Bash($HOME/.claude/skills/dr/scripts/*) AskUserQuestion Bash(ugrep:*) Bash(bfs:*) |
| model | opus |
| argument-hint | [decision title] |
決定タイトルは $ARGUMENTS で受け取り、"Adopt X for Y" のような具体的なアクションに整える。空なら AskUserQuestion で New decision/Update existing を確認し、Update existing なら <git-root>/docs/decisions/ の既存 DR から選択させる。保存先の変更は DR_DIR 環境変数を設定して実行する。
3 条件すべてが成り立つときだけ 5 フェーズプロセスに進む。欠ける場合は DR を作らず、条件 1 か 2 が欠けるなら CONTEXT.md エントリか相当する設計ノートに、条件 3 のみ欠けるならコミットメッセージ本文に決定を記録する。
| ルール | 詳細 |
|---|---|
| Immutability | 受理後の決定内容は不変。Supersede 手順を参照 |
| Brevity | 決定タイプ別のサイズ制限。決定タイプを参照 |
| Frontmatter | YAML frontmatter は任意。YAML Frontmatter を参照 |
| Confirmation | Decision Outcome 配下の ### Confirmation で遵守の確認方法を記述 |
| フィールド | 必須 | 備考 |
|---|---|---|
| status | No | proposed, rejected, accepted, deprecated, superseded by DR-NNNN のいずれか。YAML quote 必須、識別子のみリンク不可 |
| date | No | 作成日 YYYY-MM-DD。supersede 時のみ更新 |
| decision-makers | No | 名前または役割のリスト。v4 で deciders から改名 |
| consulted | No | 相談した専門家。やり取りは双方向 |
| informed | No | 結果を共有する利害関係者。一方向 |
新しい DR が既存を置き換える場合。旧 DR で変わるのは status と date のみで、決定内容はそのまま保持する。
Supersedes DR-NNNN)status: を superseded by DR-NNNN に変更date: を当日に更新${CLAUDE_SKILL_DIR}/scripts/update-index.py を実行してインデックスを更新決定タイプの違いが影響するのは、More Information に置く推奨トピックの選択のみ。各セクションの分量目安は全タイプ共通で、Context は 3 行、Options は各 3〜5 行、Consequences は箇条書き 2〜3 項目とする。
| 決定タイプ | ユースケース | 行数上限 | 推奨トピック |
|---|---|---|---|
| technology-selection | ライブラリ、フレームワーク選定 | 80 行 | Migration Strategy, Rollback Plan, Success Criteria |
| architecture-pattern | 構造、設計方針 | 80 行 | Architecture Diagram, Quality Attributes, Trade-offs |
| process-change | ワークフロー、ルール変更 | 100 行 | Before / After 比較, Transition Plan, Review Schedule |
| deprecation | 技術の廃止 | 100 行 | Deprecation Target, Migration Plan, Deprecation Warning Period, Rollback Plan |
| Step | Phase | 内容 |
|---|---|---|
| 1 | Pre-Check | ${CLAUDE_SKILL_DIR}/scripts/pre-check.py "$TITLE" を実行。similar_drs が空でなければ続行前にユーザーへ重複を確認する。DR は返り値の dr_dir 配下に filename の名前で書き、number と date を本文と frontmatter に写す |
| 2 | Type | 決定の意図で決定タイプを判定し、決定タイプ表から推奨トピックを選ぶ |
| 3 | References | プロジェクトドキュメント、issue、外部リソースを収集 |
| 4 | Validate | 書き込み後 ${CLAUDE_SKILL_DIR}/scripts/validate-dr.py "$DR_FILE" を実行。exit 0 + 空の errors[] で合格。warnings[] は参考 |
| 5 | Index | ${CLAUDE_SKILL_DIR}/scripts/update-index.py を実行し、index README を再生成 |
各 script が失敗を JSON かエラー出力で返す。対応は下表。
| エラー | 動作 |
|---|---|
| git リポジトリの外だと報告 | DR_DIR を設定して保存先を明示する |
| 保存先に SKILL.md があると報告 | skill ディレクトリを指しているので DR_DIR を DR 置き場へ向け直す |
similar_drs が非空 | 重複候補を提示し、新規作成を続けるか既存 DR の更新に切り替えるかを確認 |
validate-dr.py が missing_section を返す | テンプレートから欠けた見出しを補い、再検証する |
| パス | 説明 |
|---|---|
<git-root>/docs/decisions/XXXX-slug.md | DR ファイル |
<git-root>/docs/decisions/README.md | 自動生成インデックス |
| トピック | リソース |
|---|---|
| MADR | ${CLAUDE_SKILL_DIR}/references/madr-format.md |
| Fowler | ${CLAUDE_SKILL_DIR}/references/fowler-adr.md |
| Template | ${CLAUDE_SKILL_DIR}/templates/madr-template.md |
| Scripts | ${CLAUDE_SKILL_DIR}/scripts/ |