PaPoo
cover

別作業の成果を混ぜない

Claude Code を使っているのに、あとで「このファイル、誰の仕事の途中だっけ」となるなら、だいたい混ぜすぎだ。
一時ファイルと成果物を分離する。作業途中のゴミを残さない。ここを雑にすると、ディスクはじわじわ減るし、差分は読みにくくなるし、別件の作業まで巻き込む。筆者も最初はよくやった。資料を整えてほしいだけなのに、途中生成したメモ、抽出結果、古い版が同じ場所に積もって、どれが納品物か分からなくなった。Claude Code は賢いが、置き場が曖昧だと平気で曖昧なまま積む。そこを人間が締める必要がある。

この話は開発だけの話ではない。文書作成、議事録整理、案件ごとのファイル整頓、画像やCSVの一時処理でも同じだ。成果物は成果物、一時物は一時物。まずこの線を引く。

一番やりやすいのは、作業ディレクトリを最初から分けることだ。案件単位、目的単位でフォルダを切り、途中の派生物はその中の一時置き場に閉じ込める。たとえば、原稿を磨くなら入力、作業中、完成版を分ける。不要なら一時置き場ごと消せる。これだけで後始末がかなり楽になる。

project/
  input/       # 元データ
  work/        # 途中生成物
  output/      # 渡すもの
  archive/     # 残したい古い版

Claude Code に頼むときも、最初の指示でこの分離を明言しておくといい。曖昧に「整えて」とだけ言うと、途中ファイルをあちこちに置いたまま進むことがある。依頼文はこう書けばよい。

この作業では、元データは input に残し、途中生成物は work にだけ出してください。
最終成果物は output に保存してください。
work に置いたものは納品対象に含めないでください。

もう少し厳密にしたいなら、ファイル名のルールまで決める。これは地味だが効く。drafttmpscratchintermediate のような名前を付けたものは全部一時物だと割り切る。逆に、成果物は日付や版を入れてもいいが、作業用と混ぜない。筆者は以前、final という名前を何度も上書きして痛い目を見た。見た目は本物っぽいのに、中身はまだ途中。そんなファイルが一つあるだけで、Claude Code に渡す指示も人間の確認も雑になる。

Claude Code に具体的に指示するなら、こんな感じだ。

一時ファイルは work/tmp にまとめてください。
途中の変換結果、検証用ファイル、抽出した断片はすべてそこへ置いてください。
output には最終版だけを残し、途中版は置かないでください。
作業後は work/tmp を確認し、残す理由のないファイルは削除してください。

ここで大事なのは、「途中のものを残さない」ではなく、「残す場所を固定する」ことだ。残さない、は根性論になりやすい。固定する、は運用になる。Claude Code は作業の流れに沿ってファイルを作るので、置き場所が決まっていれば散らかりにくい。逆に、どこでも作っていい状態だと、後で成果物だけ拾う作業がしんどくなる。

非エンジニアの文書作成でも考え方は同じだ。たとえば案件ごとに

案件A/
  元資料/
  下書き/
  提出用/

にしておけば、会議メモや差し替え前の文を下書きに閉じ込められる。提出用に入っているものだけ見ればよいので、確認が速い。重複ファイルを探して消す作業も減る。ディスク容量を食うのは、完成版そのものより、途中で増えた複製や一時出力のほうが多いことがあるからだ。

気をつけたいのは、成果物に一時物を「参考資料」として混ぜ込む癖だ。やりがちだが、あとで地獄を見る。たとえば最終レポートの隣に、途中メモ、捨てるはずだった表、検算用CSVを置く。ぱっと見では親切そうでも、次の作業で「どれが本体か」を毎回判断する羽目になる。Claude Code にも、人間にも無駄だ。残すなら残す、捨てるなら捨てる。中間の気持ち悪い状態を作らない。

もう一つ、別作業の成果を混ぜないコツは、作業のたびに新しい場所を作ることだ。前回の成果物を見ながら次の依頼をするときも、同じフォルダに積み増ししない。コピーして持っていくなら、元の案件とは切り離す。Claude Code にこう頼むとよい。

前回の成果物をベースにしつつ、この作業は別案件として扱ってください。
新しい作業用ディレクトリを作り、元の案件のファイルは変更しないでください。
変更が必要な場合だけ、どのファイルを触るか先に示してください。

この指定は地味だが効く。別件の成果物を混ぜると、差分が読みにくくなるだけでなく、どこまでが今回の成果か分からなくなる。Claude Code はコンテキストを追って動くので、古い作業の断片が近くにあるほど、話がそれやすい。作業の境界をフォルダで切ると、指示の境界も切れる。

実務では、最後に一度だけ「掃除の時間」を入れておくといい。作業終了時に、work や tmp を見直し、残すべきものだけ archive に逃がし、あとは消す。これを毎回やる。後回しにすると、どれが要るのか分からなくなる。筆者は何度もそれで、不要な生成物を数百個まとめて抱え込んだ。削除は遅れるほど面倒になる。だから、作業の最後に片づける。これで十分だ。

Claude Code を使うなら、指示の最初と最後に「分離」と「削除」を入れるだけでかなり違う。最初に置き場所を決める。最後に不要物を捨てる。この二つを外さない。別作業の成果を混ぜない、とは結局そういうことだ。作業は進むのに、机の上だけが汚れていく状態を止める。そこを押さえれば、ファイル整理でも文書作成でも、ずっと扱いやすくなる。

関連 TIPS

同じ著者の記事