長い指示を書けば、Claude Code が賢くなると思っているなら、そこがまず勘違いだ。たいていは逆で、メモが長いほどノイズが増えて、あとで自分が困る。持たせるメモは短くする。この雑なほど効くやり方が、作業中の手戻りをかなり減らす。
ここでいう「メモ」は、Claude Code に仕事を続けさせるための短い引き継ぎ文だ。たとえば一度の編集で終わらず、次の作業に移るときに「何が決まり、何が終わり、次に何をするか」を渡すためのものだと思えばいい。要するに、議事録ではなく、作業再開のための付箋である。
長文メモがだめな理由は単純だ。Claude Code は会話の文脈を読むが、文脈は無限ではない。余計な背景説明、気持ちの整理、検討途中の迷いまで全部積むと、肝心の決定事項が埋もれる。しかも人間側も、あとでそのメモを見返したときに「結局何を決めたんだっけ」となる。作業の速度を上げるつもりが、逆に確認作業を増やすわけだ。
筆者も最初はやらかした。ファイル整理の作業で、「このフォルダは請求書、こっちは契約書、さらに古いものは別の基準で…」と、経緯まで含めて延々と説明したことがある。結果、Claude Code は真面目に読みすぎて、結局どのルールを優先するのか曖昧になった。指示の骨が見えなくなるのだ。短く削ってからは、同じ作業でも一発で通る率が上がった。
実際に残すべきなのは、迷った末の説明ではない。決まったことだけだ。たとえば次のようにする。
この作業のメモは短く保つ。
残すのは決定事項だけ。
背景説明、検討の経緯、候補案は捨てる。
次の作業に必要な制約と未完了のタスクだけ書く。
Claude Code に渡す引き継ぎ文も、同じ発想で十分だ。たとえば文章校正なら、こんな短さでいい。
- 口調は常体に統一
- 冗長な前置きは削除
- 変更は最小限
- 事実関係は変えない
- 未確定の表現は残す
ファイル整理なら、こういう形になる。
- 今年の請求書だけ残す
- 重複ファイルは削除候補として一覧化
- 画像は解像度を変えずに移動
- 迷うものは削除しないで別フォルダへ退避
大事なのは、「全部の事情を書く」ことではなく、「次の判断に効くことだけを書く」ことだ。ここを外すと、メモがただの独り言になる。
決定事項だけに絞るコツは、文の種類を分けることだ。検討中の文と、確定した文を同じメモに入れない。混ぜるとすぐ濁る。メモに残すのは、だいたい次の3種類で足りる。
まず、変更してはいけない制約だ。たとえば「ファイル名は変えない」「出力形式はMarkdownにする」「本文の事実は触らない」といったものだ。これは長く書かなくていい。短文でいいし、むしろ短いほうがいい。
次に、今回の作業のゴールだ。「重複ファイル候補を一覧にする」「契約書テンプレートを3案に絞る」「READMEの見出しを整理する」みたいに、終点だけを書く。途中の試行錯誤は要らない。
最後に、未完了の宿題だ。「要確認の箇所が2つある」「古い画像の扱いだけ未決定」などだ。これだけ残せば、再開時に迷わない。
この手のメモでやりがちな失敗は、思考のゴミまで保存することだ。たとえば「A案もB案も一理あるが、現状はAを採用しつつ、将来的にはBに寄せるかもしれない」みたいな文章は、作業メモには向いていない。意思決定の場では意味があっても、再開メモとしては長すぎる。次に必要なのは「Aを採用」「Bは保留」だけである。
もうひとつ、ありがちな落とし穴がある。短くしようとして、短すぎて空洞になることだ。「対応する」「整理する」「直す」だけでは足りない。何を、どこまで、どう扱うかがないと、Claude Code も人間も困る。短いのと曖昧なのは別物だ。ここを混同すると痛い目を見る。
実務では、作業が一区切りつくたびに、メモをこう削るといい。まず背景の説明を消す。次に検討候補を消す。最後に、同じ意味の言い換えを消す。残るのは一文か二文で十分なことが多い。長いメモをきれいに整えるのではなく、不要部分を切る発想だ。
悪い例:
このフォルダは以前は案件Aと案件Bが混ざっていたが、今後は請求関連だけを残し、古い画像は後で確認してから移動したい。ひとまず月別に分ける案も考えたが、今回は案件別に整理したほうがよさそうだ。
よい例:
- 案件別に整理する
- 請求関連だけ残す
- 古い画像は確認後に移動
この差はかなり大きい。前者は読むだけで疲れるし、後者はすぐ動ける。Claude Code にも人間にも、短くて決定事項だけのほうが扱いやすい。
少し進んだ使い方をするなら、メモを「作業メモ」と「確定メモ」に分けるのがいい。作業中の思いつきは作業メモに置き、Claude Code に渡すのは確定メモだけにする。そうすると、まだ揺れている案まで巻き込まれない。とくに文書作成やファイル整理では、この分離が効く。文章の推敲でいえば、下書きに残すものと提出版に残すものを分ける感覚に近い。
Claude Code に渡すなら、こんな言い方が実用的だ。
次の作業では、確定メモだけを使ってください。
作業中の検討メモは参照しないでください。
確定しているルールは以下です。
- 口調は常体
- 変更は最小限
- 不明点は保留
この一文を入れるだけでも、ブレが減る。長い経緯より、最終的に何が決まったかのほうがはるかに強い。Claude Code を使うときは、とにかく「判断材料を増やす」より「判断済みのものだけ残す」を優先したほうがいい。
要するに、メモは記録ではなく、次の一手のための道具だ。だから短くていいし、短いほうが強い。迷ったら、背景を一段削って、決定事項だけを残せばいい。作業はそこから速くなる。