plan

/plan

現在のタスクの計画ファイルを作成します。事前に /orient を実行している必要があります。

手順

1. 前提条件を確認します。 worktree が存在し、/orient でタスクが特定されていることを確認します。そうでない場合は停止し、ユーザーに伝えます。
2. ブレインストーミング（1 ラウンド）を行います。 タスクの説明を添えて /brainstorming を呼び出します。1 ラウンドのみとし、方向性をまとめ、反復は行いません。
3. テンプレートを読みます。 リポジトリのルートにある ai-workspace/plans/TEMPLATE.md を読みます。
4. 計画を作成します。 すべてのテンプレート項目を含めて ai-workspace/plans/<branch-slug>.md を作成します。

項目	記入方法
Branch	現在のブランチ名
Target	マージ先のブランチ。既定値は、以下の reflog の親から検出したブランチです。検出できない場合は main を使用します。意図的にマージ先を変更する場合のみ上書きします。/ship はこの項目を読み取ります。
Created	今日の日付（YYYY-MM-DD）
Status	In Progress
Threat model	以下の選択表を参照してください
Scope ceiling	テンプレートの既定値（ソフト上限 400/6、ハード上限 800/10）を維持します
Task	何を、なぜ行うのかを 1～3 文で記述します
Steps	具体的な実装手順をチェックボックス形式で記載します
Confidence Scaffold	adversarial の場合は必須です。複雑な advisory の場合は推奨です。
Outcomes & Learnings	空欄のままにします。/archive で記入されます。

5. 計画をコミットします。 /review に引き継ぐ前に、計画ファイルをステージングしてコミットします。

   git -C "$WORKTREE" add ai-workspace/plans/<name>.md
   git -C "$WORKTREE" commit -m "plan: <name>"
   

   /review はコミット済みの状態を対象にするため、これが必須です。計画を作成した後、/review の実行前にセッションがクラッシュしたり /clear が実行されたりすると、ブレインストーミングの内容が失われます。この手順を省略した場合の復旧方法については、ADR-008（refs/wip/checkpoints/<branch> Stop-hook のバックストップ）を参照してください。

Target の検出

Target の既定値は、このブランチの派生元のブランチです。reflog から読み取ります。

TARGET=$(
  git reflog show HEAD --pretty=format:'%gs' \
    | grep "^branch: Created from" \
    | head -1 \
    | sed 's/branch: Created from //' \
    | sed 's|^origin/||'
)
TARGET=${TARGET:-main}

reflog が空の場合（Web セッションや detached-HEAD の状態での作成）は、main にフォールバックします。ユーザーが Target を明示していない場合は、常にこれを使用します。Git のみを使用するため、ツールのインストールなしでどの環境でも動作します。

脅威モデルの選択

シグナル	モデル
内部ツール、リファクタリング、ドキュメント、テスト、設定	advisory
認証、シークレット、入力検証、CI、フック、権限	adversarial
判断に迷う場合	adversarial

ガードレール

• 計画をレビューしてはいけません。それは /review の作業です（手順 4）。
• 実装を開始してはいけません。成果物は計画です。
• テンプレートの項目を省略してはいけません。
• 計画ファイルを先にコミットせずに /review に進んではいけません。
• ブレインストーミングでタスクの範囲が 1 文で済むと判明した場合は、その旨を伝えてスキップします。
• スコープ上限の値は固定です。変更してはいけません。
• 手順は曖昧なフェーズではなく、チェックボックス付きの具体的なアクションにします。
• テスト手順を明記します。テストを別の担当者が作成する必要がある場合（TDD 契約）は、テスト作成と実装を別々のタスクとして記載し、/build がテスト作成者と実装担当者を個別に割り当てられるようにします。

出力

作成後、以下を報告します。

Plan written: ai-workspace/plans/<name>.md
Threat model: advisory|adversarial
Steps: <count>
Next step: /review