Grounding substrate
FAFO MEMORY · GROUNDS THE WORK

FAFO Memory

Agents that are grounded, not guessing.
A model that remembers beats a model that recalls.

Every task an agent runs is grounded in what your organization already knows: your code, your prior decisions, and your reference material. Retrieved by meaning, cited in the work, and never invented.

Three capabilities, one substrate

The map is built from real edges. The model reads it, it never invents it.

Most retrieval systems return text chunks and hope the model figures out the rest. FAFO Memory returns symbols, dependencies, prior decisions, and reference excerpts that an agent can act on directly.

Semantic code index

Search by meaning.

Agents search your codebase by intent, not string match, retrieving whole functions and symbols, and tracing dependencies and blast-radius before they change anything. The map is built from real edges; the model reads it, it never invents it.

Observation history

Decided once, remembered.

Every decision, discovery, and fix is recorded and searchable. Agents don't re-debug a solved bug or re-litigate a settled choice. The institutional record is part of the work, not lost in a transcript.

Agents learn from agents

Knowledge compounds.

What one agent learns grounds the next. Approved patterns and failure modes accumulate across the fleet and survive engineer turnover. The system gets smarter the longer it runs, with no retraining.

Inside the substrate

Three indexes. One retrieval surface.

Code, observations, and references each have their own pipeline and their own enrichment, but agents reach them through one API and one set of tools.

Index 01

Code

Your working source, AST-chunked and embedded with a real symbol graph behind it: calls, called-by, implements, imports.

  • search_code
  • trace_symbol_dependencies
  • explain_code_path
Index 02

Observations

Every decision, discovery, fix, and outcome an agent records, banked as an immutable timeline of why the system looks the way it does.

  • search_observations
  • create_observation
  • hybrid · semantic · keyword
Index 03

References

External material that grounds the work: SDK source, PDFs, API specs, crawled sites, all enriched with summaries and section anchors.

  • search_references
  • documents · code · sites
  • cited results, with page numbers
Where retrieval becomes governance

Blast-radius proof, before the change is made.

When a worker proposes a change, AgentOS does not trust the description of the change. It traces the actual symbols through the actual code graph and classifies the blast radius from the impacted set. The classification decides whether the team has authority to ship, or whether the change escalates.

01

Proposed change → symbols and paths

The worker names the files, symbols, and paths it intends to touch. Description only; no edits yet.

02

Resolve the implementation surface

search_code finds the real implementation for each named symbol. The worker's description is now grounded in code, not memory.

03

Trace dependencies

trace_symbol_dependencies walks the call graph: who calls this, who does this call, who implements this, who imports it. Sub-second, no LLM.

04

Impacted set → blast-radius class

The set of symbols and modules that move when this change ships becomes a blast-radius class: local, module, system, or estate. The class is evidence-backed, not narrated by the model.

05

Envelope decision

If the class stays inside the team's envelope, the work continues. If it crosses, AgentOS escalates before any code is written. The model never gets to claim "it's a small change" when the graph says otherwise.

Worked example
A "small refactor" that wasn't.
Change proposed
UserRepository · src/data/user_repository.rs
Worker describes the change as "rename two methods, tighten one signature."
trace_symbol_dependencies
Impacted set
38 symbols across 12 modules
callers: AuthService · BillingPipeline · NotificationDispatcher · ReportBuilder · SessionResolver · ...
classify
Blast radius
system · crosses 3 envelopes (auth · billing · notifications)
envelope decision
Verdict
ESCALATED · team envelope backend-auth permits module; this change exceeds.
No code written. The graph caught the scope drift before the diff existed.
Measured, not asserted

Engineered for fleet retrieval.

Memory has to keep up with a fleet of agents that all want grounding at the same time. The substrate is built for concurrent retrieval, not single-user assistant patterns.

2000+
concurrent agent requests under 100ms via the caching layer
~1.2s
p50 semantic search across a working codebase
3
retrieval surfaces · code · observations · references
Self-hosted
PG-backed, no data leaves your perimeter
Source: internal bench, fleet retrieval load · FAFO Memory · today

Grounded agents.
Smarter work, every day.

FAFO Memory is part of AgentOS. Become a design partner and put it to work on yours.