Drill-Down View — Design Doc with Decisions

spec design Vision Tracker as Primary Roadmap in progress
Linked Document vision-tracker-design.md

### Options Evaluated

Option A: ROADMAP.md only — Agent reads/writes natural language. No impedance mismatch.
Option B: Vision Tracker only — Queryable, filterable, interactive, visual dependency graphs.
Option C: Both, kept in sync — Manual sync will fail. Two sources of truth means zero.
Option D: Tracker primary, markdown generated — Single source of truth. Git-diffable snapshots on demand.

The key insight: if the tracker is the agent's work queue, the agent has self-interest in keeping it current.

Decisions 9
D1 Tracker is primary, markdown is generated
D2 New fields — priority, effort, planLink, successMetric, semanticId
D3 New entity types — feature and initiative
D4 Typed edges — blocks, informs, implements, supports
D5 Compose-loop reads tracker as work queue
D6 + 4 more decisions...
Evidence 0
No evidence attached yet
💬 Discussion (0)