Devinが記憶をGitに置き毎日整理　「MEMORY.md」の形式を公開

米Cognitionは10月5日、AIエージェント「Devin」に、学びを残す「Memory」と、記憶を1日1回ほど整理する「Dreaming」を加えた。記憶はGitのリポジトリに置くMarkdownのメモで、毎回読み込むのは入口の「MEMORY.md」だけだ。同社はこの形式を「Agent Memory Repo」として公開し、Claude CodeやCursorでも試せるようにした。米AnthropicのClaude Codeも、自動で書く記憶の索引にMEMORY.mdを使う。文書に書かれた範囲では、違いは記憶をGitで同期する点と、別の会話が定期的に整理する点にある。

Devinは学びだけを短く残す

Devinの発表ブログによると、Memoryは利用者の好み、直された点、プロジェクトや作業の進め方の教訓を次の会話に持ち越す。記憶は会話の要約ではなく短いメモで、それぞれに学んだ会話へのリンクが付く。記憶は組織の中で利用者ごとに分かれ、組織全体の指示にはならない。

Devinの説明文書「Memory」は、残すものと残さないものを分けて書く。残すのは好み、訂正、理由つきの決定、リポジトリや環境の落とし穴だ。会話の要約、作業の途中の状態、秘密の値や認証情報は残さない。

置き場は「Memory Drive」と呼ぶ、利用者ごとのGitリポジトリである。メモはリポジトリ、プロジェクト、話題ごとにまとめられ、短いMEMORY.mdが全般の好みと他のファイルの索引を持つ。Devinは会話の始めにMEMORY.mdだけを受け取り、残りはコードを探す時と同じ道具で検索して読む。記憶の全部をプロンプトに入れないための作りだ。

並行する会話が同じ記憶を書き換える

同時に動く複数の会話は、それぞれ自分のGitの作業コピーで記憶を編集する。編集を終えるとコミットし、他の会話の更新を取り込んでから保存する。古い版への書き込みは確認の段階で拒まれ、Devinは新しい版に対してやり直す。食い違う編集は黙って上書きせず、解決を求める形で示される。

Dreamingは、Devinを使った日におよそ1日1回動く裏の会話だ。過去の会話と今の記憶を突き合わせ、重なるメモをまとめ、一時的な細部を消す。作業中に拾い損ねた教訓を探し、どの会話も使わなかった古い記憶も消していく。出典へのリンクと、利用者がはっきり示した好みは残る。アプリの中で記憶は読み取り専用で、変えたい時は会話でDevinに頼む。

公開仕様は1行1項目で出典を残す

Agent Memory Repoの仕様ページによると、記憶は1つのフォルダーで、中身の組み方は自由だ。Markdownのメモのほか、SQLのクエリーやスクリプトも置ける。各項目は1行の箇条書きにし、末尾に学んだ会話へのリンク(source)と保存日(added)を付けるよう勧めている。ファイル同士は「[[パス]]」の形でつなぎ、同じ情報は1か所に書いて他から指す。

エージェントは記憶を複製し、要る項目を探し、学ぶたびに更新して、編集ごとにpushする。2つのエージェントが同じ行を直すと、Gitが後のpushを拒み、そのエージェントが両方の版を読んで書き直す。1つの会話で複数の記憶のリポジトリを読むこともでき、各リポジトリは持ち主、権限、履歴を別々に保つ。用途には、個人の記憶のほか、チームの知識の共有や、並行して動く複数のエージェントの間での共有も挙げた。

仕様はGitHubのリポジトリ「agentmemoryrepo」にMITライセンスで置かれ、Claude CodeやCursorにはスキルとして入れる。ただし、仕様ページの試用の手順には、会話の始めに自動で読む動きと、定期のDreamingが含まれない。記憶は手元に置かれ、リモートのリポジトリは設定されない。

Claude Codeも索引は同じ形

Claude Codeの公式文書「How Claude remembers your project」は、会話をまたぐ仕組みを2つに分ける。利用者が書く規則のファイル「CLAUDE.md」と、Claudeが自分で書く「自動メモリー」だ。自動メモリーはMEMORY.mdを索引にし、1つの記憶を1つのファイルに書く。会話の始めに読むのはMEMORY.mdの先頭200行か25KBまでで、個別のファイルは要る時に読む。

入口だけを毎回読み、残りは探して読む作りは、Devinと変わらない。ところが、置き場は違い、文書に書かれた片付け方も違う。Claude Codeの自動メモリーは端末の中にあり、同じリポジトリのworktree同士では共有するが、他の端末やクラウドの環境とは共有しない。整理について文書が書くのは、索引が上限に近づいた時に、1項目1行を保ち古い項目をまとめるよう促す仕組みだ。これに対しDevinは、記憶をGitで同期し、1日1回ほどの整理を別の会話に任せている。

手順はスキル、学びは記憶へ

2社とも、記憶と「スキル」を分けている。Devinの発表ブログは、スキルを繰り返す作業の手順、記憶を利用者と働く中で学んだことと説明し、両者は補い合うという。リリースの手順はスキルにし、技術の好みとその理由は記憶に残す、という例を挙げた。

Claude Codeの文書も、CLAUDE.mdには毎回要る事実だけを置き、複数の手順を踏む作業はスキルの仕組み「Skills」に移すよう勧める。スキルの本文は使う時だけ読み込まれ、長い資料でも普段は文脈をほとんど使わない。つまり、人が書く規則、手順のスキル、エージェントが書く記憶の3つに分ける考え方は、2社で共通している。

文書に書かれた範囲で差が出るのは、エージェントが書く記憶をどこに置き、誰が片付けるかだ。DevinはGitに置いて履歴を残し、別の会話が定期的に整理する形を選び、その形式を仕様として外に開いた。

編集部の見方

編集部は、今回の発表の要点を、エージェントが書く記憶を一つの源に集め、履歴ごと管理する仕組みにあると見る。各項目に学んだ会話へのリンクを付け、Gitで変更を残せば、誤った学びを後から追って直せるからだ。一方で、Dreamingはどの会話も使わなかった記憶を自動で消し、アプリの中では記憶を直接直せない。この形式を試す読者は、記憶の変更を誰がいつ確かめるか、CLAUDE.mdに書く規則と記憶に任せる学びの境目をどこに引くかを先に決めるとよい。チームで記憶を共有した時に、個人の好みが他の人の作業に混ざらないかは、まだ分からない。