ds-plan-loop

ds-plan-loop

コーディングの前に計画を立て、計画を一度見直してから、タスクを検証済みのステップごとに進めます。

手順

1. 目標を1文で言い換えます。変更する予定のファイルとコマンドを列挙します。計画を立てる前に、それらのファイルを読みます。記憶に頼って計画を立てないでください。
2. 番号付きの計画を書きます。各ステップには、1つの作業と、コマンドまたは直接の観察で確認できる1つの受け入れチェックを設定します。たとえば、「npm test -- auth が成功する」や「GET /health が200を返す」などです。各ステップは、1つの差分で検証できる程度に小さくしてください。
3. 計画をファイルに書き込みます（PLAN.md、または ds-context-reset で作成した PROGRESS.md）。後続の手順や新しいセッションでも参照できるようにします。
4. 新たな視点で計画を批評します。目標と計画だけを読み返し、作成者ではないレビュー担当者の立場で確認します。可能であれば、サブエージェントまたは新しいセッションで批評を実行します。次の3つの質問に答えてください。
   • どのステップ（セットアップ、移行、設定、テスト、クリーンアップ）が抜けていますか？
   • コードやドキュメントで確認できていない前提は何ですか？
   • 同じ目標を、より少ないステップで達成する簡単な方法はありますか？
5. 計画を修正します。リスクのある前提は、コードを読んだりコマンドを実行したりして、この時点で確認します。推測のまま先に進めないでください。
6. ステップ1だけを実行します。受け入れチェックを実行し、実際の出力を確認します。チェックに失敗した場合は、ds-verify-loop を使います。
7. プランファイルでステップを完了とし、根拠（コマンドと結果）を記録します。その後、次のステップに進みます。
8. 計画が誤っていると分かった場合は、作業を止め、続行する前に残りのステップを修正します。その場しのぎで進めないでください。

次の場合に停止します

• すべてのステップが完了と記され、チェックにも合格し、最初の目標がエンドツーエンドの確認でも達成されている。
• 批評を2ラウンド実施した。3ラウンド目で新しい点が見つかることはほとんどないため、実行に移します。
• あるステップのチェックに2回連続で失敗した。ds-unstick に切り替えます。

ルール

• チェックのないステップを作らないでください。「問題なさそう」はチェックではありません。
• 差分ごとに1つのステップを実行します。時間を節約するために複数のステップをまとめないでください。
• 目標の達成に不要なステップを追加しないでください。
• 計画は短く保ちます。目安は3～10ステップです。大きな作業は複数の計画に分けてください。