T54_AIが迷わない作業環境は、使った日に決まる

使うほど、AIが迷わず動ける作業環境を先に作っておきたい。

そう考えて、すべてのフォルダに AGENTS.md を置く相談を Claude Code に持ちかけました。
その初日に返ってきたのが、この一言です。

形を整えれば、AIは迷わない。
その見立ては、相談を始めたその日にひっくり返りました。
この記事は、そこから1週間で作業環境の設計を組み替えた記録です。

全フォルダに AGENTS.md を置けば済む、と思っていた

きっかけは、パーソナルエージェントとナレッジベースを扱った動画のまとめを読んだことでした。
どのフォルダを開いても同じ構成で、入口に AGENTS.md（AIが最初に読む指示書）がある。
その形に揃えておけば、AIは迷わず動けるはずだと考えました。

Claude と1問ずつ相談しながら、各フォルダに共通させる層を決めていきました。

• 01_facts：事実の置き場。「同窓会の仕事の前提」のように、次の案件でもAIに知っておいてほしいことを置く

• 02_raw：原本。上書きしない

• 03_output：案件ごとの成果物

ここまでで、形はほぼ完成です。
でも Claude は、この形のまま運用すると何が起きるかを先に指摘しました。
作業の途中で分かった事実は、その案件のフォルダに埋もれていく。
次の案件で、AIはまたゼロから聞いてくる、と。

職員室でいえば、引き継ぎメモが前任者の机の引き出しに入ったままの状態です。
メモはあるのに、新しい担当者は引き出しを開けず、同じことを聞いて回る。

AIは新しい案件を始めるとき、過去の案件フォルダを1つずつ開いて読み返したりはしません。
読むのは、入口の AGENTS.md と、そこで「読め」と指示されたものだけです。
だから AGENTS.md に「まず 01_facts を読む」と書き、案件を閉じるたびに次も使う事実を1枚だけ抜き出して置く。
これで、AIは毎回そこから読み始め、同じことを聞かなくなります。

「事実の置き場」は、書き換え続ける場所だった

名前を決める途中で、もう1つ思い込みを訂正されています。
私は「ファクトだともう動かないってことだもんね」と言いました。
Claude の答えは逆でした。
動かないのは原本を置く 02_raw のほうで、事実の置き場は更新され続ける場所だ、と。

事実を「凍結したもの」と捉えると、誰も書き換えなくなります。
古い事実のままAIが動く。これが事実の置き場が死ぬいちばん多いパターンだ、と言われました。

迷わない構造を決めるのは、フォルダの並びではなく、事実が戻ってくる流れのほうです。
その日の終わりには、私のほうから「作業していく中で、自然とフォルダの中が育つ工夫はないか」と聞き直していました。

事実を戻す先は、ツール別ではなく仕事別に

数日後、もう1つ見直したのが作業フォルダの分け方です。
それまで私は、作業フォルダを AI のツールごとに分けていました。Claude Code 用、Codex 用、という分け方です。

Codex 用フォルダには、事実の置き場を作る前にこなした案件が16件たまっていました。
Claude Code 用のほうには事実が1本だけあり、中身は同窓会の仕事の前提。
仕事の事実が、ツールの名前のフォルダに入っていたのです。

これから事実を01_factsへ戻していくとして、ツール別のままでは同窓会の事実と数学の事実が同じ置き場に混ざります。
関係ない話を毎回読むか、誰も書かなくなるか。どちらに転んでも、置き場は育ちません。

そこで、作業フォルダをツール別から仕事別に組み替えました。
同窓会の仕事なら同窓会のフォルダへ。案件を閉じるとき、事実を戻す先が1つに決まります。
ただし Claude は、フォルダを分けるだけでは足りないとも言っていました。
良くなるのは、戻す流れが毎回回るからです。

あなたのAI用フォルダで、最後に「次も使う事実」が書き足されたのは、いつですか？

最後に足したのは「戻り道」

各フォルダの事実の置き場とは別に、私には「61番」と呼んでいるフォルダがあります。
AIと私が共通で読む、考え方の正本を置いた場所です。
各フォルダやスキルは、必要な考え方をここから取り込んで使います。
週1のログ作成と月1の知見抽出を定期タスクにして、61番を育てる仕組みも動かしました。

それでも、穴が1つ残っていました。
作業の現場で61番の考え方を改めても、それを61番へ戻す道がありません。
実装を終えたその日だけで、61番の考え方を更新する判断が3件生まれていました。
取り込むだけの一方向の流れでは、現場で賢くなった分が61番に戻らず、61番のほうが古くなっていきます。

そこで「還流」を足しました。仕組みは二段構えです。

• その場で：作業側の指示書に「61番へ書き戻しを提案する」を1行足す

• 漏れた分：月1の知見抽出で、61番のどの文書が古くなったかを照合する

1行のルールは、書いても実行されないことがあります。月1の照合は、最大1か月遅れます。
弱点の違う2つを重ねて、戻り道が途切れないようにしました。
これで、上から下へ流れるだけだった構造が、循環する構造に変わりました。

AGENTS.md を置いた日には、まだ何も決まっていない

最初に掲げた目的の文面は、こうです。

相談を始めた頃に見ていたのは、前半だけでした。全部のフォルダに AGENTS.md を置き、同じ形に揃える。
でも1週間かけて組み替えたのは、ほとんどが後半の「育てる」のほうです。

この記事を書いているフォルダの AGENTS.md にも、初日に決めた仕組みが1行入っています。
「ユーザーに確認したことは、答えを得た時点で事実の置き場への追記候補として出す」。
AIが私に質問したということは、その情報がまだ置き場に無かったということだからです。

AIが迷わないかどうかは、整えた日には決まりません。
使うたびに事実が1つ戻ってくる、その積み重ねで決まっていきます。

人生の限りある時間を大切に。シンパクト和 でした。
最後までお読みいただき、ありがとうございます。
スキやコメントをいただけると励みになります。