メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

探索・計画・実装・記録のサイクル

いきなり実装から始めると、見当違いの問題を解決してしまうことがあります。探索・計画・実装・記録という4段階を毎回の習慣にする理由と、省いてよい場面の見分け方を扱います

このレッスンで

終わる頃には、次ができるようになります

  • 探索・計画・実装・記録という4段階のサイクルを、毎回の仕事に当てはめられる
  • 計画を作るべき仕事と、直接頼んでよい仕事を「一文で言えるか」で見分けられる
  • 実装中に見当違いの方向へ進み始めたとき、巻き戻すか仕切り直すかを判断できる

Claude Codeで一つの仕事を頼むとき、いきなり「これを直して」と打つか、まず調べさせてから頼むかで、返ってくる結果の質は変わります。この違いを生んでいるのは、頼み方の巧拙よりも、仕事をどう段階に分けるかという習慣です。

Planモードの入り方と権限モードの基本操作は、公式ドキュメントにまとまっています。このレッスンでは操作方法でなく、探索・計画・実装・記録という4段階を毎回の習慣にする理由と、省いてよい場面の見分け方を扱います。


探索と計画を、実装から切り離す

Claudeがコードをいきなり書き始めると、見当違いの問題を解決してしまうことがあります。公式ドキュメントは、この事故を避ける理由をこう述べています。

VoicesDOCUMENTATION

“Separate research and planning from implementation to avoid solving the wrong problem.”

筆者訳

調査と計画を実装から切り離すこと。そうしないと、間違った問題を解決してしまう。

Claude Code 公式ドキュメントBest practicescode.claude.com/docscode.claude.com/docs/en/best-practices

推奨される流れは4段階です。

01

探索(Explore)

Planモードでファイルを読ませ、質問に答えさせる。まだ何も変更しない

02

計画(Plan)

具体的な実装計画を作らせる。どのファイルをどう変えるかを言葉にする

03

実装(Implement)

計画から抜けてコードを書かせる。計画と照らしながら進める

04

記録(Commit)

説明のついたコミットメッセージを作らせ、必要ならPRにする

探索・計画・実装・記録の4段階

探索と計画をひとまとまりの段階として先に済ませ、実装に入ってから調べ直さないという順番を守ることが、このサイクルの要点です。


計画が要らない仕事もある

4段階すべてを毎回律儀に踏む必要はありません。公式ドキュメントは、計画を省いてよい基準をはっきり示しています。差分を一文で言い表せるなら、計画は飛ばしていいという基準です。

誤字を直す、ログを1行足す、変数名を変える。こうした仕事は、計画を作る手間のほうが実装そのものより大きくなります。逆に、複数のファイルにまたがる変更や、扱ったことのないコードに手を入れるときは、先に計画を作ったほうが結局速くなります。

どちらか迷ったら、「この変更を人に一文で説明できるか」を自分に問うと判断がぶれません。説明が二文、三文と伸びていくなら、それは計画を作ったほうがいい仕事です。


実装中は、操縦し続ける

計画を立てて実装に入っても、そこで手を離していいわけではありません。書かせている途中で見当違いの方向に進み始めたら、その場で止めて直すほうが、最後まで走らせてから直すよりずっと早く済みます。

Escでの一時停止、Esc二回または/rewindでの巻き戻し、/clearでの仕切り直しといった操縦の道具は、会話の畳み方・戻り方ですでに扱いました。ここで加えたいのは、いつ使うかの目安です。

同じ問題で2回訂正しても直らないときは、3回目を試す前に/clearして、学んだことを盛り込んだ新しい指示で仕切り直すほうが、たいてい結果が良くなります。訂正を重ねるほど、会話の中に失敗した試みの記録が積み上がり、Claudeがそれに引きずられてしまうためです。


記録する: コミットも仕事の一部

実装が終わったら、コミットメッセージを書かせて終わりにします。「何を」だけでなく「なぜ」変えたかが分かるメッセージにしてもらうと、あとで自分が読み返すときにも、他の誰かが読むときにも役立ちます。

記録まで含めて一つの仕事、という感覚を持っておくと、実装を終えた時点で気が緩んで雑なコミットメッセージで済ませる、という事故を防げます。


やってみよう

演習1:直近の依頼を4段階に当てはめる

直近でClaude Codeに頼んだ仕事を1つ思い出してください。探索・計画・実装・記録のどこを省き、どこを厚くやったかを振り返ってみましょう。省いた段階があるなら、それは「一文で言える差分」だったかどうかも確かめてください。

演習2:計画が要る仕事、要らない仕事を仕分ける

今抱えている、または最近扱った仕事を3つ書き出し、それぞれ計画を作るべきか、直接頼んでよいかを判断してみましょう。判断の理由を一言添えると、次に似た仕事が来たときの目安になります。


次のレッスンでは、CLAUDE.md・スキル・フックという3つの指示の置き場所を、強制力の強さで比べます。

参考

Claude Code 公式: Best practices for Claude Code
探索・計画・実装・記録の4段階と、計画を省いてよい基準をまとめた一次情報。このコース全体を通じて参照します
code.claude.com/docs · code.claude.com
Claude Code 公式ドキュメント:Permission modes
権限モードとPlanモードの基本操作(英語)
code.claude.com

このレッスンは役に立ちましたか?