編集前に計画・レビュー・承認する

適切な問題で Plan Mode に入る

不明瞭な要件、architecture change、migration、blast radius の広い作業に planning を使います。一本道の typo fix や read-only investigation には通常不要です。

/plan で入り、同じ command に task description を付けるか、Shift+Tab で mode を切り替えます。設計を決める前に unknowns の特定と repository 調査を求めます。

/plan
/plan Migrate authentication to rotating JWTs without changing the public API.

Plan を artifact としてレビューする

auto や always-approve でも preview は省略されません。選択行または範囲へ comment し、変更を求め、順序と proof が妥当なときだけ承認します。

/view-plan で保存済み preview を再表示します。必要に応じて affected files、data migration、compatibility risk、tests、observability、rollback を明示させます。

• a：承認して build を開始。
• s：変更を依頼。
• c：選択行または範囲へ comment。
• q：実行せず Plan Mode を終了。

/view-plan

Gate が止めないものを理解する

承認前は edit tools が session plan file 以外を編集できません。一方、reads、bash、MCP は active permission mode に従い、shell redirection はファイルを書けます。Plan Mode は security sandbox ではありません。

親の Plan Mode は subagent を edit-gate しませんが、child は permission mode を継承します。機密 repository では narrow permissions、sandbox、mutation 禁止の明示指示を組み合わせます。

• planning の前後に git status を確認する。
• edit gate を理由に広い shell access を与えない。
• 承認後に diff を再確認する。