tech-vision

Author architecture vision documents via interactive section-by-section operator interviews.

489|254|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/me2resh/apexyard --skill tech-vision
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-vision
Source: https://github.com/me2resh/apexyard/tree/main/.claude/skills/tech-vision
Command: npx skills add https://github.com/me2resh/apexyard --skill tech-vision

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about tech-vision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an architecture vision document that includes a migration path and anti-scope?

Create an architecture vision document by interactively collecting target-state, migration path, and anti-scope content section-by-section, ensuring honest governance through explicit exclusions and concrete milestones before finalizing the output.

How do I validate a Mermaid C4 diagram in my architecture documentation?

You validate a Mermaid C4 diagram in architecture documentation by applying Mermaid lint validation to the target-state section, ensuring the C4 block is syntactically valid before the file write is finalized.

What is an anti-scope section in a technical architecture vision?

An anti-scope section in a technical architecture vision explicitly defines what is excluded from the project scope, forcing honest governance and providing reconsider guidance to prevent architecture docs from becoming aspirational stubs.

Can I use a custom SDLC template for architecture vision authoring instead of the framework default?

Yes, you can use a custom SDLC template for architecture vision authoring. The system discovers template section headings from the resolved template, matching the interview structure to either a framework default or a custom override.

How do I generate a production-ready architecture vision for a new system onboarding?

Generate a production-ready architecture vision for new system onboarding by running an interactive interview process that populates a resolved vision.md file, aligning target-state architecture, migration milestones, and anti-scope to an SDLC template.

What happens if an architecture vision file already exists when I try to write it?

If an architecture vision file already exists, the write behavior is guarded to prevent overwriting existing outputs, ensuring your current architecture documentation remains protected during the interactive authoring process.