deep-plan

Deep Plan

思考と入力を分離し、無駄な作業を防ぐ規律あるワークフローです。ユーザーが書面の計画を確認して承認するまで、コードは決して書きません。

ワークフロー

Research → Plan → [Interview] → Annotate (1-6x) → Todo List → Implement → Feedback → Archive

[Interview] は任意です。注釈を付ける前に曖昧な点を解消するための対話形式の Q&A です。開始条件と手順については、Phase 2 のリファレンスを参照してください。

重要なガード：ユーザーが明示的に指示しない限り、次のフェーズに進まないでください。迷った場合は、確認してください。

フェーズ

各フェーズの詳細な手順は、対応するリファレンスファイルに記載されています。そのフェーズに入る際に、該当するファイルを読んでください。

フェーズ	ファイル	成果物	ガード
1. 調査	references/phase-1-research.md	.claude/research.md	ユーザーのレビューを待つ
2. 計画	references/phase-2-plan.md	.claude/plan.md	まだ実装しない
3. 注釈	references/phase-3-annotate.md	ユーザーによる plan.md の編集	まだ実装しない
4. Todo リスト	references/phase-4-todo.md	plan.md 内のチェックボックス	ユーザーの承認を待つ
5. 実装	references/phase-5-implement.md	タスクに [x] を付ける	継続的に型チェックを実行
6. フィードバック	references/phase-6-feedback.md	簡潔な修正	方針が間違っていたら元に戻す
7. アーカイブ	references/phase-7-archive.md	docs/completed-tasks/	—

テンプレート

成果物を作成する際は、次のテンプレートを使用してください。

• 調査：assets/templates/research-template.md
• 計画：assets/templates/plan-template.md

スクリプト

スクリプト	目的	使用タイミング
scripts/check_annotations.py <file>	未対応のユーザー注釈を見つける	Phase 3 で計画を更新する前
scripts/plan_progress.py <file>	タスクの完了状況（X/Y）を報告する	Phase 5 の実装中
scripts/archive_plan.py <file> --name <slug>	計画を docs/completed-tasks/ に移動する	Phase 7 のアーカイブ時

リファレンスファイル

ファイル	目的
references/annotation-guide.md	効果的な注釈の書き方
references/phase-*.md	各フェーズの詳細な手順

厳守事項

これらは交渉の余地がありません。いずれかに違反すると、ワークフローの失敗となります。

制約	適用対象
承認済みの計画なしにコードを書かないでください。 例外はありません。	すべてのフェーズ
「まだ実装しない」は絶対です。 計画が完成しているように見えても、調査、計画、注釈の各フェーズではコーディングを開始しないでください。	Phases 1-4
調査結果はすべて永続ファイルに記録してください。 調査結果をチャット内で要約するだけでは不十分です。.claude/research.md に記録してください。	Phase 1
変更を提案する前にソースファイルを読んでください。 計画内のコードスニペットはすべて、実際に読んだ既存のファイルを参照する必要があります。何も読まずに設計してはいけません。	Phase 2
すべての注釈に対応してください。 ユーザーのメモを省略したり、優先度を下げたり、黙って無視したりしないでください。	Phase 3
any 型や unknown 型を使用しないでください。 厳密な型付けを維持してください。	Phase 5
不要なコメントや jsdoc を追加しないでください。 コードは自己説明的であるべきです。	Phase 5
型チェックを継続的に実行してください。 実装後ではなく、実装中に問題を見つけてください。	Phase 5
すべてのタスクが完了するまで中断しないでください。 行き詰まっていない限り、確認を求めるために実装の途中で一時停止しないでください。	Phase 5
作業を進めながら、計画内でタスクを完了済みにしてください。 進捗を管理する唯一の情報源は計画書です。	Phase 5
作業範囲は計画に記載された内容です。 ユーザーが削除した項目は削除したままにしてください。こっそり復活させたり、依頼されていない機能を追加したりしないでください。	すべてのフェーズ

主要な原則

• 計画は共有される可変状態です。 あなたとユーザーの両方が編集します。圧縮後も保持されます。
• 1つの長いセッションで進めます。 調査から実装までを1つの会話で行います。
• 実装は退屈なくらいでよいものです。 創造的な判断は注釈のサイクルで行います。
• 読んでいないコードについて推測しないでください。 計画にファイルが記載されている場合は、まずそのファイルを読んでください。
• スコープを厳守します。 ユーザーが計画から項目を削除したら、その項目は削除されたままです。こっそり追加し直さないでください。

謝辞

このワークフローは、Boris Tane による How I Use Claude Code に基づいています。