Linked Document vision-tracker-design.md

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