Delivery · Spec map

Every spec, mapped to your codebase.

Three views — by codebase folder, by theme, by product page — of every spec your team has ever shipped. Each one classified by blast radius, so you can see what’s safe to ship and what touches everything.

annsa
Spec map12
Folder treeBy themeBy page
tandem·workspace app
src/canvas/3 specs
Canvas.tsx2
co-edit.ts1
src/collab/2 specs
usePresence.ts2
src/ai/4 specs
rewrite-merge.ts4
src/comments/1 spec
CommentThread.tsx1
src/workspace/2 specs
useWorkspace.ts2
Specs on this map
Resolve co-edit conflicts in AI rewrites
src/canvas/co-edit.ts, src/ai/rewrite-merge.ts·blast radius: Moderate
Show who's editing on the presence cursor
src/collab/usePresence.ts·blast radius: Contained
— The problem —

You don’t know what your specs cover until you’ve shipped them.

Specs accumulate in a backlog with no shape. You can’t tell which parts of your codebase are well-specced and which are blind spots. You can’t tell which work is contained — a leaf, safe to ship — and which work touches half the system. So planning runs on gut, and risk shows up in production.

The spec map shows you the shape. Every spec ever produced, organised three ways, with each one classified by how much of your codebase it touches. You see the coverage and you see the risk before you start.

— How it works —

Three views, one underlying map.

Each view organises the same specs differently.

01
Codebase view.

A folder tree of every file your specs touch. Click a folder to see the specs in it. Click a spec to open it.

tandem · folder tree
src/canvas/14 specs
src/collab/6 specs
usePresence.tsSpec
02
Theme view.

Specs grouped by the cluster theme they came from — so you see the shape of what your customers asked for, not just where it landed.

tandem · by theme
Collaboration9 specs
AI5 specs
Comments3 specs
03
Page view.

Specs grouped by the product page they affect, parsed from your component paths. “What have we shipped on the priorities page?” is one click.

tandem · by page
src/components/pages/CanvasPage.tsx
path → page
Canvas
7 specs on this page
04
Blast-radius classified.

Every spec is labelled contained, moderate or cross-cutting, based on how many files and folders it touches.

Contained · Moderate · Cross-cutting
Presence freeze fix
2 files · 1 folderContained
— What makes it different —

Coverage and risk, mapped from your specs.

No competitor can show this view because none of them read your codebase. Annsa reads it, classifies every spec by what it touches, and lets you navigate the map three different ways.

Folder tree from Files-to-Touch.

Annsa builds a live tree of your codebase from every spec’s Files-to-Touch section, so the map reflects what you’ve planned to build.

Blast-radius labels.

Contained (≤ 2 files, ≤ 1 folder), moderate, or cross-cutting (≥ 5 files, ≥ 3 folders). You see surgical work and system-wide work at a glance.

Page view from component paths.

Annsa parses your component file paths to group specs by product page. No tagging, no mapping table — the structure of your codebase is the structure of the map.

— Everything in this feature —

What’s in the map.

Codebase view

Folder tree, recursively expandable. Click a node, see the specs.

Theme view

Specs grouped by cluster theme.

Page view

Specs grouped by parsed product page name.

Backend / shared bucket

Specs that don’t map to a page land here cleanly, not forced into the wrong group.

Contained-vs-cross-cutting tables

Two side-by-side tables for the safest work and the riskiest, so you can choose your week.

Click through to the spec

Every node opens the same spec panel. One artifact, many entry points.

— Questions —

Asked and answered.

What is the spec map?

A view of every spec your team has ever produced, organised by where it lives in your codebase, what theme it came from, or what product page it touches. Each spec is classified by blast radius.

What is blast radius?

How much of your codebase a spec touches. Contained means two files or fewer in one folder — safe, leaf-node work. Cross-cutting means five files or more across three folders — surgical, system-wide. Moderate is everything in between.

How is the folder tree built?

From the Files-to-Touch section of every spec annsa has ever produced. It’s a live map of where your planned work lands in the codebase, not a separate tag taxonomy.

How does the page view know which page a spec affects?

It parses your component file paths. “src/components/pages/{Name}Page.tsx” becomes “{Name}”. Specs that don’t match a page rule land in a “Backend / shared” group, so nothing is forced into the wrong place.

Can I open a spec from the map?

Yes. Every spec row, every folder node, every tile opens the same spec panel — the one you’d open from the priority list. Same artifact, different entry point.

Go deeper

Learn more about the annsa Delivery suite.

See the shape of what you’ve shipped.

Spec map is part of annsa’s Delivery suite — the translation layer of autonomous product intelligence.