Decisions
Why a choice was made: the trade-offs, the constraints and the alternatives you rejected. Cited and revisable.
01 / 06Knowledge Stream
Every decision, lesson and insight, in one feed your AI reads from.
Knowledge Stream keeps the project knowledge that usually gets lost: decisions, lessons, preferences, guardrails, docs, tasks and sessions. It stays current without the noise, and the people, tools and agents in your workspace read from the same feed.
- Decision
Use Postgres row-level security for multi-tenant isolation.
Cited in
auth.ts·session.md - Lesson
Never run migrations on prod without a snapshot first.
- Guardrail
Block direct writes to audit_log. Append only, through the service.
- Session
Pair session with Claude: refactored the billing webhook handler.
- Insight
P95 latency drops 22% when context fetches of more than 3 items are batched.
- Doc
README.md indexed. 3 new code references found.
- Preference
Prefer pnpm over npm in this project. The lockfile is canonical.
01What gets captured
The seven things that make a project knowable.
Most of what your project learns never reaches your AI. The Stream keeps the durable parts, the things future you, your teammates and your agents need, and curates them. Important items surface on their own, bursts of activity collapse into one digest, and Helpful or Dismiss on any item tunes what shows next. Everything else stays one tab away under All activity.
Lessons
What should not happen again. Hard-won corrections become guardrails the next session sees first.
Preferences
How you and your team work. pnpm over npm, tabs over spaces. Small, durable and personal.
Guardrails
What agents should avoid: append-only tables, no direct prod migrations, no push without tests.
Docs and tasks
Indexed READMEs, runbooks, threat models, GitHub issues and PRs. Source-backed and traceable.
Sessions
What you actually built today: turns, edits and references, linked back into the Atlas.
02From activity to reusable judgment
Notes scattered everywhere become one scoped feed.
Knowledge stays scattered.
- Slack thread4 days ago, “we decided to…”
- Notion doc2 weeks ago, half written
- GitHub PR30+ comments, never summarized
- Zoom call“I’ll send notes later”
- Local READMEdrafts/ folder, stale
- The same lesson, lost five times.
- Decision
Row-level security for tenant isolation.
- Lesson
Snapshot before every prod migration.
- Guardrail
The audit log is append-only, through the service.
GroundedEvery item is source-backed, scoped and reusable.
03Readable by agents
Tools and agents ask the Stream and get scoped context.
Through MCP, ContextStream Code or the API, every reusable fact carries its source, its scope and the decision graph it belongs to.
Agent
What should I know before editing auth/session.ts?
- Decision
Row-level security replaces app-layer tenant checks.
- Lesson
Don’t hand-roll session expiry. Use the helper.
- Guardrail
Never log raw session tokens, in dev or prod.
- Doc
auth/README.md · auth/threat-model.md
04Team review and scope
The right context, at the right scope.
Every Stream item is tagged with its scope. Personal preferences stay personal. Client work stays inside client boundaries. Agents only see what they should.
Personal
Your preferences, your shortcuts, your half-formed thoughts. Yours alone, even in a team workspace.
Project
Decisions and lessons scoped to one codebase. Available to anyone with access, and to agents acting on it.
Team and workspace
Knowledge across projects: preferred libraries, on-call runbooks, escalation lessons.
Client-safe
Redacted views for clients or contractors. The boundaries are enforced, not just documented.
Agent-visible
An explicit subset: what an agent can read, what it must avoid and what it should cite back.
Time-boxed
Some items expire. Sprint-scoped decisions leave the active scope when the sprint ends.
Continue reading
Where the Stream connects.
Knowledge Atlas
The Stream is what’s new. The Atlas is what’s connected. See how Stream items become a graph you can query.
Read moreContextCapsules
Bundle a slice of the Stream for one teammate, client or agent. Scoped, expiring and revocable.
Read moreIntegrations
Connect GitHub, Slack, Notion and Linear (beta), and project activity flows into the Stream.
Read moreStart with one decision. Add one lesson. Your AI remembers both.
Five minutes to your first reusable Stream item. No credit card to start.