Claude Codeの長期記憶を外部化する設計術

AIエージェントの記憶を設計する

AIコーディングエージェントの利用が広がっている。AnthropicのClaude Codeは高い自律性を持つ。一方で、セッション終了時に記憶がリセットされる仕様がある。

プロジェクトの前提やAPIの仕様を毎回説明するコストが発生する。海外の開発者コミュニティでは、記憶をAI内部に閉じ込めない設計が採用されている。

AIエージェントを個別のツールから一貫したパイプラインへ昇格させる。長期記憶の外部化と実行環境の抽象化が鍵となる。

記憶と設定を外部化する3つのアプローチ

開発者はAIが働きやすいファイルシステムを構築している。3つのアプローチが統合されている。

第一に、MCP（Model Context Protocol）による記憶の外部化だ。過去の会話ログや決定事項を外部データベースに蓄積する。MCPサーバー経由でAIが必要な文脈を検索する。

第二に、設定ファイルの共通化だ。プロジェクトルートに共通の指示書を置く。AGENTS.mdという形式が標準的なREADMEとして利用されている。

第三に、処理の抽象化と命名規約によるパイプライン化だ。媒体ごとに異なるAPIやブラウザ操作の手順を共通の動詞で命名したスクリプトに隠蔽する。

しんたろー：
Claude Codeを操作していると、以前の指示を忘れる挙動が気になる。AIの内部記憶に頼らず、外部に脳の拡張パックを置く方が確実だ。記憶をファイルやDBに追い出すのは、ステートレスな設計に近い。

開発者目線で紐解くアーキテクチャ

AIエージェントを自律的に動く同僚として扱う。Claude Codeは起動時にCLAUDE.mdを読み込む。

AGENTS.mdをマスターデータとし、CLAUDE.mdからインポートする構成が推奨される。ツールを乗り換えてもAGENTS.mdの知見はそのまま利用できる。

複雑な自動化にはスキルの設計が不可欠だ。スキルとは特定のタスクを実行するための手順書とスクリプトのセットである。

命名規約が力を発揮する。すべての媒体でpublishという名前のスクリプトを用意する。AIは複雑な実装を意識せずにタスクを完遂する。

しんたろー：
AIにすべてを任せるとプロンプトが巨大化し、挙動が不安定になる。賢いAIにシンプルなインターフェースを与え、泥臭い処理はスクリプト側に押し込める。この役割分担がパイプライン量産の勝ち筋だ。

実務への影響

この設計術により、AIへの指示出しが説明から命令に変わる。AIは起動した瞬間にCLAUDE.md経由でAGENTS.mdを読み込み、役割を理解する。

タスクの再現性が担保される。外部化されたスキルや記憶により、AIは常に同じ基準でコードを書き、レビューを行う。

プロジェクトルートにAGENTS.mdを作成する。人間向けではなく、AIに向けた仕様書を記述する。Claude CodeのCLAUDE.mdからそのファイルをインポートする設定を加える。

過去の知見をMCPサーバーとして切り出す。ライブラリのTipsや社内ルールをデータベース化し、AIがいつでも引けるようにする。

しんたろー：
ThreadPostの開発で、共通の命名規約でスクリプトを整理した。Claude Codeが自律的に提案を行うようになった。AIが働きやすいファイル構造を整えることが重要だ。

FAQ

Q1: Claude Codeの記憶システムを構築する際、どこから始めるべき？

Toolの作成から始める。過去の会話やメモを検索して回答に含めるシンプルなMCPサーバーを1つ作り、Claude Codeに登録する。まずはAIが自分で過去ログを読める体験を作ることが重要だ。

Q2: AGENTS.mdとCLAUDE.md、どちらを優先すべき？

プロジェクト全体で複数のAIエージェントを併用する場合、AGENTS.mdをマスターとし、CLAUDE.mdからインポートする。Claude Code固有の設定が必要な場合のみCLAUDE.mdに記述する。

Q3: 複数のSNSやプラットフォームに同時投稿する際、APIがない媒体はどう扱うのが正解？

ブラウザ自動操作ツールの活用と、投稿後の検証フェーズの分離が鍵だ。ブラウザ操作の場合はDOMの状態を確認する検証を独立したステップとして定義する。やりっぱなしにさせない設計が不可欠だ。

まとめ

AIエージェントの運用は高度なアーキテクチャ設計の段階にある。記憶を外部化し、設定を共通化し、処理を抽象化する。この外部脳の構築が生産性を引き上げる。

AIを賢く使うのではなく、AIが賢く動ける環境を整える。この視点の切り替えがAI開発のスタンダードになる。

👉 ThreadPostでSNS運用を自動化する