試し書きのファイルに、いつのまにか本番用の文章や成果物まで混ざる。これ、かなり雑に見えて、あとでいちばん高くつくやつだ。下書きと確定版を分ける、成果物の置き場を分ける。Claude Code を使うなら、この線引きは最初にやっておいたほうがいい。
理由は単純で、Claude Code は「今見えているファイル群」を材料に作業するからだ。下書き、メモ、採用済み原稿、配布用の完成版が同じ場所にあると、参照も修正も曖昧になる。書類整理でもコードでも同じで、混ぜるほど事故る。筆者は一度、作業用フォルダに旧版のメモを残したまま頼みごとをして、戻し先がぐちゃぐちゃになったことがある。人間なら見分けられるが、雑な置き方をすると機械は平気で巻き込む。
まずやることは、置き場を物理的に分けることだ。名前でごまかさない。フォルダを分けるほうが早い。
project/
draft/
final/
references/
archive/
たとえば文章作成なら、draft/ に試し書き、final/ に確定版、references/ に参考資料、archive/ に古い版を入れる。ファイル名だけで区別しようとすると、すぐ限界が来る。proposal_latest_new2_final_reallyfinal.md みたいな地獄は、だいたいその前兆だ。
Claude Code に頼むときも、最初にこの分離を明示する。たとえば文章の清書なら、こんな指示が使える。
draft/ 以下の下書きだけを見て、final/ に確定版を作ってください。
draft/ の内容は直接変更しないでください。
final/ に置くのは完成稿だけにしてください。
参考資料は references/ にあります。必要なものだけ参照してください。
コードや設定ファイルなら、もっとはっきり書く。
src/ は本番用です。直接いじらないでください。
試作は sandbox/ に作ってください。
動作確認が終わったら、差分を見せてから本番用に反映してください。
この「反映前に差分を見せる」が大事だ。混ぜると、何を試しで何を採用したのか分からなくなる。diff が肥大化して、あとで見直す気力が死ぬ。筆者はここを雑にしたせいで、たった数行の修正のはずが、どれが本命か追跡するだけで時間を食った。Claude Code に限らず、作業の履歴が見える形になっていないと、人間の判断が鈍る。
実運用では、最初に「このフォルダでは何をしてよくて、何をしてはいけないか」を短く書いておくといい。長文のルールより、短い制約のほうが効く。
この作業では次のルールを守ってください。
- draft/ は作業中のみ
- final/ は確定版のみ
- archive/ は過去版の保管用
- 下書きと確定版を同じファイルに混ぜない
- 本番用ファイルの上書き前に、必ず確認を出す
非エンジニアなら、たとえばこういう使い方が合う。契約書のたたき台を draft/ に置き、提出版を final/ に置く。請求書の草案、案内文、議事録のメモも同じだ。試し書きと提出物を同じ場所に置くと、どれが送付済みでどれが未修正か分からなくなる。これは本当にだるい。ディスク整理でも、削除候補の一覧と残すべき資料を同じフォルダに入れないほうがいい。消していいものが見えなくなる。
少し進めるなら、作業前の依頼文に「成果物の置き場」を毎回書く癖をつけると安定する。
作業は scratch/ に試作を置き、完成したものだけ deliverables/ に出してください。
scratch/ の内容は最終成果物に含めないでください。
この一文があるだけで、Claude Code の出力先がぶれにくい。逆に、出力先を曖昧にしたまま「いい感じにして」と投げると、途中案が混ざる。人間でもそうだが、AI にもなおさら雑な指示は禁物だ。
注意したいのは、フォルダを分けただけで安心しないことだ。下書きと確定版を分けても、参照元が混ざっていれば事故る。古い下書きを final/ にコピーしてから、本番用のファイル名をそのまま残すのも危ない。見た目は整っていても、中身が試作品のままということがある。筆者はこれをやって、見た目だけ完成しているファイルを量産したことがある。いちばんまずいのは、ちゃんと終わった気になれる点だ。
だから、切り替えの合図を決めておくといい。たとえば「draft/ では自由にいじるが、final/ に入れる前に要約を確認する」「本番用に移す前に、差分とファイル名を見直す」。この手順を固定すると、Claude Code への頼み方も安定するし、あとから探す時間も減る。
下書きと確定版を分けるのは、きれいに見せるためではない。迷わないためだ。試し書きの分離、成果物の置き場を分ける。この3つを先に決めておけば、Claude Code はかなり扱いやすくなる。混ぜると楽そうに見えるが、後片づけで必ず痛い目を見る。