| name | check-plan |
| description | Plan ファイルを Issue 化前に監査し、必須セクションの充足と影響範囲の網羅をチェックする。「check-plan」「plan をチェック」と指示されたとき。 |
Check Plan
Plan ファイルを Issue 化(/to-issues)の前 に監査する。後工程で発覚すると手戻りが大きい「必須セクションの欠落」「影響範囲の見落とし」を、最も安いこの段階で潰す(シフトレフト)。通常は /to-plan から自動で呼ばれるが、単体でも実行できる。
対象 Plan の特定
- 引数でパス・slug が渡されたらそれを使う。
- 無ければ
~/.claude/plans/ の最新ファイル、または会話コンテキスト上の Plan。
- どれも特定できなければユーザーに確認する。
チェック観点
着手前に docs/design-hub.md・docs/policy-hub.md・docs/policy/refined-engineer-judgment-principles.md(判断の北極星)を参照する(CLAUDE.md 「必読ドキュメント」)。加えて、Plan が触れる領域に該当 ADR(docs/adr/)があれば読む。
必須セクションの充足
| 項目 | 合格条件 |
|---|
| 設計書・要件定義への影響 | セクションが存在し埋まっている。設計書に加え docs/requirements.md(要件定義)の更新要否も判断されている。更新不要なら「更新不要・理由:〇〇」が明記されている(空欄・省略は不合格) |
| 更新タスク | 影響が「更新不要」でない限り、タスク一覧に設計書・requirements.md の更新タスクが含まれる |
| 背景・目的(WHY) | 実装者が優先順位を自力判断できる粒度で書かれている(HOW の羅列は不合格) |
| grill-me 確定仕様 | 確定仕様・設計判断の根拠・却下した代替案が転記されている。未実施なら「grill-me 未実施」と明記 |
影響範囲の網羅(コードベース)
Plan が挙げる変更箇所と、実際のコードベースを照合する。コードを探索し、Plan に書かれていない波及先(呼び出し元・共有モジュール・テスト・型定義など)が無いかを確認する。漏れがあれば具体名を挙げて指摘する。
影響範囲の網羅(ドキュメント)
docs/design-hub.md を起点に、変更が影響する設計書を洗い出す。Plan の「設計書への影響」と突き合わせ、ハブから辿れるのに記載漏れしている設計書が無いかを確認する。ADR が必要な意思決定(/create-adr 対象)が含まれていないかも見る。
ポリシー整合・判断原則との照合
docs/policy/ の指針・該当 ADR に反する方針が Plan に含まれていないか確認する。あわせて、 を Plan に当てる。各原則のに状況を引き当てたうえで、特に Plan 段階で効く次の観点を確認し、反していれば指摘する: