create-plan

プラン作成

目標

ユーザーのプロンプトを、最終的なアシスタントのメッセージで提示される単一の実行可能なプランに変換します。

最小限のワークフロー

ワークフロー全体を通して、読み取り専用モードで動作します。ファイルの書き込みや更新は行わないでください。

1. コンテキストを素早くスキャンする

   • README.md と、明らかに関連するドキュメント（docs/、CONTRIBUTING.md、ARCHITECTURE.md）を読みます。
   • 変更される可能性が高い関連ファイルを流し読みします。
   • 制約（言語、フレームワーク、CI/テストコマンド、デプロイ形態）を特定します。

2. ブロックされている場合にのみ追加質問する

   • 質問は最大1〜2個にしてください。
   • その回答がなければ責任を持ってプランを立てられない場合にのみ質問し、選択式を優先してください。
   • 不明点があってもブロックされていない場合は、妥当な前提を置いて進めてください。

3. 以下のテンプレートを使ってプランを作成する

   • 意図とアプローチを説明する短い段落1つから始めます。
   • スコープ内とスコープ外を、短く明確に示します。
   • 次に、アクション項目の小さなチェックリストを用意します（既定では6〜10項目）。
     • 各チェックリスト項目は具体的なアクションとし、役立つ場合はファイルやコマンドに言及します。
     • 項目はアトミックかつ順序立てる: 調査 → 変更 → テスト → ロールアウト。
     • 動詞で始める: 「追加する…」「リファクタリングする…」「検証する…」「出荷する…」。
   • 該当する場合は、テスト/検証とエッジケース/リスクのそれぞれについて、少なくとも1項目を含めます。
   • 不明点がある場合は、小さな未解決の質問セクションを含めます（最大3つ）。

4. プランの前に메타な説明を付けないこと。テンプレートに従ったプランのみを出力する

プランテンプレート（厳密に従うこと）

# Plan

<1–3 sentences: what we're doing, why, and the high-level approach.>

## Scope
- In:
- Out:

## Action items
[ ] <Step 1>
[ ] <Step 2>
[ ] <Step 3>
[ ] <Step 4>
[ ] <Step 5>
[ ] <Step 6>

## Open questions
- <Question 1>
- <Question 2>
- <Question 3>

チェックリスト項目のガイダンス

良いチェックリスト項目:

• 該当しそうなファイル/モジュールを示す: src/..., app/..., services/...
• 具体的な検証を明示する: 「npm test を実行する」「X の単体テストを追加する」
• 関連する場合は安全なロールアウトを含める: 機能フラグ、移行計画、ロールバックの注記

避けるべきこと:

• 曖昧なステップ（「バックエンドを処理する」「認証を行う」）
• 細かすぎるマイクロステップが多すぎること
• コードスニペットを書くこと（プランは実装に依存しない形で保つ）