PaPoo
cover

長い依頼の冒頭に、今の状態を短く書き出す

長い依頼でいちばん雑に扱われがちなのは、実は“今の状態”だ。
ここを省くと、Claude Code は毎回まっさらな気分で読み始める。こちらは「前提くらい分かるだろ」と思っているのに、向こうから見ると肝心の足場が見えていない。結果、手戻りが増える。地味だが、かなりだるい。

この手の依頼では、冒頭に短い現状メモを置くのが効く。途中再共有とか、前提の再掲と呼んでもいい。要するに「いま何がどうなっていて、どこで詰まっていて、何を優先したいのか」を先に一段落で書くやり方だ。Claude Code は会話の流れを読めるが、長い作業ほど途中で前提がぼやける。だから最初に短く固定する。

たとえば、ファイル整理ならこういう入り方になる。

今の状態を先に書きます。
- このフォルダには請求書PDF、スキャン画像、古い下書きが混ざっている
- まず重複っぽいものと不要そうな一時ファイルを分けたい
- いきなり削除はせず、削除候補を一覧にしてから進めたい

この前提で、整理の手順を提案して。必要ならコマンドも出して。

これだけで、依頼の解像度がかなり上がる。Claude Code にとっての「何を見ればいいか」が明確になるからだ。
文書作成でも同じで、背景が長い案件ほど効く。

今の状態を先に書きます。
- 既存の説明文はあるが、重複表現が多くて読みにくい
- 役員向けなので、結論を先に出したい
- ただし、事実関係は変えずに短くしたい

この前提で、読みやすい構成に直して。

ここで大事なのは、長く説明することではない。短くてもいいから、現状の“輪郭”を先に出すことだ。
「何があるか」「どこが困っているか」「何を避けたいか」の3つが入っていれば十分である。細部は後で詰めればいい。

筆者は最初、ここをサボって何度も手戻りした。
「古い原稿を整えて」とだけ投げると、Claude Code はちゃんと整える。だが、こっちは“削る”より“言い回しを残したまま読みやすくする”つもりだったりする。そのズレが出ると、差分が無駄に膨らむ。直して、また直して、また戻して、という流れになる。長い依頼ほど、この往復が面倒だ。冒頭の現状メモは、その無駄をかなり減らす。

非エンジニアの作業でも同じだ。たとえば、ディスク整理なら「空き容量が足りない。まずは大きいものを見つけたい。消してよい候補と残すべき候補を分けたい」と書く。これで Claude Code は、いきなり消去ではなく、確認しながら進める方向に寄せやすくなる。
弁護士や事務職の書類整理でも効く。「案件ごとにフォルダが散らばっている。まずは案件単位でまとめ直したい。提出済みのものは残し、ドラフトだけを整理したい」みたいに書くと、作業の筋が通る。

ただし、やりすぎると逆効果だ。
現状メモに“判断”まで全部入れ込むと、ただの長い独白になる。冒頭で必要なのは、あくまで前提の再掲であって、結論の押しつけではない。たとえば「これは不要だから削除して」と最初に決め打ちしすぎると、Claude Code が検討すべき余地を失う。迷っているなら、そこは迷っていると書けばいい。

今の状態を先に書きます。
- 似た名前のファイルが多く、どれが最新版か分からない
- 削除したい気持ちはあるが、先に候補を見て判断したい
- 変更は最小限にしたい

まずは整理方針を出して。勝手に削除はしないで。

この「勝手にやらないで」を先に置くのも大事だ。長い依頼では、やってほしいこととやってほしくないことが混ざりやすい。Claude Code は強引に進められると仕事が早いぶん、こちらの意図とズレたときの修正コストも大きい。だから冒頭でブレーキをかける。これは遠回しな配慮ではなく、実務上の保険だ。

少し慣れてきたら、現状メモはテンプレ化しておくと楽になる。毎回ゼロから書く必要はない。
たとえば、長い依頼の冒頭に次の3行を入れるだけでも十分だ。

今の状態:
- いま何があるか
- どこで詰まっているか
- 何を優先したいか

そのあとに、具体的な作業内容を続ける。
この順番が崩れなければ、かなり扱いやすい。Claude Code に長い仕事を任せるときほど、最初の一息で足場を渡してやるのが効く。前提が見えていれば、途中で話が散らかりにくいからだ。

長い依頼を書くたびに「説明が雑だったかも」と思うなら、まず冒頭だけ直せばいい。全部を丁寧に書き直す必要はない。
今の状態を短く書き出す。それだけで、やり取りの往復は目に見えて減る。

関連 TIPS

同じ著者の記事