What is Omni Architect?
Omni Architect is an orchestration skill that transforms Product Requirements Documents (PRDs) into validated design assets through an intelligent, multi-phase pipeline. It bridges the critical gap between product specification and visual design by inserting a logical validation layer.The Problem It Solves
In product teams, there’s a significant gap between writing a PRD and materializing the visual design:- Rework: designers misinterpret requirements
- Inconsistencies: product logic isn’t validated before design
- Slowness: PRD → Design cycle takes days or weeks
The Solution
Omni Architect eliminates this gap by automating the pipeline and inserting a logical validation stage (via Mermaid diagrams) before visual generation (via Figma):Result: 70%+ reduction in design rework and guaranteed logical validation before investing in visual assets.
Core Architecture Principles
1. Sequential Pipeline with Feedback Loops
The architecture follows a linear pipeline where each phase builds on the previous one. If validation fails, the system can loop back to earlier phases for refinement.2. Mermaid as Intermediate Representation
Mermaid diagrams serve as the bridge between text-based requirements and visual design:- Text-based: Version-controllable, diffable, easily editable
- Widely supported: Renders in GitHub, documentation tools, IDEs
- Logical validation: Enables coherence checking before design investment
Why Mermaid? (ADR-002)
Why Mermaid? (ADR-002)
Decision: Use Mermaid as the intermediate representation between PRD and Figma.Motivation: Mermaid is text-based (versionable), widely supported, and renderable without external tools. It allows logical validation before design investment.Consequence: Some visual limitations of Mermaid don’t translate 1:1 to Figma, but the logical validation benefits outweigh this.
3. Weighted Validation Scoring
Quality is measured through a weighted scoring system across six criteria, allowing teams to calibrate what “valid” means for their project.4. Sub-Skill Orchestration
Omni Architect is a meta-skill that orchestrates five specialized sub-skills, each responsible for one phase of the pipeline. This modular design enables:- Independent testing and development
- Skill reusability in other contexts
- Clear separation of concerns
High-Level Flow
Data Flow
Each phase consumes outputs from the previous phase and produces structured artifacts:| Phase | Input | Output | Purpose |
|---|---|---|---|
| 1. PRD Parser | Raw Markdown PRD | Semantic structure (features, stories, entities) | Extract machine-readable structure |
| 2. Mermaid Generator | Parsed PRD structure | Mermaid diagram code | Visualize product logic |
| 3. Logic Validator | Diagrams + PRD | Validation report + coherence score | Quality gate before design |
| 4. Figma Generator | Validated diagrams | Figma node IDs + preview URLs | Generate visual design assets |
| 5. Asset Delivery | All artifacts | Consolidated package + handoff docs | Package deliverables for developers |
Key Design Decisions
Sequential Pipeline with Validation Gate (ADR-001)
View Decision Record
View Decision Record
Decision: Linear pipeline with the ability to return to Phase 2 after rejection.Motivation: Ensures no Figma asset is generated without prior logic validation.Consequence: May increase total time, but drastically reduces rework.
Weighted Coherence Score (ADR-003)
View Decision Record
View Decision Record
Decision: Use a weighted score with 6 criteria for validation.Motivation: Allows fine-tuning of what is considered “valid” per project.Consequence: Requires initial threshold tuning per team/project.
Orchestration Dependencies
Omni Architect orchestrates these specialized skills:- prd-generator — PRD parsing and structuring
- mermaid-diagrams — Mermaid diagram generation
- figma — Figma API integration
- frontend-design — Production-grade frontend design
- implement-design — Pixel-perfect Figma implementation
All sub-skills can be used independently outside of Omni Architect, making them reusable building blocks.
Configuration Flexibility
The architecture supports multiple configuration modes:- Validation modes:
interactive,batch,auto - Design systems:
material-3,apple-hig,tailwind,custom - Diagram types:
flowchart,sequence,erDiagram,stateDiagram,C4Context,journey,gantt - Locales: Multi-language support for labels and documentation
Next Steps
Pipeline Architecture
Deep dive into the 5-phase pipeline
Skills System
Learn about sub-skill orchestration
Validation Scoring
Understand the 6-criteria validation system
Quick Start
Get started with Omni Architect