Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

docs(routing): note ai-memory is the cross-harness memory of record (#671)

AkitaOnRailsdefdbc40726f
diff --git a/AGENTS.md b/AGENTS.md
index 16ae60de..5501c0c7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -28,7 +28,10 @@ managed `ai-memory run` launches add the portable visible-event ledger. Do not
manually write routine notes. Only write durable memory when the user explicitly asks
to remember or annotate something permanently. For an explicitly time-bounded note,
set `expires_at`; expired pages are hidden from normal reads and deleted by the next
-forget sweep, and a TTL outranks `pinned`.
+forget sweep, and a TTL outranks `pinned`. ai-memory is the cross-harness memory of
+record for this project: if the harness you run in has its own local memory feature,
+do not keep durable project facts there in parallel — a harness-local store is
+invisible to every other agent and fragments continuity, so capture them here instead.
For ranking diagnosis, opt-in query explanations add bounded score provenance
to project/scopes hits. Cross-project search uses a distinct FTS-only ranker
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 64b05305..96e5047a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
+### Changed
+- The managed routing snippet now states that ai-memory is the cross-harness
+ memory of record: when the surrounding harness has its own local memory
+ feature, durable project facts should be captured in ai-memory rather than
+ duplicated in a harness-local store that other agents cannot see (#671).
+
### Fixed
- Wiki auto-commits no longer re-hash the whole tree. Since the #594 guard,
every commit cleared the git index and re-read every page, so a session
diff --git a/crates/ai-memory-core/src/routing_snippet.rs b/crates/ai-memory-core/src/routing_snippet.rs
index 262bccef..bd2149e9 100644
--- a/crates/ai-memory-core/src/routing_snippet.rs
+++ b/crates/ai-memory-core/src/routing_snippet.rs
@@ -56,7 +56,10 @@ managed `ai-memory run` launches add the portable visible-event ledger. Do not
manually write routine notes. Only write durable memory when the user explicitly asks
to remember or annotate something permanently. For an explicitly time-bounded note,
set `expires_at`; expired pages are hidden from normal reads and deleted by the next
-forget sweep, and a TTL outranks `pinned`.
+forget sweep, and a TTL outranks `pinned`. ai-memory is the cross-harness memory of
+record for this project: if the harness you run in has its own local memory feature,
+do not keep durable project facts there in parallel — a harness-local store is
+invisible to every other agent and fragments continuity, so capture them here instead.
For ranking diagnosis, opt-in query explanations add bounded score provenance
to project/scopes hits. Cross-project search uses a distinct FTS-only ranker