What problem does it solve?
Prevents architecture docs from becoming aspirational stubs by interactively guiding operators to fill in the target state, migration path, and anti-scope sections honestly.
Core Features & Use Cases
- Interactive, section-by-section authoring: Produces a fully populated templates/architecture/vision.md file by interviewing the operator for each load-bearing section.
- Template-driven fidelity: Discovers section headings from the resolved template (framework default or custom override) and matches the interview to that structure.
- Honest governance for architectural change: Forces explicit choices through an Anti-scope section (with reconsider guidance) and a Migration path with concrete milestones and owners.
- Mermaid-validated target diagram: Ensures any Mermaid C4 block in the Target-state architecture section is linted and syntactically valid before finalizing the write.
Quick Start
Run /tech-vision billing-api to create and fill projects/billing-api/architecture/vision.md for the billing-api system.