「さっき話したのに、なんで知らないの?」。AIを使って、ぼくがつまずいた情報の置き方
AIに仕事を頼むほど、話がかみ合わなくなった。AIが何を読んで返事をしているのか。非エンジニアのぼくが、エンジニアの久保さんに教わりながら、決まり・最新の情報・素材の置き方を見直した話。

AIに仕事を頼むことが増え、話がかみ合わなくなりはじめた。
「別のスレッドでは説明したのに、こちらのスレッドは知らないのか」。「その話は、今回の記事に入れるつもりじゃなかった」。文章も書ける。資料も作れる。それなのに、仕事が増えるほど、前提のズレがひどくなり始めた。
ぼくが分かっていなかったのは、AIが何を読んで、その返事をしているのか、ということだった。
ぼくはエンジニアではない。たまったデータファイルのフォルダを分けることは知っている。しかし、その置き方がAIの仕事にどう関係するのかは、理解していなかった。
作業が少ないうちは、なんとなく成立していた。会話や資料が増えれば増えるほどに、うまくいかなくなる。「その話はもう決まったはずだ」「どうして前の条件で進めるんだ」となる。
Claudeを使い始めて3か月が過ぎた8月ころに、ようやく仕組みが分かり始めた。本記事を書いている10月のいまも、情報の置き方を見直している。
久保さんにDiscordで相談した。会話をどう分けるか。最初にどのファイルを読ませるか。
久保さんは、それを「1つの会話で、どこまでの情報を参照するのか」という問題として説明してくれた。AIが返事をするときに使う、指示や会話、資料などの前提を「コンテキスト」と呼ぶ。
前の会話で伝えたことが、新しい会話に全部引き継がれるとは限らない。逆に、今回使うつもりのない情報が、参照する資料や会話の中に残っていることもある。「同じAIだから、全部知っているはず」と考えると、ここでずれる。
作成中の資料に、途中から別の地域の話が出てきた。久保さんから、ほかの文脈を拾っている可能性と、フォルダ構成を見直す提案があった。
ぼくも確かめて、別の案件の情報が混ざっていることに気づいた。文章を直すだけでは足りない。何を材料に書かせたのか、そこから確かめる必要があった。
AIが持っている情報と、今回の記事に使ってよい情報。その区別を、こちらから伝えなければいけなかった。

当時のぼくは、AIとの会話に役割を与え、会社のような組織にしていた。経営本部があり、事業の担当があり、その下に案件ごとの会話がある。
自分では整理できているつもりだった。けれど、会話に名前や役職を付けることと、その会話が必要な情報を受け取れることは、別の話だった。
久保さんが提案してくれたのは、決まったことを文書に残し、その文書を常に最新にしておく方法だった。新しい会話を始めたら、そこを読む。長い会話の中から、毎回決定事項を探させずに済む。
この話で出てきたのが、「ディレクトリ」や「.md」という言葉だった。
ディレクトリは、ここではフォルダのこと。仕事のフォルダの中に案件のフォルダがあり、その中に資料が入っている。
「.md」は、Markdownという書き方の文章ファイルに付く拡張子だ。見出しや箇条書きを、文字と簡単な記号で書ける。プログラムを書かなくても、仕事の目的や決定事項を残せる。
ただし、「.mdにしたらAIが自動で覚える」わけではない。保存することと、今回の作業で読ませることは、別だ。
ここからは、ぼくが使っているClaude Codeでの話だ。
Claude Codeには、「CLAUDE.md」という名前のファイルから指示を読み込む仕組みがある。作業を始めるフォルダと、その上の階層にある指示が、読み込まれる。
だから、「何という会話名にしたか」だけでなく、「どのフォルダを作業場所として始めたか」が効いてくる。
上の階層には、仕事全体で共通する決まりを書く。案件の詳しい条件は、その案件の資料に置く。全体の指示に1つの案件の事情を詰め込むと、ほかの仕事にも不要な前提を渡してしまう。
久保さんの提案を、初心者向けに小さくすると、こんな形になる。

いちばん上の「仕事」のフォルダに、全案件で共通する決まりを書いたCLAUDE.mdを置く。「未確認の数字は断定しない」といったものだ。
その下の「案件A」のフォルダにも、CLAUDE.mdを置く。この案件で最初に読む資料と、作業の進め方を書く。「作業の前にdocsの現況.mdと仕様.mdを読む」という指示も、ここだ。
docsは、文書を置くフォルダ。現況.mdには、いま決まっていること、保留していること、次にすることを書く。仕様.mdには、作るものの条件をまとめる。
そのほかに、「素材」と「過去の記録」を分ける。素材には、打ち合わせのメモや参考資料。まだ採用していない案もここに入る。過去の記録には、以前の条件や経緯を残す。
案件Aのフォルダで会話を始めるなら、最初の指示も具体的にする。
「まずdocs/現況.mdとdocs/仕様.mdを読んでください。今回の作業は案件Aの提案書です。資料が食い違う場合や、情報が足りない場合は、書き始める前に知らせてください。ほかの案件の情報は使わないでください」
読んだファイル名と、理解した前提を短く返してもらう。自分の考えと違っていれば、作り始める前に直せる。
仕事の途中で条件が変わったら、会話の中で了解して終わらせず、文書にも反映する。ChatGPTや別のAIに頼むときも、決定事項を必要な範囲で渡す。別のAIが自動的に知っているとは考えない。
ぼくはいま、久保さんの提案を取り入れて、この形への見直しを進めている。すべて整理し終えた、という話ではない。
次に話がかみ合わなくなったら、まず、どの資料を読んだのかを確かめたい。今回の仕事に必要な情報か。いまも有効な条件か。別の会話で決めたことを、まだ渡していないのか。
「さっき言っただろう」で済ませていたところに、確かめることがあった。非エンジニアのぼくが、そのことを理解するまでには、思ったより時間がかかった。

