エージェントに必要なのは「メモリ」ではなく「ドキュメント」である

概要

AIエージェントの記憶をチャット履歴のベクトル検索（RAG）に頼るのではなく、エージェント自身が保守する構造化されたMarkdownドキュメントとして管理する手法を提案する記事。

詳細内容

現状のAIエージェントが採用している「メモリ」システムは、会話履歴を断片化してベクトルDBに保存し、類似度で抽出するRAG形式が主流だが、これには情報の劣化や文脈の欠如、メンテナンス性の低さという根本的な課題がある。筆者はこの解決策として、人間がチーム開発で記録を残すように、エージェントにも「ドキュメント（文書化）」を強制させるアプローチを提唱している。具体的には、設計意図や制約、決定事項をエージェント自身がMarkdownファイルとして記録・更新し、作業前にこれらを読み込むことで一貫性を保つ。この概念を具現化したOSSツール「Operator Memory」は、Gitによる履歴管理が可能で、特定のインフラに依存せず、開発者が容易に内容を監査・修正できるメリットがある。エージェントをより信頼できる協力者にするためには、記憶の想起（Recall）ではなく、構造化された知識管理（Documentation）こそが必要である。

元記事を読む