01 / 06Knowledge Stream · the living feed

Every decision, lesson, and insight in one feed your AI reads from.

Knowledge Stream captures the project knowledge that usually gets lost — decisions, lessons, preferences, guardrails, docs, tasks, and sessions — then makes it searchable and reusable across people, tools, and agents.

streambox · Knowledge Stream · live
Decision · Wisdom
Use Postgres row-level security for multi-tenant isolation.
↳ cited in auth.ts · session.md
2 min ago · streambox/api · rev 4
Lesson · Wisdom
Never run migrations on prod without a snapshot first.
17 min ago · streambox/ops · learned 3rd time
Guardrail
Block direct writes to audit_log table — append-only via service.
1 hr ago · streambox/api
Session
Pair session with Claude — refactored billing webhook handler.
today, 09:14 · 38 min · 14 turns
Insight
P95 latency drops 22% when we batch context fetches (>3 items).
yesterday · derived from 6 sessions
Doc indexed
README.md indexed (4.2KB) — surfaced 3 new code references.
yesterday · streambox/api
Preference
Prefer pnpm over npm in this project; lockfile is canonical.
2d ago · personal scope
01 What gets captured

The seven things that make a project knowable.

Most of what your project has learned never reaches your AI. The Stream catches the durable parts — the things future-you, future-teammates, and future-agents need to do good work.

Decisions

Why a choice was made. The trade-offs, the constraints, the alternatives you rejected. Cited and revisable.

Lessons

What should not repeat. Hard-won corrections that turn into guardrails the next session sees first.

Preferences

How you and your team work. Pnpm over npm. Tabs over spaces. Small, durable, personal.

Guardrails

What agents should avoid. Append-only tables, no direct prod migrations, never push without tests.

Docs & tasks

Indexed READMEs, runbooks, threat models, GitHub issues, PRs — source-backed and traceable.

Sessions

What you actually built today. Turns, edits, references. Auto-linked back into the Atlas.

02 From activity to reusable judgment

Notes scattered everywhere become a single, scoped feed.

Before

Knowledge stays scattered.

  • · Slack thread · 4 days ago · "we decided to…"
  • · Notion doc · 2 weeks ago · half-written
  • · GitHub PR · 30+ comments, never summarized
  • · Zoom call · "I'll send notes later"
  • · Local README · drafts/ folder · stale
  • · The same lesson, lost five times.
After

One scoped Stream your tools read.

Decision
Row-level security for tenant isolation.
streambox/api
Lesson
Snapshot before every prod migration.
streambox/ops
Guardrail
Audit log is append-only via service.
streambox/api
↳ all source-backed · all scoped · all reusable
03 Readable by agents

Tools and agents query the Stream and receive scoped context.

Through MCP, ContextStream Code, or the API — every reusable fact carries its source, its scope, and the decision graph it lives in.

Agent prompt
What should I know before editing auth/session.ts?
Stream reply · 4 cited items
Decision
Row-level security replaces app-layer tenant checks.
cited
Lesson
Don't hand-roll session expiry; use the helper.
cited
Guardrail
Never log raw session tokens in dev or prod.
cited
Doc
auth/README.md · auth/threat-model.md
cited
04 Team review and scope

The right context, at the right scope.

Every Stream event 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 on a team workspace.

Project

Decisions and lessons scoped to one codebase. Available to anyone with access — and to agents acting on it.

Team / workspace

Cross-project wisdom: preferred libraries, on-call runbooks, escalation lessons.

Client-safe

Redacted views for sharing with clients or contractors. Boundaries are enforced, not just documented.

Agent-visible

An explicit subset — what an agent can read, what it must avoid, what it should cite back.

Time-boxed

Some events expire. Sprint-scoped decisions vacate the active scope when the sprint ends.

Start with one decision. Add one lesson. Watch your AI remember.

Five minutes to your first reusable Stream event. No credit card to start.