作業の最後にログを見返さず、全部を「次回の改善点」に混ぜると、だいたい続かない。しかも次の作業で効くのは、毎回ぜんぶではない。迷った地点だけだ。
Claude Code の作業ログは、ただの記録ではない。ログ振り返りに使うと、どこで迷って、どこで指示が雑で、どこで手戻りしたかが見える。そこだけを拾って次回テンプレ化すれば、同じムダをかなり減らせる。
筆者も最初は、ログを読んで気づいたことを全部メモに入れていた。結果、改善メモが肥大化して、次回に使うときには逆に何を直せばいいか分からなくなった。そういうのは、だいたい続かない。戻すのは「迷った地点」だけでいい。
Claude Code の作業ログを見返すとき、見るべきなのは「うまくいった箇所」ではなく、「そこで一段止まった箇所」だ。たとえば次のような場面である。
この「迷った地点」だけを抜き出して、次回の最初に戻せる形へ直す。これが次回テンプレ化だ。
たとえば、文書作成ならこうなる。
次回は最初に以下を明記する。
- 対象フォルダ
- 使うファイル名のルール
- 出力形式
- 絶対に触らないファイル
- 変更前に確認する点
これだけでいい。大事なのは、反省文を書くことではなく、次の依頼に埋め込める形へ変えることだ。
見返すときに探すのは、雑に言えば「ここ、もう一回聞き返したな」という場所だ。Claude Code が何度も確認を返してきた箇所、こちらが追加説明した箇所、途中で方針転換した箇所。そこが改善ポイントである。
筆者は、こういう失敗をやったことがある。最初の依頼で「不要ファイルを整理して」とだけ投げたら、対象が広すぎて、削除候補の確認に何往復もした。ログを見返すと、問題は削除作業そのものではない。先に「何を不要とみなすか」を決めていなかったことだった。次回は最初から、次のように書くようにした。
不要ファイルの判定基準を先に出してから作業してほしい。
削除候補は、実行前に一覧で確認すること。
対象外は、README、設定ファイル、成果物の本体。
これで迷いはかなり減る。作業ログは、こういう「前提が抜けていた一文」を探すためにある。
テンプレというと、つい立派なひな形を作りたくなる。だが実際には、長いテンプレほど使わなくなる。Claude Code には、短くて硬い前提を先に置くほうが効く。
たとえば、毎回の開始時に入れるテンプレはこんな程度でいい。
作業を始める前に、次の3点を確認してから進めてほしい。
1. 対象範囲
2. 変更しないもの
3. 完了条件
迷ったら先に質問すること。
これを、ログで実際に迷った地点に合わせて少しずつ増やす。いきなり全部を盛ると、読む側も使う側もだるい。
ここで重要なのは、テンプレ化するのは「手順」ではなく「迷いを防ぐための前提」だという点である。手順は案件ごとに変わる。前提は似る。だから、戻すべきなのは前提のほうだ。
作業ログを見返すときは、迷い方をざっくり分けると扱いやすい。全部を同じ「失敗」に入れないことだ。
たとえば、迷いにはこんな種類がある。
この中で、次回に戻すべきなのは、たいてい最初の2つか3つだ。出力が少し崩れた、という程度なら、テンプレに細かいルールを足しすぎないほうがいい。そこまでやると、今度は読みづらくなる。
非エンジニアの作業でも同じである。たとえば、案件フォルダの整理をClaude Codeに任せるとき、細部の命名規則までいじりたくなるが、まず必要なのは「どのフォルダを触って、どれは触らないか」だ。そこが固まれば、細部はあとで直せる。
ログ振り返りでよくある失敗は、気づいたことをメモに貯めるだけで終わることだ。見るたびに「なるほど」で終わる。これでは意味がない。
やることは単純で、作業ログの中から迷った一行を、次回の依頼文の冒頭に移すだけである。
たとえばログにこうあったとする。
途中で対象ファイルが広がり、不要な変更が入った。
次回テンプレでは、こう直す。
最初に対象ファイルを固定すること。
指定したファイル以外には触らないこと。
変更前に、対象一覧を先に出すこと。
この変換ができると、ログはただの記録から、次回の起動装置になる。ここまで来て、ようやく価値が出る。
筆者がやって痛かったのは、ログで気になった点を片っ端からテンプレに入れたことだ。結果、依頼文が長くなり、Claude Code に渡す前提だけで疲れるようになった。そこまでいくと逆効果である。
テンプレ化するのは、毎回起こる迷いだけでいい。たまにしか起きない特殊ケースは、案件メモに残す程度で十分だ。毎回の起動テンプレに混ぜると、ノイズになる。
それと、作業ログを見返すときは、結果の良し悪しだけで判断しないほうがいい。うまく終わった作業でも、途中に一回だけ詰まった地点があるなら、そこは次回の改善点になる。逆に、多少荒くても迷いが少なかったなら、テンプレは増やさなくていい。
このやり方が安定してくると、次回テンプレ化はかなり楽になる。毎回の作業の前に、Claude Code に同じ確認を返させるのだ。
作業を始める前に、次の項目を確認して要約してほしい。
- 対象
- 変更しないもの
- 完了条件
- リスク
- 不明点
確認が終わるまで実作業に入らないこと。
この確認文は、ログで毎回ぶれていたところに合わせて育てる。たとえば、ファイル整理なら「対象外フォルダ」、文書作成なら「文体」「分量」「提出先の形式」だ。開発作業なら「テストの実行条件」「差分の範囲」が効く。
こうしておくと、次回はログを全部読み返さなくてもいい。迷った地点だけ確認すれば足りる。作業開始のたびに過去の失敗を全部掘り返すのは、あまりに重い。必要なのは、そこじゃない。次に戻すべき一点だけだ。