Claude CodeでAIが知識を自律更新する仕組みと誤操作を防ぐGit管理術

SNS運用を自動化しませんか？

ThreadPostなら、投稿作成・画像生成・スケジュール管理まで全てAIにお任せ。

AIは毎回ゼロから始まる。それを終わらせる設計の話

セッションが切れるたびに、AIは何も知らない状態で戻ってくる。

昨日3時間かけて直したバグの原因も、なぜその設計にしたかも、まだ解決していない課題の一覧も消える。

これを解決しようとする設計がある。LLM Wikiというパターンと、Claude Code HooksとGit管理を組み合わせた設計だ。

71.5倍のトークン削減。2ヶ月の運用で浮かんだ知識腐敗の問題。800時間以上の自律運用データ。AIに自律性を与えながら、事故を防ぐ設計思想の話だ。

Claude Codeを毎日使っている身として、この設計を解説する。

LLM Wikiは、LLMが司書として機能し、自分の知識を構造化し続けるMarkdownデータベースだ。

従来のRAGとの違いはここにある。

約100記事を超えるとRAGよりコンパイル済みアプローチが優位になる。トークン削減は71.5倍だ。

システムの核心は2つの層で構成される。

LLMが自動生成・保守する層だ。ソースを取り込むたびに成長する。概念ページ・エンティティページ・ソースサマリーが格納される。

自分の声・トーン・ポジショニング・禁止表現を定義する。人間が主体的に管理し、LLMはここを読んでアウトプットのスタイルを合わせる。

外側に「raw/」という入力パイプラインがある。生ソースを放り込む場所だ。ここへのLLMの書き込みはHooksでブロックする。

ディレクトリ構成は以下の通りだ。

Claude CodeにはHooksという仕組みがある。ツール実行の前後にbashスクリプトを走らせて、実行をブロックできる機能だ。

「raw/への新規ファイル作成をブロックする」hookを書くと、LLMが誤ってrawに書き込もうとした瞬間に止まる。exit 2を返すと、Claude Codeはツールの実行を中止する。

例外がある。raw/内のファイルに「ingest済みかどうか」のフラグを書き込む必要があるため、新規作成はブロックしつつ、既存ファイルへの追記は許可する設計にする。

しんたろー：
CLAUDE.mdに禁止事項を書き連ねるより、Hooksで物理的にブロックする方が確実だ。CLAUDE.mdが短くなり、毎ターンのトークンも減る。信頼性も上がる。

長期記憶を実装しても、2ヶ月動かすと記憶の中身と現実が乖離し始める。

観測された問題は主に2つだ。

問題1: 未解決リストの肥大化

AIエージェントは作業の終わりに「次に調べるべきこと」を未解決リストに登録する。実装が終わっているのに「閉じました」と記録する手順を踏まなければ、リストには残り続ける。

問題2: AIが嘘の知識を書き込む

自由テキストのメモだけでは、「社内略称」「ベンダ正式名称」「バージョン違いの表記」「英語表記」が混在する。AIが社内略称でメモを書いたあと、正式名称で検索すると引けない。

これに対して足された機構が5つある。

括弧書きの正規化 — 重複排除キーから「（...）」を除去して、表記ゆれによる二重登録を防ぐ
Gitコミットフックによる自動クローズ — コミットメッセージに「resolves:キーワード」を含めると、コミット後フックが走って対応する未解決課題を自動で解決済みに更新する
知識保存時の類似度マッチ — 新しい知識を保存する際、未解決リスト全項目とタイトル類似度を比較して自動クローズ。Jaccard係数という手法を使う
毎朝の状態一覧にヒントを追加 — 自動削除はしない。判断は開発者に委ねて、ヒントとしてsurfaceする
Undoツール — 誤った上書きを1行で取り消せる仕組み

特にGitコミットフックの設計が機能する。AIを介さないセーフティネットとして機能するからだ。