// 計画ファイル作成～実装プロセスを強化するスキル。 Claude Codeがplan modeに入った時、または複雑な指示・多段階の作業が示された時に最初に必ず呼び出すこと。 単純な単一ファイルの修正指示や会話だけの質問には不要。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | plan-mode |
| description | 計画ファイル作成～実装プロセスを強化するスキル。 Claude Codeがplan modeに入った時、または複雑な指示・多段階の作業が示された時に最初に必ず呼び出すこと。 単純な単一ファイルの修正指示や会話だけの質問には不要。 |
以下の手順に従い作業する。
ユーザーの指示がバグ・障害・エラー・デグレードなどの対応に該当する場合、
references/bugfix-process.mdを読み込み、手順に従い確実に対応する。
判定が即座につかない場合はバグ対応に該当するものとして扱う。
ユーザー指示が曖昧・複数の解釈が成り立つ場合は、先に要件を対話的に明確化してから計画ファイル作成に進む。
AskUserQuestionで複数の論点をバッチでまとめて提示する## 背景（経緯と目的）と### ユーザー合意済み事項（合意した方針）へ転記するユーザーから「レビューして」「検討して」「見直して」のような指示があった場合、 調査→改善案提示→ユーザー選択取得→計画ファイル反映までを本工程内で完結させる。 明示的に「調査だけ」と指示された場合のみ報告で完結させる。
工程2で曖昧さを除去した後、推測で埋めた前提・対応するか迷った範囲・スコープ境界の明示を箇条書きで提示する。 提示後は応答を待たず次工程へ進む。ユーザーから補足・修正が返ってきた場合は次のターンで取り込む。
当該計画固有でない恒久的な知見（ユーザーが発話・確認で合意した事項・選択理由・プロジェクト方針的な情報）を整理し、 永続化先と文面を確定する。永続化先への書き込みは実装工程で行い、文面案は工程6で計画ファイルへ転記する。
永続化先候補: CLAUDE.md（プロジェクト方針）、.claude/rules/（ファイル種別規約）、
.claude/skills/（特定の作業手順）、docs/配下（利用者向け情報）
本来の対応によって理想的な状態が崩れるなら、それを補うリファクタリングまで完了して初めて修正完了とみなす。 「今回の本筋から外れるためスコープ外」として必要なリファクタリングを先送りすることを禁ずる。
コード・ドキュメント変更を契機に発見した周辺対応（責務の肥大化・粒度不整合・陳腐化・テスト不足など）と、
計画作成中に発見した既存記述の不備を洗い出す。
確定した周辺対応は計画ファイルの## 変更内容に本来の変更と並べて列挙する。
ExitPlanMode後の計画は常にagent-toolkit:plan-implスキルへ引き継ぐ。
本工程ではレビュー方式として以下のいずれかを選択する。
レビュー無し: plan-implスキル内で実装・検証・コミットのみ実施レビュー有り: plan-implスキル内で実装・検証・コミット後にサブエージェントによる集約レビューを実施既定値はレビュー無し。判定は以下の表の上から順に評価し、最初にマッチした行で確定する。
| 条件 | マッチ判定 | 確定値 |
|---|---|---|
| 1 | レビュー無しまたはセルフレビュー不要の明示 | レビュー無し |
| 2 | セルフレビューまたはレビュー有りの明示 | レビュー有り |
| 3 | 軽微な修正（誤字・単一関数修正・既存パターン踏襲） | レビュー無し |
| 4 | 大規模計画と判断される | AskUserQuestionで採用可否を確認し回答に従う |
| 5 | 上記いずれにも該当しない | レビュー無し（既定値の適用） |
「しっかりレビュー」「品質重視で」等の自然言語表現は条件2の合図に含めない。
大規模判定の目安は、複数フェーズ分割を要する規模、または公開インターフェース変更を伴う複数ファイル横断の設計変更。
条件4のAskUserQuestionではレビュー方式の概念を知らないユーザーでも判断できるよう補足を必ず添える。
計画実行時にサブエージェントによるレビューを実施しますか？
（実装・検証・コミット後にサブエージェントが集約レビューを行う方式。時間・コストはかかるが高品質な作業ができる）
計画ファイルの骨子を書き始める直前に、references/plan-file-guidelines.mdを必ずReadで読み込む。
テンプレートに従い、所定パスへ計画ファイルを作成する。 工程2〜5の合意事項・解釈・恒久化文面・周辺対応をテンプレート規定の各セクションへ転記する。
作成完了後、### ユーザー合意済み事項配下の各項目について、
ユーザーが直接発話/回答したものに限定されているかを項目ごとに照合する。
調査結果・既定値・推測・エージェントの解釈で埋めた事項は### エージェント判断へ移す。
ユーザーに計画ファイルを提示する前に、references/codex-review.mdを読み込み、
そこに記述された手順に従いcodexレビューを実施する。
指摘があった場合は計画ファイルの該当セクションへ反映し、ExitPlanModeを呼び出す。
指摘のない場合はそのままユーザーに提示する。
ExitPlanModeでユーザーに計画ファイルを提示し、承認を得てから実行に進む。
ExitPlanMode前に記述漏れがないか最終確認し、
メインがagent-toolkit:plan-implスキルを呼び出して計画ファイルへ引き継ぐ。
レビュー実施有無は計画ファイルのレビュー方式項目（レビュー無し／レビュー有り）で分岐し、
plan-implスキル側で適切に処理される。