Loop Memory(ループメモリ)
Reflexionスタイルの言語メモリ:エージェントは各試行について文章で振り返り、その振り返りを保存し、行動前に最近の振り返りを読み直します。研究(Shinn et al., 2023)によれば、このメカニズム——振り返り、保存、再読——は盲目的なリトライを大幅に上回ります(12回の試行での意思決定タスクで+22%、コードで+11%)。また、振り返りのない単なるメモリよりも8ポイント優れています。この利点は、書かれた理由に由来し、単にリトライを強化することからは得られません。
プロトコル
行動前(すべてのタスク)
.loop/LESSONS.mdを読む。- Standing rules(常時ルール) セクションを無条件に適用する。
- 直近3件のエントリを読む。そのうちいずれかが現在のタスクに関連する場合、どのようにアプローチを変更するかを1行で述べる。関連するものがない場合は、無理に当てはめずにそのまま進む。
行動後(すべての試行、成功または失敗)
以下のフォーマットでエントリを1件ファイルに追加する:
## [日付] — [タスク名、5単語以内] — PASS|FAIL
- 何が起こったか:[1行]
- 根本原因/なぜうまくいったか:[1行]
- 次回:[1つの具体的で検証可能な指示]
「次回」の品質基準:
- ❌ 「データベースにもっと注意する」——検証不可能
- ✅ 「シードスクリプトの前に必ず
npx prisma migrate deployを実行する」——検証可能 - ❌ 「APIがトリッキーだということを覚えておく」——曖昧
- ✅ 「/users エンドポイントは50件でページネーションする;カウントするときは必ず ?page= を渡す」——検証可能
失敗時の振り返り、特に
試行が失敗した場合、振り返りは次の問いに答えなければなりません:自分は何を信じていたか、それは間違っていたか?失敗した試行は通常、タイプミスではなく誤った仮定に起因します。その仮定を明確にしてください。それが教訓です。
メンテナンス(ファイルが約30エントリを超えた場合)
- すべてのエントリを古い順に読む。
- 2回以上出現した教訓は Standing rules に昇格させ、1つの命令文として書き直す。
- 昇格後、最も古い20エントリを削除する。
- ユーザーの承認なしに Standing rules を削除してはいけない。
保存してはいけないもの
- シークレット、キー、トークン、個人データ——たとえそれが失敗の原因であっても、絶対に保存しない。
- ナレーション(「次にXを試したところ、Yが起こった…」)——結論のみを保存する。
- 重複した教訓——すでに存在する場合は再追加せず、昇格を検討する。
- 非難や自己批判——教訓は指示であり、感情ではない。
避けるべき失敗モード
- メモリごっこ:エントリを書くが決して読まない。読むステップに価値があり、書くだけのステップは日記に過ぎない。
- 単一インシデントへの過学習:1回限りの環境の不具合は教訓ではない。再発しないものは記録しない。
- 無制限の成長:誰も読まない200エントリのファイルは死んだメモリである。圧縮せよ。