Claude Code に仕事を投げておいて、あとから「なんでそうしたんだっけ」と困る人は多い。
出力がそれっぽく終わると満足しがちだが、実務で痛いのはそこではない。途中で何を見て、何を捨てて、何を採ったかが残っていないことだ。これがないと、数日後に見返した瞬間に意味が死ぬ。
ここで効くのが、判断メモ、つまり意思決定ログだ。
Claude Code に「結果だけでなく、途中の判断も短く残せ」と最初から頼む。そうすると、あとから説明しやすい形で残る。ファイル整理でも文書作成でも同じで、最後の成果物だけ作らせると、なぜその構成になったのかが消える。消えた説明は、だいたい再現できない。ここがだるい。
たとえば、文書を整えるなら、Claude Code にこう頼む。
この作業では、最終結果だけでなく判断メモも残してください。
各ファイルについて、以下を短く記録してください。
- 何を基準にその判断をしたか
- 迷った案があれば何だったか
- 最終的に採用した理由
- 後で見返したときに説明に使える一文
本文の中に長く混ぜ込まず、最後に「判断メモ」としてまとめてください。
ファイル整理なら、もう少し具体的にしていい。
重複ファイルと不要キャッシュを整理したいです。
削除・移動の前に、判断の理由を短く残してください。
出力は次の順にしてください。
1. 何を対象にしたか
2. 何を残したか
3. 何を削除候補にしたか
4. なぜそう判断したか
5. 迷った点
最後に、人に説明するための短い要約も付けてください。
この頼み方の肝は、Claude Code に「ログの粒度」を先に決めさせないことだ。
放っておくと、判断の説明が長文になりすぎるか、逆に「整理しました」で終わる。どちらも使い物にならない。欲しいのは、後から読んで事情が分かる短文だ。議事録のように丁寧すぎる必要はない。だが、1 行で飛ばしすぎると説明にならない。
筆者は以前、古い案件の資料をまとめ直すときに、結果だけを並べさせて失敗したことがある。見た目はきれいになったのに、なぜその順番にしたのかが消えた。翌週、別の人に渡したら「この分類の基準は何ですか」と聞き返され、こちらが困った。そこからは、作業のたびに「判断メモを残せ」と先に書くようにした。すると、あとから見返す負担がかなり減る。
ポイントは、判断メモを「作業の邪魔な付録」にしないことだ。
出力の最後にまとめるだけで十分役に立つ。各ステップにべったり混ぜると、本文が読みにくくなる。しかも Claude Code は長い応答になるほど、肝心の結論が埋もれやすい。まず作業結果、その次に判断メモ。この順番が扱いやすい。
もうひとつ大事なのは、判断の理由を「中身のない正しさ」で飾らないことだ。
たとえば「より適切だから」「整理しやすいから」だけでは弱い。何を比較して、どこで線を引いたのかが必要だ。たとえばこう書かせる。
判断メモは抽象語でごまかさず、次の形式で書いてください。
- 判断対象
- 比較した案
- 採用した案
- 採用理由
- 捨てた理由
- 後で確認すべき点
この型は、開発でも非エンジニア作業でも効く。
コード修正なら「なぜその実装を選んだか」が残る。書類整理なら「なぜそのフォルダに入れたか」が残る。ディスク削減なら「なぜ消したか」が残る。後から説明が必要になる場面では、この差が大きい。
注意したいのは、判断メモを「正解の証拠」と勘違いしないことだ。
ログはあくまで、その時点で何を基準に決めたかの記録だ。後から見て、別の判断のほうがよさそうなら、それはそれでいい。むしろそこが価値だ。説明できる形で残っていれば、修正もしやすい。記録がないと、修正ではなく記憶の捏造になる。これは本当に面倒だ。
Claude Code に任せるときは、最初の依頼文に「説明責任」を入れるとブレにくい。
この作業は、あとから第三者に説明する前提で進めてください。
成果物だけでなく、判断の流れも残してください。
特に、迷った箇所と、なぜ最終案にしたかを短く記録してください。
ここまで書くと、ただの作業支援ではなく、再利用できるメモになる。
たとえば社内文書の整形なら、次回はその判断メモをそのままテンプレにできる。案件ごとのフォルダ整理でも、どの基準で分類したかが残っていれば、同じ手間を二度踏まなくて済む。
やりすぎは禁物だ。
判断メモを細かくしすぎると、今度はログを読むほうがだるい。毎回、全候補を列挙させる必要はない。迷った点と採用理由が分かれば足りる。実務では、全部を記録するより、あとで説明が詰まりやすいところだけ押さえるほうが強い。
最後に、使い勝手のいい一文を置いておく。これを毎回の依頼に足すといい。
出力の最後に、判断メモを3〜5項目で付けてください。
各項目は「何を」「なぜ」「どれを採ったか」が分かる短文にしてください。
この一文があるだけで、Claude Code の出力は「できました」で終わらなくなる。
あとから見返して説明できる形にしたいなら、完成物だけを取りにいく癖を捨てることだ。途中で何を判断したかを残す。たったそれだけで、作業はだいぶ再利用しやすくなる。