PaPoo
cover

持たせるメモは短く、決定事項だけ残す

Claude Code に長い作業メモを食わせて安心していると、だいたい途中で鈍る。読ませたいのは議事録ではなく、次に動くための要点だ。
作業メモを削る、短いメモだけ渡す。どちらも同じ話で、要するに「判断に必要な情報だけ残し、経緯は捨てる」ということになる。

これは開発でもファイル整理でも文書作成でも効く。メモが長いほど親切に見えるが、実際にはノイズが増えるだけだ。Claude Code は長文を読めるが、読めることと、うまく動けることは別物である。余計な経緯、迷い、雑談を持たせると、出力も散るし、手戻りも増える。

筆者は最初、メモを丁寧に残そうとして失敗した。たとえば「こういう方針で、あのときはこう考えて、例外はこれで……」と延々書いた結果、Claude Code が“全部大事”として扱ってしまい、結局どれも浅く触るだけになった。人間の議事録としては親切でも、作業指示としては重すぎる。そこから、残すべきなのは決定事項だけだと割り切った。

実際の書き方は単純でいい。長い経緯を要約しようとせず、最終的に決まったことだけを短く渡す。

このフォルダの整理を進めてください。
残すもの:
- 請求書のPDF
- 今年分の契約書
- 送付済みの最終版だけ

削るもの:
- 下書き
- 重複ファイル
- 古いキャッシュ

判断基準:
- 最終版が1つだけあるならそれを残す
- 日付が古く、再利用しないものは削除候補にする
- 迷ったら削除せず、候補として一覧に出す

このくらいで十分だ。Claude Code に「何を決めたか」が伝われば動ける。逆に、会議で出た全意見や迷いの過程まで入れると、メモが肥大化して、肝心の判断軸が見えなくなる。

文書作成でも同じである。たとえば章立てを作りたいなら、長い背景説明より、採用する見出しと落とす見出しをはっきり書く。

次の方針で原稿を整理してください。

採用する内容:
- 料金の違い
- 導入手順
- つまずきやすい点

入れない内容:
- 製品の沿革
- 似たツールの雑学
- 細かすぎる比較表

決定事項:
- 読者は初心者を含む
- 専門用語は最小限にする
- 具体例を1つ入れる

こういう短いメモのほうが、修正もしやすい。あとで方針を変えたくなっても、差し替える箇所が少ないからだ。長文メモは一見「全部入り」だが、実際には古い判断と新しい判断が混ざりやすい。そこがだるい。Claude Code 側も、どこが最終決定なのか見失いやすい。

一方で、短くするなら何でも削っていいわけではない。削ってはいけないのは、判断の基準だ。ここを落とすと、ただの短文になる。たとえば「古いものを消して」とだけ書くと、何を古いとみなすのかでブレる。「1年以上使っていない」「最終版が別にある」「重複している」のような基準は残すべきである。
要するに、残すのは感想ではなくルールだ。

非エンジニアの用途でもこれは効く。たとえば大量のPDFや写真を整理したいとき、Claude Code に見せるメモは長い説明文でなくていい。

整理方針:
- 家族写真は年ごとに分ける
- 旅行先ごとのフォルダを作る
- 同じ内容のファイルは1つだけ残す
- 名前の付け直しは必要最小限にする

迷ったら:
- 消さずに別フォルダへ避難
- 先に一覧を出してから削除判断する

この出し方だと、作業が止まりにくい。人間の頭の中にある「だいたいこうしたい」を、判断だけに圧縮して渡せるからである。
逆に、過去の経緯や愚痴まで抱え込ませると、メモが重くなるだけでなく、整理の基準まで曇る。ファイル整理でそれをやると、削除候補が増えすぎて見通しが悪くなる。文書作成でも、背景説明に引っ張られて本筋が遅れる。どちらも地味に痛い。

つまずきやすいのは、「短い」と「雑」を混同することだ。短くするほどいい、ではない。必要な決定事項が抜けた短さは、ただの丸投げである。
筆者も一度、メモを削りすぎて「どこまで手を入れるか」を書かずに渡し、余計な整形まで走らせてしまった。結果、あとで戻す羽目になった。短くするなら、範囲・優先順位・やらないこと、この3つは残すべきだ。

たとえば、こういう形にすると安定する。

やってほしいこと:
- 重複した下書きを1つにまとめる
- 最終版だけ残す
- 明らかな不要ファイルを候補に分ける

やらないこと:
- 内容の書き換え
- 文体の変更
- 勝手な削除

判断に迷うもの:
- いったん保留
- 候補一覧を作る

この書き方は、Claude Code にも人間にも読みやすい。しかも後で見返したとき、何を決めたのかがすぐ分かる。作業メモは記録ではなく、次の行動を通すための切符だと思ったほうがいい。

少し進めるなら、メモの末尾に「決定事項だけ」を分けて置く運用がやりやすい。たとえば会話や途中メモを残す場合でも、最後に必ずこれを書く。

決定事項:
- 出力は短くする
- 迷ったら候補として出す
- 削除は自動実行しない

この一塊があるだけで、あとから再開したときの迷いが減る。長い経緯は必要になったら掘ればいいが、最終的に何が決まったかは、その場で短く固定しておくべきだ。Claude Code を使うとき、ここを雑にすると毎回同じところで手戻りする。実務ではそれがいちばん損だ。

短いメモは、冷たい省略ではない。むしろ、相手に余計な迷いを持たせないための親切である。決めたことだけを残す。そこから始めると、Claude Code はずっと扱いやすくなる。

関連 TIPS

同じ著者の記事