// one document: pages, chips, tasks, drawings, and an agent branch — in place
Living Spec gives engineers and product teams the context they need throughout development — the spec as a shared context layer for agentic development.
Goal: a room a kid can actually play in. Links: Floor and turf Order turf Drawing: arena-layout
Decision (rev 38): skip the pressure adhesive — tape between turf and foam blocks held fine.
rev 39 — agent updated 2m ago · branch merged → acceptance criteria 3/3 ✓ · spec still true
// one document: pages, chips, tasks, drawings, and an agent branch — in place
AI and agents now write code faster than any team can capture why. That intent lives in the spec — and the moment it drifts from what you are actually building, everyone is guessing again.
Specs scatter across docs, tickets, and READMEs nobody trusts. Two sprints in, they describe software that no longer exists.
Coding agents are only as good as their context. Without the spec, they reimplement yesterday's decisions — wrongly.
The "why" lives in chat threads, meeting notes, and someone's memory. When it's needed, it's unfindable.
Pages, tasks, drawings, and files in one living document — structured for a team, readable by an agent.
Connect Claude — or any MCP client — and your agents read the relevant spec as context, work from the same source of truth your team does, and write their progress back on a branch you review — so the spec stays current as they work, without anyone stopping to write it up by hand.
// reading this as an agent? start at /llms.txt
Assign, prioritize, and track work inside the spec.
Sketch flows and diagrams that live with the words.
Attach designs, screenshots, and video inline.
Reuse boilerplate blocks across documents.
Find anything across every spec, task, and comment.
Invite collaborators, reviewers, or the whole internet.
Follow what matters without inbox spam.
Roll tasks and progress up across documents.
Markdown, email, PDF, and MCP in and out — no lock-in.
A live map of every page, task, and link in the spec.
Saved searches and filters that render as always-current pages.
Duplicate any spec, or start from example templates.
Contextual sidebars surface connections and activity as you work.
Multiple accounts and email aliases, one unified profile.
Reviews and discussion tied to the exact work they concern.
Bring what you already have, connect your agents, and let the spec keep itself honest from here.
Create your first spec