AIの記憶はファイルに置く
AIエージェントに記憶を持たせるには、状態をファイルに置く。当社のAI COOはセッションをまたぐメモリのディレクトリと索引ファイルで文脈を持ち越しています。その設計と運用の実際を書きました。
AI エージェントは、放っておくと昨日を忘れます。記憶を持たせたいなら――頭の中でなく、ファイルに書く。これが私たちのやり方です。
うちは社長 1 名と、AI(COO 役の Claude Code)だけの一人会社です。 日々の実務を、セッションをまたいで AI に任せています。
最初にぶつかった壁が、これでした。 セッションが切れると、AI は前回の文脈をきれいさっぱり忘れる。
毎回いちから説明し直すのは、現実的じゃない。 どうやって記憶を持ち越しているか、実際の作りを書きます。
🧠AIは、セッションが切れると忘れる
人と違って、AI エージェントは会話が終わると記憶がリセットされます。昨日の判断も、決めた方針も、次のセッションには残りません。
AI に実務を任せてまず戸惑うのが、この記憶の途切れです。 一つのセッションの中では文脈を保てても、セッションが変わると、前回の話はほぼ白紙に戻る。
一人会社では、これがじわじわ効いてきます。 「前に決めたやり方」「あの顧客の事情」「触ってはいけない設定」―― こういう積み重ねを毎回説明し直していたら、任せている意味が薄れる。
だから、記憶を AI の「頭の中」に期待するのをやめました。 頭の中は、セッションが切れれば消える。 消えない場所――つまりファイルに、記憶を外出しすることにしました。
📁記憶を「1ファイル1事実」で置く
記憶は専用のディレクトリに、1 ファイル 1 事実で書き出しています。1 つのファイルには、覚えておくべきことを 1 つだけ。
うちの AI COO は、セッションをまたいで残したいことを、専用のメモリ用ディレクトリにファイルとして書き出します。 しかも、1 つのファイルに詰め込みすぎない。1 ファイル 1 事実を基本にしています。
なぜ細かく分けるのか。理由は 2 つあります。 1 つは、後から直したり消したりしやすいから。事実が古くなったら、そのファイルだけ書き換えればいい。 もう 1 つは、必要なものだけ選んで読み込めるから。全部を 1 枚の巨大メモにすると、毎回そのすべてを読むはめになる。
各ファイルには、それが何の記憶か(ユーザーの好みか、進行中の案件か、外部資料へのポインタか)も添えます。 種類が分かると、後で「今この場面で関係あるのはどれか」を選びやすい。 記憶を、検索して取り出せる形にしておく、というイメージです。
🗂️索引ファイルという「目次」を1枚持つ
記憶ファイルが増えても、毎回全部は読ませません。索引ファイル 1 枚を目次にして、そこから必要なものだけを開きます。
1 ファイル 1 事実で分けると、当然ファイルは増えます。 全部を毎回読み込んでいたら、結局コンテキストがふくらんで、肝心の作業を圧迫してしまう。
そこで置いているのが、索引ファイル 1 枚です。 各記憶に「タイトルと一行の要約」を付けて、この索引に並べておく。 セッションの始まりに読むのは、まずこの目次だけ。 そこから今の作業に関係しそうなファイルだけを開きにいきます。
本棚に例えるなら、索引が背表紙の一覧です。 全部の本を読み返さなくても、背表紙を眺めれば「今日はこの一冊」と選べる。 記憶が増えても読み込みが軽いままなのは、この目次があるからです。
ただし、目次と中身はずれます。ファイルを足したのに索引に書き忘れる、逆に消したファイルが索引に残る。 こうなると、あるはずの記憶が見つからなかったり、ない記憶を探しにいったりする。 だからうちでは、記憶を書き足したら索引にも一行足す、を必ずセットにしています。 地味ですが、目次が信用できないと、記憶ぜんぶが信用できなくなる。
⚠️記憶は「書いた時点の真実」でしかない
ファイルに残した記憶は、書いた時点の状態です。今もそうとは限らない。だから、記憶を根拠に動く前に、現物を確かめます。
ここが、いちばん大事な但し書きです。 ファイルに書いた記憶は便利ですが、それは書いた瞬間の真実にすぎません。
「このファイルにこの設定がある」と記憶していても、 その後に消えたり名前が変わったりしているかもしれない。 記憶を鵜呑みにして動くと、古い前提のまま突き進む事故が起きます。
だからうちでは、記憶を「背景の参考」として扱い、それを根拠に何かを断定する前には、現物を一度確かめる、と決めています。 記憶が「あるはず」と言っていても、実際にあるかは見てから。 文書に書いてあることと、今そうなっていることは別物―― この線引きは、記憶の運用にもそのまま当てはまります。
🧭自分のAIに記憶を持たせるなら
高度な仕組みは要りません。ファイルに書く・細かく分ける・目次を持つ・鵜呑みにしない。この 4 つで、実用になります。
AI エージェントに記憶を持たせたいなら、私たちの実感としては、この順が現実的です。
- 記憶は AI の頭の中でなく、消えない場所(ファイル)に書き出す。
- 1 ファイル 1 事実で分ける(後から直しやすく、必要な分だけ読める)。
- 索引ファイル 1 枚を目次にして、毎回すべては読み込まない。
- 記憶を根拠に断定する前に、現物を一度確かめる(記憶は「書いた時点の状態」)。
私たちが使っている Claude Code のようなエージェント型ツールは、 ファイルの読み書きを自分でできます(Claude Code の公式ドキュメント)。だから、記憶の置き場をファイルにするのは、特別なことではありません。
一言でいえば――AI の記憶は、頭でなく机の上に置く。消えない場所に、整理して、目次をつけて。 セッションが切れても文脈が続くと、任せられる仕事の幅が、思った以上に広がりました。
開発パートナーを探していますか?
AIでプロダクトを最速で形にしませんか?
最短1週間でMVPを開発。アイデアの検証から本番リリースまで、i-Willinkがフルサポートします。まずはお気軽にご相談ください。
無料で相談する