tech-vision

Authors a technical architecture vision document covering target state, gap analysis, migration path, and anti-scope.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/MohamedSayedK/omnigrid --skill tech-vision-mohamedsayedk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tech-vision
Source: https://github.com/MohamedSayedK/omnigrid/tree/main/assets/core/skills/tech-vision
Command: npx skills add https://github.com/MohamedSayedK/omnigrid --skill tech-vision-mohamedsayedk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams often lack a written north-star architecture, making it hard to judge whether daily changes move the system in the right direction. This Skill guides the authoring of a technical vision document that captures the target architecture, the honest current-vs-target gap, an ordered migration path, and the anti-scope of roads deliberately not taken. ## Core Features & Use Cases - Section-by-section authoring: Walks through the shipped VISION-TEMPLATE.md scaffold interactively rather than dropping an empty template on the user. - Role-bound execution: Runs as the tech-lead Role via runs-as, and works standalone without requiring an Orchestrator. - Grounded in repo context: Anchors claims in OMNIGRID-CONTEXT.md domain language and existing ADRs in omnigrid/artifacts/adrs/. - Artifact regeneration contract: Writes a footer-signed vision to omnigrid/artifacts/architecture/vision.md, archiving prior canonical copies and never overwriting hand-owned files. - Use Case: A tech lead kicking off a re-platforming effort runs the skill to produce a signed vision.md that the team references when reviewing architecture decisions and planning migrations. ## Quick Start Ask the assistant to run /tech-vision for the whole repository or a specific system area to author the architecture vision document.

Frequently Asked Questions about tech-vision

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

FAQPage Schema
How do I write a technical architecture vision document?▼

Run the skill with an optional system or area argument, and it walks you through the VISION-TEMPLATE.md scaffold section by section. It presses for an honest current-vs-target gap, an ordered migration path, and explicit anti-scope before writing the signed artifact.

What is the difference between a tech vision and a migration plan?▼

The tech vision defines the north-star target architecture and the gap to it, while the migration plan is the reshaping execution. This skill pairs with the /migration skill for planning and /c4 for current-state topology.

Does this skill work without an orchestrator agent?▼

Yes, it is self-sufficient and activates its tech-lead Role in-thread when invoked directly. No Orchestrator is required to run the full authoring process.

What happens when I re-run the vision authoring on an existing document?▼

Re-running archives the old canonical copy to a dated file and refreshes the canonical vision.md. A file whose footer was hand-removed is treated as hand-owned and is never auto-overwritten, and single sections can be refreshed independently.

Where is the architecture vision output stored?▼

The footer-signed vision is written to omnigrid/artifacts/architecture/vision.md. Its content is grounded in OMNIGRID-CONTEXT.md domain language and the ADRs under omnigrid/artifacts/adrs/.