CodePlans / Specs & Wiki

Keep the spec connected to what shipped

Specs describe intent. CodePlans keeps every version, shows what changed, and records which version each delivered capability implemented. The Product Wiki makes it all readable.

Specs that live next to the work

Author a spec in CodePlans, give it a type and optional area, and link one document to the assets, plans and work items it governs. Plans declare whether they create, revise or reference it.

The Specs page separates current specs from those in review (including fresh imports waiting to be checked) and the archive.

Read the guide →

The Specs list with current, in review and archived tabs

Every revision kept, every change visible

Each change to the title or text is a new version with its full text retained. Open any earlier version read-only, or diff it against its predecessor. Activating, archiving or reclassifying a spec happens in place from the action bar at the top of the page: no new version, and approvals stay put.

When a capability was delivered against v1 and the spec moves to v2, the asset record shows both, without rewriting the delivery receipt.

Changes from v2 to v3 of a spec, with the version history below

Write specs in a proper editor

Edit slides a wide editor in from the side, with a toolbar for headings, lists, task lists, tables, code, links and Mermaid diagrams. Paste markdown from a README or a chat and it becomes formatting; switch to Markdown to edit the source directly.

Text is stored as clean markdown, the same text agents read over MCP. Saving creates the next version with an optional change summary; type and area save in place on the Details tab.

Read the guide →

The slide-in spec editor with a pasted markdown table and task list

A wiki assembled from the work you already record

Open Wiki from the main navigation in its own tab. Read the architecture, documents, decisions and delivery history around every asset, with creator and editor attribution and import provenance. Missing metadata stays explicitly unknown.

Read the guide →

Product Wiki overview: the Atlas demo architecture by layer, with specs awaiting review
Browse by layer. Every asset’s documents, plans and delivery history in one place.
An asset wiki page with capabilities, current specs, attribution and dependencies
Follow an asset’s story. Jump from a capability or spec to the records behind it.
The wiki reader with version, author, a GFM table and a section outline
Read in comfort. Tables, code and prose stay readable, with versions and authors close at hand.
Wiki search highlighting a technical identifier inside spec excerpts
Find the detail you remember. Search identifiers, headings and areas with product-scoped filters.

Wiki screenshots are from a synthetic Atlas demo workspace.

Bring existing Markdown specs across

Apply the normal migrations, then preview the product-scoped legacy URL import. The importer deduplicates source URLs, puts imports in review, and keeps later native edits on reruns.

pnpm db:migrate
pnpm specs:migrate --product=<product-id> --dry-run
# Review the report, then rerun with --apply