長時間いじったあとに「全部見直してください」と投げるのは、だいたい破綻する。差分がでかすぎて、Claude Code も人間も本当に大事なところを見失うからだ。ここでやるべきなのは、差分圧縮と要点整理だ。作業の途中で散らかった変更を、あとから読める単位に畳み直す。変更点の量を減らす話ではない。意味の粒度をそろえる話である。
Claude Code では、ひたすら作業を続けたあとに「変更を要点だけ残す形にして」と頼むと、雑多な修正をまとめ直す助けになる。ファイル整理でも、文書作成でも、コード修正でも効く。要は、あとで自分か相手が追える状態に戻す作業だ。
最初にやることは単純だ。いったん変更を見せて、何を残し、何を捨てるかを明確にさせる。
ここまでの変更を差分圧縮したい。
次の3つに分けて整理してほしい。
1. 本当に残すべき変更
2. まとめられる変更
3. 捨ててもよい一時的な変更や試行錯誤
出力は、変更点の要点を箇条書きで短くまとめて。
そのあと、必要ならコミットメッセージ案も出して。
この頼み方のいいところは、Claude Code に「全部説明しろ」と言わない点にある。全部説明させると、長い作業の途中で生まれた枝葉まで引きずり出される。そうなると、要点整理どころか、逆にノイズが増える。筆者は昔、途中の試行錯誤まで丁寧に説明させてしまい、レビューで「結局どれが本筋？」となって手戻りした。長い作業のあとこそ、説明量を減らしたほうが強い。
実務では、こういう形にすると扱いやすい。
今の作業内容を、あとで人が読める形に圧縮してほしい。
ただし次の条件を守ること。
- 変更の意図が伝わることを最優先にする
- 細かい作業ログは消す
- 同じ意味の修正は1つにまとめる
- 迷いがある箇所は「未確定」と明記する
最後に、次に私がやるべき確認作業も3点だけ出して。
ここで大事なのは、「圧縮」の意味をはっきりさせることだ。Claude Code は魔法のリライト機ではない。勝手に内容を削ってくれるわけでも、意図を推測して完璧に整えてくれるわけでもない。だから、何を圧縮対象にするかを指定する必要がある。差分圧縮は、不要部分を消すことではなく、意味の重複を消すことだ。似た修正が何十個も並んでいたら、グループ化して一段上の説明に戻す。これだけで、要点整理の質がかなり変わる。
文書作成でも同じだ。たとえば長い議事録の下書き、ひたすら追記した手順書、案件ごとに増えたメモ群。こういうものは、作業を続けた本人ほど読めなくなる。Claude Code には、次のように頼むといい。
このメモを、読者が最短で理解できる形に整理して。
残すもの:
- 決定事項
- 未決事項
- 次のアクション
削るもの:
- 途中で試した案
- 同じ意味の言い換え
- 感情的な言い回し
文章は短く、重複なしで。
非エンジニアの使い方でも、これはかなり効く。たとえば、フォルダの中に案件ごとの資料、PDF、下書き、修正版がぐちゃっと入っているなら、「何が最終版か」「どれが重複か」を整理するために使える。削除前に「残すべきもの」と「まとめてよいもの」を分けるだけでも、あとで探す時間が減る。
ただし、ここで雑にやると痛い目を見る。いちばん多い失敗は、「要点だけ残して」とだけ言って、何を要点とみなすかを渡していないケースだ。すると、Claude Code はそれっぽく圧縮するが、こちらが残したかった微妙な差分まで丸めてしまうことがある。コードなら挙動の差、文書なら契約条件や日付、ファイル整理なら保存先や版数。こういう部分は削っていい領域ではない。
だから、圧縮の前に境界を決める。たとえばこんな指定が効く。
要点整理の対象は、変更の意図と最終状態だけ。
実装途中の選択肢、失敗した試行、コメントの言い換えは残さなくていい。
ただし、次は削らないで。
- 挙動が変わる条件
- ファイル名や保存先
- 日付、数値、依存関係
この一文を入れるだけで、圧縮の品質がだいぶ安定する。実際、筆者は「削っていいもの」を明示せずに任せて、あとから「いや、その条件分岐は残すべきだった」となったことがある。人間でも長い差分は読みにくいが、Claude Code も同じで、文脈が薄いと細部を軽く見てしまう。大きな作業の後ほど、守る線を先に引いておくべきだ。
もうひとつ、やっておくと便利なのが、圧縮後にそのまま出せる形へ整えることだ。要点整理の結果を、レビュー用メモやコミットメッセージ、引き継ぎ文に落とし込ませるのである。
整理結果を次の3形式で出力して。
1. 1行要約
2. 3〜5項目の要点
3. レビュー担当者への確認ポイント
どれも重複はなし。
曖昧なところは曖昧と書く。
これをやると、長い作業のあとに残るものが増える。単なる「あとで見返せるメモ」ではなく、次の人に渡せる形になるからだ。差分圧縮は、作業ログをきれいにするための飾りではない。あとで迷わないための、かなり実用的な後始末である。
細かい話をすると、圧縮は一発で終わらせないほうがいい。まず大きくまとめる。次に、残った要点をもう一段だけ短くする。いきなり極限まで削ると、何をやったかは残っても、なぜそうしたかが消える。そこまで消えると、次の修正で同じ迷いを繰り返す。長い作業のあとに必要なのは、空白ではなく、読める密度だ。
Claude Code の使い方として覚えておくといいのは、「作業させる」と「整理させる」は別の指示にしたほうが強い、という点だ。途中で何度も方針が変わるような場面では、まず作業を進める。終わったら、最後に差分圧縮して要点整理をやらせる。この切り分けができると、コンテキストの浪費も減るし、見直しも楽になる。長い作業のあとの一手間が、あとでの数時間を節約する。これが地味に効く。