02 / 06Knowledge Atlas · the connected graph

Project history, mapped into agent-ready context.

The Stream is what's new. The Atlas is what's connected. Knowledge Atlas links decisions, lessons, code, docs, tasks, sessions, and project history into a queryable graph so agents find the right context, not just the most recent context.

Knowledge Atlas · 183 nodes · 421 edges
streamboxauth.tsmigrationsaudit_logsession #438README.mdpnpmbatch ctx
183 nodes·421 edges·47 decisions·22 lessons·14 docs·9 open tasks
01 Connected, not stored

Decisions and lessons live next to the code, docs, sessions, and tasks they affect.

Most "memory" tools store snippets. The Atlas stores relationships — so when an agent reads auth/session.ts, it also sees the decision that shaped it, the lesson that constrains it, and the open task that depends on it.

Code ↔ decisions

Every file gains the decisions, trade-offs, and lessons that shaped it. No more re-deriving why.

Lessons ↔ guardrails

Lessons promote into guardrails on the surfaces they protect. Same fact, two roles.

Docs ↔ sessions

Indexed READMEs and runbooks attach to the sessions that actually used them.

02 Right context, not most recent

An agent asks. The Atlas answers with the right slice.

Agent query
What should I know before editing auth/session.ts?
traversal · 3 hops · 7 nodes · 11 edges
Atlas reply · 5 cited nodes
Decision
Use Postgres row-level security for tenant isolation.
cited
Lesson
Don't hand-roll session expiry; use the helper.
cited
Guardrail
Never log raw session tokens.
cited
Doc
auth/threat-model.md
cited
Open task
Rotate signing keys before launch.
cited
03 Two views, one context graph

Code graph. Knowledge graph. Same Atlas.

The relationships between files, concepts, decisions, and lessons live in one graph. Toggle the view; the underlying truth is the same.

⌘ Code view

Files, symbols, callsites, ownership.

Imports, references, and ownership graphs derived from the source — sanitised, never stored.

◈ Knowledge view

Decisions, lessons, sessions, threads.

Wisdom nodes connected by who learned them, where they were used, and which code they protect.

04 From graph to agent

Every surface traverses the same Atlas.

MCP traversal

MCP-compatible tools query the Atlas with scoped, source-backed responses.

ContextStream Code

The first-party CLI uses the Atlas before every edit, surfacing related context inline.

Capsules

Capsules are pre-traversed Atlas slices, scoped, expiring, and revocable.

Give every tool the project context it should already have.

The Stream is what's new. The Atlas is what's connected. Start with one decision; the graph grows from there.