いきなりブランチを切って、あとから全部を Claude Code に投げ込む。これ、かなり雑だ。変更前整理を先にやらないと、ブランチ運用がすぐ重くなるし、小さく始める準備もできない。結果として、diff は肥大化する、指示はぼやける、どこまで直したのか自分でも追えなくなる。
Claude Code を使うなら、最初にやるべきなのは「何を変えるか」を作業前にほどくことだ。コード修正だけの話ではない。ファイル整理でも、ディスク削減でも、文書作成でも同じで、先に材料を整理したほうが、後のやり取りが短くなる。筆者は以前、関連ファイルをまとめずに「このフォルダを整えて」とだけ頼んで、似た名前のファイルを何往復も確認する羽目になった。あれは完全に準備不足だった。
まずやることは、作業の境界を決めることだ。Claude Code に丸投げする前に、対象を狭く切る。たとえばリポジトリなら、機能全体ではなく、1 画面、1 コマンド、1 文書、1 ディレクトリに絞る。ファイル整理なら、まずは「Downloads の画像だけ」「契約書フォルダの重複 PDF だけ」のように切る。ここを曖昧にすると、AI は広く触ろうとする。広く触ると、差分がでかくなる。でかい差分は確認がだるい。だるいものはミスる。
Claude Code に渡す前の整理は、こんな順でやると扱いやすい。
1. 何を変えたいかを 1 行で書く
2. 対象ファイルや対象フォルダを絞る
3. 触ってほしくないものを先に決める
4. まずは小さい変更だけ頼む
5. その差分を見てから次へ進む
この「触ってほしくないものを先に決める」が地味に効く。たとえば開発なら、テストや設定ファイルまで勝手にいじられると面倒だ。文書作成でも、本文の中身だけ直したいのに、見出しやファイル名まで一緒に変えられると確認コストが跳ねる。Claude Code は、指示が広いと広く仕事をする。だから先に境界線を引くのが正解だ。
実際の頼み方は、ぼんやりした依頼より、変更前整理を含めて明示したほうがいい。
この作業は小さく始めたいです。
まず既存ファイルをざっと確認して、変更が必要な範囲だけを絞ってください。
いきなり大きく書き換えず、最初は 1 つのファイルだけを最小限で直してください。
変更対象と変更しない対象を分けて、先に方針を短く説明してください。
もう少し実務寄りにするなら、ブランチ運用の前に「作業メモ」を作るのがいい。これはエンジニアだけの話ではない。たとえば、相続関係の書類をまとめる人なら、案件ごとにフォルダを掘る前に「案件名」「優先順」「捨てていい重複」をメモしておく。Claude Code にもそのまま見せられる。ディスク削減なら、消していい候補と残す候補を先に分ける。文書作成なら、直す段落と触らない段落を分ける。準備があるだけで、AI の返答はかなり安定する。
作業メモ
- 対象: docs/guide/ のみ
- 目的: 初心者向けに読みやすくする
- 触らない: 仕様、コマンド例、ファイル構成
- 最初の変更: 導入文の整理だけ
ここでやりがちなのが、「どうせ Claude Code が読むから」と雑に置くことだ。雑な材料は、雑な返答しか呼ばない。とくに、複数の候補があるのに優先順位を決めないまま始めると、途中で分岐する。筆者はこれで、似た役割のファイルを両方直してしまい、あとから差分の整合を取る羽目になった。あれはブランチを切る前に整理していれば防げた事故だ。
小さく始めるコツは、最初の一歩を「確認しやすい変更」にすることだ。いきなり完成形を作らせない。まずは名前を整える、不要ファイルを洗い出す、見出しだけ直す、1 箇所だけ書き換える。確認しやすい変更なら、レビューも戻しも軽い。Claude Code には、最初から全体最適を求めるより、局所的な改善を頼んだほうがいい。
まずは 1 ファイルだけ。
内容は変えすぎず、冗長な説明を削ることを優先してください。
他のファイルへは触らないでください。
終わったら、変更理由を短く箇条書きで出してください。
注意したいのは、整理と削除を同じ段でやらないことだ。これを混ぜると、何が変更で何が整理なのか見えなくなる。特にファイル整理やディスク削減では、削除候補を先に並べても、すぐ消させないほうがいい。まず候補を出させ、次に自分で確認し、そのあと実行だ。勢いで消すと痛い目を見る。
コード作業でも同じで、最初からリファクタリングまで抱き合わせにしないほうがいい。機能修正、命名整理、テスト追加を一度にやると、何が効いたのか分からなくなる。ブランチを切る前に整理する意味は、ここにある。小さい差分は、失敗しても戻しやすい。戻しやすい変更しか、最初は進めない。これがブランチ運用の基本だ。
もし Claude Code への依頼が長くなるなら、最初のメッセージで全部を詰め込まず、順番を切るといい。
1. 対象を整理
2. 変更方針を確認
3. 最小変更を実施
4. 差分を見て次を決める
この順番にしておくと、途中で「やっぱりこの範囲は触らない」が言いやすい。作業前に整理しておくと、変更を小さく始める準備ができるだけでなく、あとで方針転換しても崩れにくい。
Claude Code をうまく使う人は、いきなり賢くさせようとしない。先に材料を並べ、境界を引き、最初の一手を小さくする。地味だが、これがいちばん効く。