plan-first

計画優先のワークフロー

ルール

• TODO.md の承認を得る前に、コードを書いたり、ファイルを作成したり、コマンドを実行したりしてはいけません。
• 不明な情報を推測してはいけません。質問してください。
• 手順を省略してはいけません。フェーズの順序に従ってください。
• 計画から逸脱してはいけません。新たな作業が見つかった場合は、TODO.md に追加し、着手する前に承認を求めてください。

---

フェーズ 1 — プロジェクトを分析する

質問する前に、プロジェクトを黙って確認してください。次の項目を確認します。

1. ディレクトリ構成（トップレベルから 2 階層）
2. package.json、pubspec.yaml、go.mod、requirements.txt、Cargo.toml、pom.xml、または同等のファイル
3. 既存の依存関係とそのバージョン
4. ビルドシステムとスクリプト（Makefile、scripts/、CI 設定）
5. README.md または README.*
6. 既存の TODO.md、TASKS.md、.todo、または未解決の issue ファイル

質問に直接関係しない限り、分析結果を出力しないでください。

---

フェーズ 2 — 確認事項を質問する（1 回のみ）

分析後、正しく実装するうえで妨げとなる情報の不足を特定してください。

• 1 回のメッセージで最大 5 つの質問をしてください。
• 重要で、コードベースから推測できないことだけを質問してください。
• 質問には番号を付けてください。
• プロジェクトファイルからすでに確認できることは質問しないでください。
• 質問を複数回に分けないでください。質問できるのはこの 1 回だけです。

形式の例：

Before I create the plan, I need a few things clarified:

1. Should the new endpoint require authentication?
2. Is there a preferred database (the project has both SQLite and Postgres configs)?
3. Should existing tests be updated, or only new ones added?

ユーザーの回答を待ってから次に進んでください。

---

フェーズ 3 — TODO.md を作成する

分析結果とユーザーの回答をもとに、プロジェクトのルートに TODO.md ファイルを作成してください。

TODO.md の構成

# TODO

## Goal

One sentence describing what will be built or fixed.

## Tasks

### 1. <Phase Name>

- [ ] <Concrete, measurable action>
- [ ] <Concrete, measurable action>

### 2. <Phase Name>

- [ ] <Concrete, measurable action>
- [ ] <Concrete, measurable action>

## Notes

Any constraints, decisions, or known risks recorded here.

要件

• タスクは小さく、個別に検証できるものにしてください（1 つの論理的変更につき 1 タスク）。
• タスクは依存関係の順に並べてください（前提となるタスクを先にします）。
• 各タスクが完了か未完了かを確認できるようにしてください。
• 「修正する」「コードを改善する」のような曖昧な項目は避けてください。

ファイルを作成した後、内容全体をユーザーに提示し、次のように承認を求めてください。

I've created TODO.md. Does this plan look correct?
Reply YES to start, or tell me what to change.

---

フェーズ 4 — 修正ループ（必要な場合）

ユーザーから変更を求められた場合：

1. 意見の相違を解消するため、的を絞った追加質問をしてください。
2. TODO.md を書き直してください。
3. 更新した計画を提示し、再度承認を求めてください。

ユーザーが承認するまで繰り返してください。

---

フェーズ 5 — 計画を実行する

承認されたら：

1. タスクを順番に、1 つずつ進めてください。
2. タスクが完了するたびに、TODO.md で完了としてマークしてください。
   • - [ ] を - [x] に変更します。
3. 作業を始める前に、着手するタスクを伝えてください。
4. 現在のタスクが完了するまで、次のタスクに着手してはいけません。
5. TODO.md に記載されていない作業を行ってはいけません。

記載されていないタスクが必要だと判明した場合：

• 作業を中断してください。
• TODO.md の ## Discovered Tasks セクションに、そのタスクを追加してください。
• 判明した内容と、それが必要な理由をユーザーに伝えてください。
• 続行する前に承認を求めてください。

すべてのタスクが [x] になったら、次のように記述してください。

All tasks in TODO.md are complete.