探索 → 計画 → 実装 → コミット

導入

いきなり「実装して」と頼むと、Claude Code は間違った問題を解いてしまうことがあります。おすすめは、作業を4つのフェーズに分けることです。急がば回れで、結果的に速く・正確になります。

説明

推奨される基本フローは次の4段階です。

flowchart LR
    E["① 探索<br/>関連ファイルを読む"] --> P["② 計画<br/>手順を立てる"]
    P --> I["③ 実装<br/>コードを書く"]
    I --> C["④ コミット<br/>PRを作る"]

1. 探索（Explore）：まず変更しないでコードを読ませ、現状を理解させます。「src/auth を読んで、ログインとセッションの扱いを説明して」
2. 計画（Plan）：どのファイルをどう変えるか、手順を先に立てさせます。「Google ログインを足したい。変更が必要なファイルと流れを計画して」
3. 実装（Implement）：計画に沿ってコードを書かせます。「その計画どおりに実装して。テストも書いて実行して」
4. コミット（Commit）：仕上げにコミットとPR作成まで頼みます。「わかりやすいメッセージでコミットして、PRを作って」

探索と計画を実装から切り離すのがポイントです。人がまず設計を確認できるので、大きく手戻りするリスクが減ります。

読んでみよう

小さな修正（タイポ直しやログ1行の追加）なら、この4段階は不要でそのまま頼んで構いません。複数ファイルにまたがるとき、やり方に迷うとき、不慣れなコードを触るときほど、探索と計画をはさむ効果が大きくなります。