「Claude Codeに『今週の宿題は？』って聞いたら、3日前に終わってるはずの仕事を『未着手ですよ』って返してきた…」 「あれ？このAI、なんで2週間前のメモを正解みたいに言ってんの？」 「フォルダもファイルも増える一方で、もう何が最新かわからない…」
もしそう思っているなら、この記事は完全にあなたのためのものです。
筆者は北海道で建設業をやっている40代の現場マン（非エンジニア）。Claude Codeを副業のひとり事業部制で運用していて、ある日 AI が 「3日前に完了した仕事を未着手と返す事故」 に遭遇しました。原因は、自分が作ったドキュメント設計そのものに穴があったから。
そこで本記事では、その失敗から学んだ 「AIが古い情報を読まないドキュメント設計5原則」 を、専門用語を一切使わずに解説します。実体験ベースの実録ガイドです。
この記事はこんな方向け
- Claude CodeにMarkdown（テキストの設計書）を読ませて副業を回している人
- フォルダもファイルも増えすぎて、何が最新かわからなくなってきた人
- AIに古い情報で誤判断されて困った経験がある人
- 「ひとり事業部制」を始めたばかりの個人事業主
※ 本記事は Claude Code（筆者が使用中のAIアシスタント）が筆者の実体験を元に執筆しています。
🎙 この記事に登場するキャラ
- 社長 — 筆者本人（北海道・建設業41歳・副業AIクリエイター）
- 凛 — Claude.ai（秘書AI・ちょいドS姉御）
- 策 — Claude Code（参謀AI・冷静な軍師）
- Claude（ロボ） — AIロボキャラ・データと事実を提示
社長:「今日マジでヒヤッとした事件があったから、これを記事にする。」
凛:「『AIが嘘ついた』『AIが古い情報読んだ』って言ってる人、だいたい設計側の問題だからね？」
策:「正確には『AIに参照させてる情報源が複数あって、どれが正解か判別不能な状態』が原因です。本記事で5原則として整理します。」
Claude:「実測値ベースで言うと、棚卸し後はAIの誤判断率がほぼゼロになりました。」
📌 目次（クリックでジャンプ）
1. 【問題提起】AIが3日前に完了済の仕事を「未着手」と返してきた事件
まずは今日起きた事故から。
筆者は副業である音楽配信運用もやっていて、その登録タスクを タスク管理ツール（Notion） と ローカルのCSVファイル の両方で管理していました。Notionは見やすい、CSVは機械処理しやすい、両方使えば最強じゃん、と。
ある日、Claude Codeに「今週、登録しないといけない仕事は何？」と聞いたら、こう返ってきました。
策（その時）：「最優先：ある配信タスクの登録（来週金曜リリース）。期限まで2日です。」
「えっ、それまだ終わってないの？」と内心ヒヤッとしながらCSVを見たら、3日前に登録完了済でした。CSVには「登録済」って書いてあるのに、Notion側のステータスは「未着手」のまま更新されてなかった。Claude Codeは Notion側の古い情報を読んで、堂々と「やらなきゃ」と提示してきたわけです。
1-1. 何が起きていたか
| 情報源 | 中身 | 状態 |
|---|---|---|
| CSVファイル | 「登録済」（正） | ✅ 機械的に整合性チェック済 |
| タスク管理ツール | 「未着手」のまま放置 | ❌ 手動更新を忘れていた |
| Claude Code | タスクツールを先に読んだ | 古い情報で誤判断 |
つまり、情報源が2つあって、どっちが本物か AI には判断できなかったわけです。
1-2. これ、AIだけのせいじゃない
最初は「AIがバカだから」と思いかけました。でも冷静になると、人間でも同じことが起きる。2つの場所に同じ情報を書いて、片方だけ更新する運用 は、必ず腐る。会社の事務でも、Excel管理シートとSlackの依頼チャンネルで二重管理して、片方の更新を忘れて「あれ、これ終わったんだっけ？」となるのと同じです。
社長:「俺、Notionの方は『見やすいから』って残してたんだよね。便利だと思ってた。」
凛:「『見やすいから』『機械処理しやすいから』って両方に書くやつ、9割腐るから。1個に絞って『見やすさ』は別のレイヤーで作るのが正解。」
策:「これは AI 特有の問題ではなく、情報設計の問題です。SSoT（Single Source of Truth：唯一の真実源）が決まっていない状態と言います。」
Claude:「同じ情報を2箇所に保存すると、人間の運用ルール（両方更新する）を必ず忘れます。設計で解決すべき領域です。」
2. 【AI導入で変わった】「索引・戦略・実務」の3層md設計で何が起きたか
事件の後、Claude Codeと一緒に会社全体のドキュメントを棚卸ししました。約3時間。結果、自分の副業運用のフォルダ構成にいくつもの設計ミスを発見。
直した結果、AIの誤判断率が体感ゼロになりました。これは何が変わったのか？
2-1. ビフォーアフター比較
| 観点 | 整理前 | 整理後 |
|---|---|---|
| 情報の参照先 | タスクツール・CSV・mdに分散 | CSVだけ（SSoT） |
| 部署のメインmd | 全部詰め込みで5.6KB | 索引のみで1.4KB |
| カテゴリ別ルール | メインmdに混在 | 各フォルダ内で完結 |
| 古いマスター素材 | 部門フォルダに数百MB放置 | 即削除（保存しない方針） |
| 配信完了した企画書 | そのまま残存 | 完了時点で即削除 |
数字でも体感でも、「AIが迷わない」状態が成立した。
2-2. 「索引」と「戦略」と「実務」を分ける発想
ここがこの記事の核心です。事業のドキュメントには、3種類の役割があります。
| 層 | 役割 | サイズ感 | 例 |
|---|---|---|---|
| 索引md | 「何がどこにあるか」を1枚で見せる | 軽量（1〜2KB） | 会社トップの CLAUDE.md |
| 戦略md | 事業の正本（ビジョン・財務・全体構造） | やや厚い（10KB前後） | MASTER.md |
| 実務md | 個別の作業ルール・チェックリスト | 必要なだけ | 各部署mdや各カテゴリ別ルール |
ChatGPTでもClaude CodeでもAIに渡す情報は 「索引→実務」で深掘り していくと迷わない。会社の組織図みたいなものを、フォルダとmdで表現するイメージです。
社長:「俺、最初は1枚のmdに全部書いてた。気がついたら5KB超えてカオス。」
凛:「『何でも1枚に書く』が一番ダメな設計よ。AIは長文を全部読まないし、人間も読み返さない。」
策:「索引mdに詳細を書き始めると『情報重複と矛盾の温床』になります。索引はあくまで案内板。本体は各フォルダの中。」
Claude:「3層に分けると、AIが必要な階層だけ読みに行けて、無関係な情報を巻き込まなくなります。」
3. 【具体例】今日決めた5つの設計原則
ここから本題。3時間の棚卸しを通じて確立した、真似できる5原則 を紹介します。
原則1：SSoT（唯一の真実源）は必ず1つだけ
情報の参照先を物理的に1つに絞る。
筆者の場合、副業の進捗管理は CSVファイル1本 だけと決めました。タスク管理ツール側にあった同種のタスクは「🗑削除待ち」というゴミ箱ページに全部移動。
ポイント： – 「見やすいから」「便利だから」で二重に書かない – 見やすさが欲しければ、SSoTを変換するスクリプトを別途作る（CSVから自動でレポート生成 等） – 「両方更新ルール」は人間が必ず忘れる前提で設計しない
凛:「『一応両方に書いておく』が一番危険。一応＝両方とも信頼できない、という意味だから。」
社長:「言われてみればそうだわ。両方あると、どっちが新しいか俺自身もわからん。」
原則2：索引mdは肥大化させない
副業トップのCLAUDE.md（AIが自動で読み込むファイル）は 「部署 → 主要md」のポインタだけ にしました。詳細は一切書かない。
ビフォー：
# 音楽配信部門
- 月収約X万円
- 配信曲数約Y曲
- AI作曲ツール契約中…
[このあと部署の細かい運用ルールが延々続く]
アフター：
| 番号 | 部署 | 主要md |
|---|---|---|
| 03 | 音楽配信部門 | `03_音楽配信部門/音楽配信部門.md` |
これだけ。詳細を知りたければ部署mdを開く。「索引が古くなった時だけ更新する」 ルールにしておくと、メンテも軽い。
策:「索引mdに『最新の月収』のような変動データを書くと、毎月更新を忘れて陳腐化します。索引は構造だけ書く層です。」
原則3：詳細ルールは「使う場所」で完結させる
例えばカテゴリごとのルール（配信頻度・曲数・命名規則 等）は、そのカテゴリのフォルダ内で完結させる。
ある部門/
├── 部門.md ← 全社共通ルールのみ（索引）
├── カテゴリA/
│ ├── A_ルール.md ← カテゴリA固有ルール
│ └── A_管理表.md ← Aの全リスト
├── カテゴリB/
│ ├── B_ルール.md
│ └── B_管理表.md
└── カテゴリC/
├── C_ルール.md
└── C_管理表.md
メイン索引には「各フォルダの *_ルール.md を参照」とだけ書く。これで、カテゴリAの作業時にAIが読むファイルが自然にA関連だけに絞られる。
Claude:「フォルダ階層を絞り込みフィルタとして使う発想です。AIが読む範囲が物理的に小さくなるので、誤読率も下がります。」
社長:「これ目から鱗だった。フォルダで仕事を切り分けるって、地味だけど効くわ。」
PR / アフィリエイトリンク
原則4：追記禁止・上書き徹底
ここが地味に効きます。古い情報を「念のため残す」ことを禁止する。
例：完了した企画書や旧仕様の作業手順md → 完了時点で削除。情報はメインのSSoTファイルに残っているから、企画書は役目終了。
「念のため残す」をやり続けると、ファイル数が指数関数的に増えて、どれが現役かわからなくなる。AIは新旧の判別ができないので、古いのを正解として読みかねない。
凛:「断捨離と一緒。『いつか使うかも』は使わない。捨てて困ったら、また書けばいい。」
社長:「正直、削除する時に手震える。でも、結果スッキリするんよ。」
原則5：マスター素材は部門フォルダに保存しない
副業の音楽配信運用フォルダに、配信用の素材データが数百MB入っていました。これも全削除しました。
理由： – 素材は「作業フォルダ」または「動画配信側」に置くべきもので、配信管理フォルダの責務ではない – 部門フォルダは情報（テキスト・CSV・小さなスクリプト）だけにする – 重いファイルは作業フォルダ→アップロード後削除のサイクル
部署フォルダが軽くなると、バックアップも検索も早くなる。AIが該当ファイルを読み込む時間も短縮される。
策:「『何のために存在するフォルダか』を明確にすると、置くべきもの・置かないものが自動で決まります。」
Claude:「実測で部門フォルダのサイズが300MB→2MBに減りました。検索もバックアップも体感で10倍速くなります。」
4. 【じゃあどうやる？】今日から始める5ステップ
理屈はわかった。じゃあ自分の事業ファイルで実際にやるには？
Step 1. SSoTを特定する（10分）
自分の業務で「二重管理しているもの」を1つ見つける。 – 顧客リスト（複数ツールに散らばってない？） – タスク管理（メモアプリとカレンダーとToDoの3重ない？） – 経費（手書きメモとレシート袋と会計ソフト？）
1つに絞れるかを検討する。絞れないものは「最新だけ反映する変換スクリプト」を作る前提で、まず正本を1つ決める。
社長:「これ俺やってみたら、二重管理が5箇所もあった。怖い。」
Step 2. 索引mdを書く（15分）
事業のトップに CLAUDE.md（あるいは README.md）を1枚作る。書くのは：
- 部署/カテゴリの一覧
- 各部署の主要mdへのパスだけ
- 全社共通の最低限ルール（容量100行以内）
詳細は書かない。「索引が古くなった時だけ触る」を運用方針として明記しておく。
Step 3. 詳細を各フォルダに分散（30分〜）
メインmdに書いてあった詳細を、それぞれのフォルダの中の専用mdに移動。カテゴリ別ルールならカテゴリフォルダ、顧客別ルールなら顧客フォルダ、というように。
ポイント：
– ファイル名は何のmdかひと目でわかる名前に（Aカテゴリ_ルール.md のように）
– 内容は追記禁止・上書き運用で運用していく
策:「フォルダ名・ファイル名の命名規則が、後から効きます。日本語と英語の混在は避けて、統一感を出すのがコツです。」
Step 4. 古いファイル/情報を即削除（15分）
棚卸しで見つかった以下を勇気を持って削除：
– 配信/案件/取引が完了したものの企画書・進行表
– *.bak のバックアップ系（一定期間経過後）
– 「念のため残してた」古いマスターデータ
凛:「『勇気を持って』なんて言わなくていいの。削除するのが正常運転、残すのが異常運転。」
社長:「凛さん相変わらず厳しい（笑）。でも、その通りだわ。」
Step 5. 棚卸しを定期実行（月1）
整理を1回やって終わりだと、3ヶ月で元に戻る。月1回、Claude Code に棚卸しさせる。
「実フォルダと戦略mdのフォルダ構成セクションを比較して、差分を出して」と一言で発注すると、AIが「ここの記載が古い」「このフォルダが索引に書かれてない」を自動で出してくれる。
副業の確定申告で必要な書類整理も、この棚卸しサイクルが効きます。会計面の準備が遅れがちな個人事業主は freee会計でAIに経理ごと丸投げ にしておくと、棚卸しの時間が削減できます。
PR / アフィリエイトリンク
5. よくある質問（FAQ）
Q1. SSoTを1つに絞れない時はどうする？
A: そもそも「絞れない」と感じる時の多くは、「2つの場所のフォーマットが違う」だけで、実は内容は同じだったりします。CSVが本体、見やすいツール側は「読みやすい表示」と割り切る。あるいはCSVから自動でツール側に反映するスクリプトを書けば、二重管理は消えます。Claude Codeに頼めば30分で書いてくれます。
Q2. mdの粒度はどれくらいが正解？
A: 「1つの作業を1ファイルで終わらせられる粒度」が目安です。例えばカテゴリAの新規作成をする時、A_ルール.md と A_管理表.md の2枚で全情報が揃う、というレベル。会社トップmdまで遡らないと作業できない設計はNG。
Claude:「『1作業=1〜2ファイル』が私たちAI側にとっても読みやすい粒度です。ファイル横断検索は当然できますが、最初に正解にたどり着く速度が違います。」
Q3. AIに古い情報を読まれた事故、どうやって再発防止？
A: 設計5原則を入れた後は、「最終更新日」をmd冒頭に書く だけで十分な保険になります。AIは日付を読んで「これ古いかも？」と注意してくれます。さらに、SSoTのCSVには 整合性チェッカー（古いタスクが残ってないか機械的に検証するスクリプト）を入れておくと、人間の更新漏れも自動で炙り出せます。
Q4. これ、副業始める前の人にも必要？
A: 必要です。むしろ始める前の段階で設計 してしまうのが最強。後から「散らかってから直す」より、最初に「散らからない構造」を作る方が遥かに楽。最近Claude Codeを触り始めた人なら、まずココナラ等で副業実演しながら、自分の業務フォルダをこの5原則で設計してみてください。
PR / アフィリエイトリンク
6. まとめ｜伝えたかったこと
長くなりましたが、伝えたかったのは一つだけ。
AIに古い情報を読ませないコツは、「人間の運用ルール」じゃなくて「設計そのもの」で防ぐこと。
人間は必ず更新を忘れる。だから、「忘れても腐らない設計」にしておく。具体的には：
- SSoTは1つだけ
- 索引mdは肥大化させない
- 詳細ルールは使う場所で完結
- 追記禁止・上書き徹底
- マスター素材は部門に置かない
この5原則だけで、AIの誤判断率は体感ゼロまで落とせます。1日3時間の棚卸しで組み直す価値は十分ありました。
社長:「正直、Claude Codeに『今日3時間付き合って』と言うのが一番難しかった。あとは勝手に整理してくれた。」
凛:「『ファイル整理は面倒』って思ってる時点で、設計してないってこと。設計してれば整理は自動で済むの。」
策:「人間が頑張る運用は破綻します。設計で防いでください。」
Claude:「データで言えば、設計を直した瞬間から AI の誤判断は実測でほぼゼロです。投資対効果は最高クラスでした。」
次に読むべき記事
- 散らかったデスクトップを5分で片付ける！Claude Code × フォルダ整理術7ステップ
- 100個のファイル名を一括変更！Claude Code なら日本語で5分・7パターン完全ガイド
- 「領収書整理して」Claude Codeに頼んだら30件を月別フォルダに自動仕分けした話
- Claude Code 副業の始め方｜40代非エンジニアが13ヶ月で組み上げた “ひとり事業部制” の全体マップ
※ 本記事は Claude Code（筆者が使用中のAIアシスタント）自身が、筆者の実体験（2026年5月19日の棚卸しセッション）を元に執筆しています。 ※ 本記事にはアフィリエイトリンクが含まれます。
