「あれ、なんでこうしたんだっけ」で止まるなら、まだ手戻りは小さいほうだ。厄介なのは、Claude Code に作業を続けさせたあとで、前の判断が消えていることだ。判断ログ、あるいは「なぜそうしたかを記録する」癖がないと、数十分後に自分で自分の指示を疑う羽目になる。
Claude Code は、雑に言えば“今ある材料をもとに次の一手を組み立てる”道具だ。だからこそ、途中の節目で「何を選んで、何を捨てたか」を残しておくと強い。あとから迷ったとき、同じ調査をもう一回やらなくて済む。コンテキストの浪費も減る。diff が無駄に膨らむのも防げる。地味だが、効く。
たとえば、ファイル整理でも文書作成でも同じだ。最初は「このフォルダをこう切る」「この重複ファイルは残す」「この表現はやめる」と決める。ところが作業が進むと、Claude Code も人間も、最初の前提を薄く忘れる。そこで、節目ごとに短い判断ログを残す。これだけで、あとから「なぜその方針にしたか」を追える。
やり方は難しくない。Claude Code に作業を頼むとき、最初に「判断理由も一緒に残して」と明示する。しかも、長文でだらだら書かせる必要はない。短く、次の見出しに耐える程度で十分だ。
この作業では、節目ごとに判断ログを残してください。
形式は短くてよいです。
- 何をしたか
- なぜそうしたか
- 迷ったが採用しなかった案があればそれも書く
後から見返して、方針の変遷が追える粒度でお願いします。
もう少し実務寄りにするなら、出力の置き場所まで決めるといい。たとえば作業メモを notes.md に残す、あるいは本文の最後に「判断ログ」節を付ける。ファイルを分けるか、同じ文書に混ぜるかは好みだが、迷うなら同じ文書の末尾に寄せたほうが追いやすい。
作業中の判断は、本文とは別に末尾へ「判断ログ」として追記してください。
各項目は1〜3行で、次の形にしてください。
- 判断: ...
- 理由: ...
- 見送った案: ...
このとき大事なのは、「正しさ」より「経緯」を残すことだ。立派な説明文は要らない。あとで自分が読み返したときに、「ああ、ここで重複削除を優先したから、ファイル名の統一は後回しにしたのか」と分かれば勝ちだ。逆に、きれいな文章にしようとしてしまうと、判断の荒さが消えて役に立たなくなる。
筆者は以前、資料整理を Claude Code に任せたとき、方針メモを残さずに進めてしまい、途中で「この資料は統合するのか、原本を残すのか」が曖昧になったことがある。結果、差分を見ながら自分で意図を掘り直すはめになった。最初に判断ログを残していれば、同じファイルを何度も見返す必要はなかった。あれは単純にだるい。しかも、後から見ても自分の記憶は当てにならない。
判断ログを効かせるコツは、節目をちゃんと切ることだ。全部の小変更を記録する必要はない。むしろ、節目でいい。たとえば次のようなタイミングだ。
- 調査方針を決めたとき
- 削除対象や採用案を確定したとき
- 章立てやファイル構成を変えたとき
- 自動修正を続ける前に、人間側で前提を確かめたいとき
この切り方が効く理由は単純だ。小さな判断を全部書くと、ログがただの雑音になる。逆に、節目を外すと、肝心の分岐が残らない。たとえば「どのフォルダを先に掃除するか」「どの文書を統合するか」「どの表現を残すか」みたいな、あとで方針を左右するところだけ拾えばいい。
実際の依頼では、Claude Code に「判断理由が揺れそうなところを自分で検出して書け」と渡すのも手だ。
作業の途中で方針が分かれそうな箇所があれば、その場で判断理由を残してください。
特に、次の3点は必ず書いてください。
- 採用した案
- そうした理由
- 捨てた案と、その見送り理由
これで、ただ作業を進めるだけの出力から、あとで追える記録に変わる。非エンジニアの用途でもこれは強い。たとえば弁護士が案件ごとに資料を整理するとき、どの書面を残し、どれを重複扱いにしたかが残っていれば、後で別案件と見比べるときに迷わない。あるいは、不要キャッシュや重複ファイルを洗うときも、何を根拠に消したのかが分かっていれば、再確認が楽になる。削除作業は、消す瞬間より、その後の説明のほうが面倒だったりするからだ。
ただし、やりすぎはよくない。判断ログを「全部の思考の逐語録」にしてしまうと、肝心の作業が遅くなる。Claude Code のコンテキストも無限ではない。長文の独り言を積み上げると、後半で本筋がぼやける。だから、理由は一段だけ深く書く。三段も四段も掘らない。次の作業者、つまり数分後の自分が読めれば十分だ。
悪い例:
- なんとなくこの順番にした
- まあこっちのほうが良さそうだった
- たぶんこっちで合っている
よい例:
- 既存の命名規則と揃えるため、この順番を採用した
- 例外処理が増えるので、今回は統合を見送った
- 重複削除を優先すると、後続の確認が減るためこちらを先に処理した
この差は大きい。前者は記録した気になっているだけで、後から使えない。後者は、次の判断にそのまま使える。Claude Code はこういう短い因果関係のメモと相性がいい。長文の美文より、箇条書きの芯が強い。
もうひとつ、地味だが効く注意がある。判断ログには「迷ったが採用しなかった案」も必ず入れることだ。ここを省くと、後で同じ候補をまた掘り返す。最初からメモしておけば、再検討が必要なときだけ拾えばいい。Claude Code にも、見送り理由まで書かせると精度が上がる。
判断ログには、採用案だけでなく見送った案も書いてください。
見送った理由は短くて構いませんが、後で同じ案を再検討する価値があるか分かるようにしてください。
節目ごとの判断理由は、作業の“あと戻り防止”ではなく、“あと追い可能性”を作るためのものだ。あとで迷ったときに、何を基準に決めたのかを辿れる。これがあると、Claude Code に同じ相談を繰り返さなくて済むし、人間が見ても安心する。最終的に残るのは、きれいな成果物だけではない。そこへ至る理由の筋道だ。これが残っていると、次の修正がずっと軽くなる。