変更を見ただけで納得した気になると、だいたい後で崩れる。差分は「何を変えたか」しか教えてくれないが、ログは「そのとき何を考えていたか」を残す。Claude Code では、この二つを並べて追う癖をつけると、作業のズレがかなり減る。作業ログ、履歴確認、どちらの感覚でも使えるやり方だ。
特に効くのは、ファイル整理や文書作成みたいに、完成物そのものより「なぜそうしたか」が重要な場面だ。最初はうまくいったように見えても、後から「この並び替えは何のためだったのか」「この削除は本当に安全だったのか」で止まる。筆者も一度、メモの整理を Claude Code に任せたあと、変更履歴だけ見て満足していたら、不要な重複を消したつもりで別の版を残していた。ログを並べていなかったせいで、判断の筋道が消えていたわけだ。
やることは単純だ。Claude Code に作業を頼むとき、最初に「作業ログを残しながら進めてほしい」と明示する。次に、区切りごとに変更内容と判断理由を短く書かせる。最後に、必要なら Git の差分やファイルの更新履歴と見比べる。これだけで、単なる「結果の確認」から「判断の確認」に変わる。
たとえば、文書の整理やディスク削減なら、こう頼めばいい。
この作業では、各ステップで次を短く記録してください。
- 何を見たか
- 何を変えたか
- なぜその判断にしたか
- 迷った点があれば何か
作業ログは、あとで変更履歴と見比べられる形で残してください。
もう少し実務寄りにするなら、対象ファイルごとにログを分ける。雑に一括で進めると、後で「どの判断がどの変更に対応するのか」が消えるからだ。
以下の形式で作業ログを残してください。
1. 対象: ファイル名
2. 変更前の観察: 何が重複・不要・不整合だったか
3. 実施した変更: 何を削除・統合・移動したか
4. 判断理由: その変更を選んだ根拠
5. 確認結果: 変更後に何が改善したか
Claude Code にこの手のログを書かせる意味は、記録のためだけではない。途中で方針がぶれたとき、ログを見ればすぐ気づける。たとえば最初は「重複を消す」つもりだったのに、途中から「見た目を整える」話にすり替わっていたら危ない。変更履歴だけ見ると派手に整って見えるが、判断の軸がずれていることは普通にある。
ここで役に立つのが、作業を小さく区切るやり方だ。大きい依頼を一気に投げると、ログも変更も巨大になって追えない。逆に、1 回の依頼を「探す」「比較する」「直す」「確認する」に分ければ、各段階で何を根拠に動いたかが残る。
まずは重複候補を列挙してください。まだ削除はしないでください。
次に、残すものと消すものの判断理由を整理してください。
最後に、承認したものだけを変更してください。
この順番が大事だ。いきなり削除させると、ログの価値が落ちる。後で見返したとき、なぜ消したかが薄いからだ。筆者は一度、要らないキャッシュの削除を急がせて、結果だけはすっきりしたのに、どのファイル群がどの基準で消えたのか追えなくなった。空き容量は増えたが、同じ作業を再現できない。実務ではそれがいちばん面倒だ。
Git を使っているなら、変更履歴と作業ログを並べるのはさらにやりやすい。Claude Code に、コミット前提で差分を小さく保たせる。コミットメッセージまで任せる場合も、単なる「修正」ではなく、判断の軸が分かる短文にする。
変更は小さく分けてください。
各変更ごとに、作業ログを残し、最後に差分の意図を1行で要約してください。
コミットする場合は、後から見て判断の流れが追えるメッセージにしてください。
非エンジニアの使い方でも、この考え方はそのまま通る。たとえば案件フォルダの整理で、古い版の文書をまとめる、重複ファイルを消す、命名をそろえる。こういう作業は、見た目の整理だけだとあとで迷う。だから「このファイルを残した理由」「この版を捨てた理由」を残す。履歴確認ができるだけで、次回の修正速度がだいぶ変わる。
注意したいのは、ログを長く書かせればいいわけではない点だ。長文はむしろ邪魔になる。追うべきなのは、変更の事実より判断の分岐だ。何を見て、どこで迷い、なぜその結論にしたか。そこだけ残せばいい。細部を全部書かせると、後から読む気が失せる。ログは証明書ではなく、再現のためのメモだ。
もう一つ、変更履歴とログが食い違ったら、ログのほうを疑う。人間もモデルも、あとから説明を盛ることがある。実際には「見落としたから消した」のに、「重複していたので統合した」ときれいに書かれていることは珍しくない。だから、実ファイルの差分、更新日時、Git の履歴と突き合わせる癖をつける。ズレが見えたら、それ自体が手がかりになる。
最後に、実用的な型を置いておく。Claude Code に作業を頼むとき、毎回これを土台にすると崩れにくい。
作業を始める前に、対象と目的を1回で整理してください。
作業中は、各ステップごとに作業ログを残してください。
ログには、観察内容、実施内容、判断理由、保留点を入れてください。
変更後は、変更履歴とログを見比べて、判断がずれていないか確認してください。
ずれていたら、その場で修正してください。
このやり方のいいところは、Claude Code を「手を動かす人」ではなく「判断の流れを残す相棒」として使えることだ。結果だけを取りにいくと、あとで自分が困る。ログと変更履歴を並べると、その場しのぎの整理で終わらず、次の作業に使える記録になる。実務では、そこがいちばん効く。