PaPoo
cover

大きい変更は「この順でやる」と先に並べる

大きい依頼を雑に投げて、「いい感じにやって」で済むと思っていると、だいたい途中で崩れる。Claude Code も人間と同じで、やる順番が曖昧だと、先に触るべきでない場所まで手を出して、あとで戻す羽目になる。

ここで言うのは、実行順の指定、手順の固定、処理順の話だ。要するに、「何を先にやり、何を後に回すか」を最初に並べるだけである。これを入れると、大きい変更でも迷いが減る。コンテキストの浪費も少ない。差分も妙に膨らみにくい。

筆者は最初、この順番を省いて何度も手戻りした。たとえば、古い文章ファイルを整理してから命名規則をそろえたいのに、いきなりリネームに入られて、あとで参照先がずれる。あるいは、不要ファイルを消す前に集計を始めてしまい、残すべきものまで候補に混ざる。順番を決めないと、作業そのものより、修正のほうが面倒になる。

Claude Code に頼むときは、最初に「全体の段取り」を明文化するのが効く。いきなり本作業を命じるより、先に分解させるほうが安定する。

たとえば、フォルダ整理ならこう書く。

次の順で進めてください。
1. まず対象フォルダを確認し、残すものと消す候補を分ける
2. 次に、削除前に一覧を出す
3. 最後に、こちらの確認後に削除と整理を行う

各 चरणの前に、何をやるかを1行で宣言してください。
勝手に順番を変えないでください。

開発寄りの変更でも同じだ。

次の順で対応してください。
1. 既存の実装と関連ファイルを確認する
2. 変更案を短く箇条書きで出す
3. 影響範囲が小さい順に直す
4. 最後にテストを実行する

途中で別の改善を思いついても、先に予定した順番を崩さないでください。

この「順番を固定する」指定は、見た目以上に効く。理由は単純で、Claude Code が一度に抱える判断を減らせるからだ。変更の目的、対象、確認ポイントが混ざると、途中で別の最適化に寄り道しやすい。人間だってそうだろう。机の上を片付けるつもりが、写真の整理に脱線して、気づいたら別の休日が消える。あれと同じである。

特に大きい変更では、次の3つを先に並べるだけで事故が減る。

まず、準備作業を先に置く。対象ファイルの確認、関連箇所の洗い出し、バックアップや退避先の確認だ。これを飛ばして本体に入ると、戻す材料がなくなる。

次に、判断が必要な作業を後ろに回す。たとえば、削除か保留か迷うファイル、命名をどうするか迷う項目は、一覧を出してから決める。いきなり実行させると、勢いで消される。

最後に、破壊的な操作は一番後ろに置く。削除、上書き、置換、移動のような戻しにくい処理は、確認が終わるまで待たせる。ここを守るだけで、痛い手戻りはかなり減る。

実際の依頼文では、単に「順番にやって」では弱い。どの順番なのか、何を止めたいのかまで書く。たとえばこんな具合だ。

次の順で処理してください。
- 先に現状把握
- 次に変更候補の抽出
- 最後に実行

ただし、削除や移動の前に必ず一覧を出して止まってください。
こちらが確認するまで実行しないでください。

ここでやりがちな失敗がある。順番を指定したつもりで、実は「確認の順番」しか書いていないパターンだ。Claude Code は、曖昧な依頼だと割と素直に解釈を広げる。つまり、先にやってほしくないことまで「作業の一部」と見なす。筆者も一度、文書の整形を頼んだつもりで、構成の入れ替えまで勝手に進められ、修正差分が無駄に大きくなったことがある。整形だけ欲しかったのに、内容の整理まで手を出されると、あとで確認コストが跳ねる。だるい。

だから、大きい変更では「やること」より先に「やる順番」と「止まる地点」を書く。これが地味に強い。実行順の指定があるだけで、Claude Code は迷いにくくなるし、あなたも途中で崩れた作業を追いかけなくて済む。

少し進めるなら、順番を段階ごとに区切るのもいい。ひとつの長い命令文に全部詰め込むより、各段階の目的を短く書いたほうが通る。

1. まず現状を読み取る
2. 次に、変更対象だけを抜き出す
3. その後、影響の小さい順に修正する
4. 最後に、変更点を要約する

各段階の完了時に、短く報告してください。

ファイル整理でも効く。たとえば、ダウンロードフォルダの片付け、重複ファイルの洗い出し、古い書類の退避のような作業は、先に「見る」「分ける」「動かす」「消す」を分けるだけで安全性が上がる。消すより先に見る。動かすより先に分ける。この順番を崩さないのがコツだ。

もちろん、何でも細かく順番固定すればいいわけではない。小さな作業までガチガチに縛ると、逆に息苦しい。だが、大きい変更、複数ファイルにまたがる整理、戻しにくい操作が入る場面では、先に並べた順番がそのまま安全装置になる。

迷ったら、依頼文の冒頭にこれを入れておけばいい。

この作業は、確認 → 分類 → 実行 → 最終確認 の順で進めてください。
順番は変えないでください。
破壊的な操作は、必ず最後に回してください。

このひと言があるだけで、作業はかなり落ち着く。大きい変更ほど、勢いより段取りだ。順番を先に決める。それだけで、Claude Code はずっと扱いやすくなる。

関連 TIPS

同じ著者の記事