Claude Code に作業だけさせて、なぜその手を選んだのかを残さない。これ、あとで地味に困る。ファイルがどう変わったかは diff で見えるが、迷いどころや採用理由は消えるからだ。判断根拠を残す、迷いどころを記録させる、という使い方を入れておくと、あとで見返したときに「なんでこの構成にしたのか」「なぜこの重複を消したのか」が追える。
特に Claude Code は、整理、編集、要約、リネームのような作業を一気に進められる一方で、作業の途中で比較した案をそのまま捨てる。これは当然の挙動だ。だから、こちらが「結果」だけでなく「判断の途中」を残すように頼まないと、後で同じ迷いをもう一回やる羽目になる。
筆者は最初、要約だけを頼んで満足していた。ところが数日後に同じフォルダをまた触ると、前回なぜその分類にしたのか分からない。結局、ファイル名の付け方からやり直した。作業時間そのものより、脳の再起動コストがだるい。ここを潰すのがこの TIPS だ。
やり方は単純で、Claude Code に「最終成果物」と一緒に「判断メモ」も出させる。しかも、ただ感想を書かせるのではなく、候補、採用理由、捨てた理由を分けて残すのが効く。
たとえば、文書整理ならこんな頼み方でいい。
このフォルダ内の文書を整理してください。
作業後に、次の3点を必ず残してください。
1. 何をどう整理したか
2. 迷った点と、最終的にどう判断したか
3. 今後同じ整理をするときの注意点
判断の根拠は、短くていいので具体的に書いてください。
「内容が似ていたから」ではなく、「請求書と見積書で保存期間の扱いが違うため」みたいに書いてください。
コード作業なら、もう少し実務寄りにする。
この変更では、実装案を複数考えた場合、採用しなかった案も簡単に残してください。
出力は次の形式にしてください。
- 採用した方針
- 迷った点
- 採用しなかった案
- その案を捨てた理由
- 次回の変更で気をつけること
長い説明はいりません。レビューで追える程度に、判断理由を明示してください。
ポイントは、「理由を書いて」とだけ言わないことだ。理由だけだと、Claude Code はふわっとした説明で済ませがちになる。なので、どの粒度で残すかを縛る。候補と棄却理由まで分けると、あとから見たときに筋が通る。
ファイル整理やディスク削減の用途なら、この頼み方が特に役に立つ。たとえば重複ファイルを片付けるとき、単に消すだけだと危ない。似た名前の資料でも、片方は請求用、もう片方は提出用、なんてことがある。そこで Claude Code に「なぜ残したか」を書かせる。こうしておくと、あとで「あの削除は何基準だったっけ」とならない。
重複して見えるファイルがあっても、勝手に削除せず、残す候補と削る候補を分けてください。
各候補について、そう判断した理由を1行で残してください。
判断できないものは削除せず、「保留」にしてください。
ここで大事なのは、Claude Code に無理に断定させないことだ。判断材料が足りないのに削除まで進めると、当然だが事故る。筆者も一度、似た PDF をまとめて整える依頼をして、名前が似ているだけの別版まで巻き込まれそうになった。理由を残させる前提にしてからは、怪しいものを「保留」に逃がせるようになった。これがかなり効く。
Markdown や報告書を作らせる場合は、本文とは別に「判断ログ」を付ける形が扱いやすい。レポートの末尾に無理やり長文を混ぜると読みづらいので、ファイルを分けるか、別見出しに切るといい。
以下の文章を整えてください。
ただし、最終版とは別に、変更理由を箇条書きで残してください。
変更理由には次を含めてください。
- どこを直したか
- なぜ直したか
- 直さなかった表現があれば、その理由
文章作成では、「なぜその言い回しにしたか」を残させると後戻りが減る。たとえば社内文書で、やたら硬い表現に寄せた理由や、逆にくだけた表現を避けた理由が残っていれば、次回の文面調整が楽になる。感覚でやり直す時間が減るわけだ。
ただし、理由を残させるときには落とし穴がある。Claude Code に長い思考の実況中継を求めると、出力が冗長になる。判断の過程を全部文章化させると、ログが読まれない。これは本末転倒だ。残すべきなのは、あとで再利用できる短い判断メモであって、脳内会話の全部ではない。
だから指示はこう絞るといい。
判断理由は短く残してください。
1件につき1〜2行で十分です。
長い思考過程ではなく、あとで再現できる要点だけを書いてください。
もうひとつ、作業の前に「判断基準」を先に渡しておくと、理由がブレにくい。基準がないまま理由だけ求めると、その場しのぎの説明が混ざる。先に軸を置くほうが筋がいい。
優先順位は次の順です。
1. 誤削除しないこと
2. 後から探しやすいこと
3. 名前だけで中身が想像できること
この優先順位に沿って、各判断の理由を残してください。
この一文があるだけで、Claude Code の説明はかなり安定する。特に整理系では、見た目のきれいさより安全性を優先する、と明示したほうがいい。ここを曖昧にすると、整ってはいるが実用性が低い結果になる。
実務で使うなら、毎回同じお願い文を保存しておくのが楽だ。自分用のテンプレを作り、作業対象だけ差し替える。これで「理由を残して」という大事な条件を、うっかり落とさなくて済む。
対象:
{{ここにフォルダ名やファイル名}}
依頼:
対象を整理してください。
ただし、変更内容だけでなく、判断理由も残してください。
迷った点は必ず書き、保留にしたものは保留のまま残してください。
Claude Code を便利に使っている人ほど、結果だけ見て終わりにしがちだ。だが、長く使うなら判断理由の保存が効いてくる。作業そのものより、次の作業を速くするからだ。あとから同じ整理を繰り返す人、同じ文書を何度も直す人、案件ごとに似たようなディレクトリを掘る人ほど、この差が効く。
最後に、理由を残させるときのコツをひとつだけ押さえておく。Claude Code に「なんとなく」とか「いい感じに」は禁物だ。そういう指示は、結局あとで見返せない。残したいのは、感想ではなく判断材料だ。そこを外さなければ、作業の結果がただの一回限りで終わらない。次の手直しがかなり楽になる。