skills.rest
Vimurai
VimuraiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

blueprint-writer

Validates and writes structured architecture blueprints to .ai/blueprints/ before implementation.

Updated Feb 26, 2026
Search Tags:#architecture#software design#validation#task breakdown#design document#blueprint#ai-os
One-click install
npx skills add https://github.com/Vimurai/ai-os --skill blueprint-writer-vimurai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blueprint-writer
Source: https://github.com/Vimurai/ai-os/tree/main/.claude/skills/blueprint-writer
Command: npx skills add https://github.com/Vimurai/ai-os --skill blueprint-writer-vimurai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents incomplete or boilerplate architecture blueprints from reaching the implementation phase, which would otherwise cause wasted engineering cycles and ambiguous task breakdowns. ## Core Features & Use Cases - Structure Enforcement: Requires nine mandatory sections (Goal & Architecture, Core Concept, Components, Data Model, API Contracts, Security, Execution Constraints, Rollback Plan, E-## Task Breakdown) before any file is written to .ai/blueprints/. - Quality Gates: Blocks blueprints shorter than 20 lines, rejects TBD/TODO placeholders, and forbids generic boilerplate content. - Task Registration: After writing a validated blueprint, it hands off to the task-planner skill to create corresponding E-## engineering tasks in TASKS.md. - Use Case: When designing a new authentication domain, draft the blueprint in-context, validate all required sections, then write it to .ai/blueprints/auth.md with linked implementation tasks. ## Quick Start Ask the AI to design a blueprint for a new feature domain and enforce the required blueprint structure before saving it to .ai/blueprints/.

Frequently Asked Questions about blueprint-writer

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

FAQPage Schema
How do I write an architecture blueprint for a new feature?▼

Draft the blueprint in-context first with all nine required sections, including Core Concept, Data Model, API Contracts, Security, and Rollback Plan. Only after every section passes validation is the file written to .ai/blueprints/ using lowercase hyphenated naming.

What sections are required in a valid blueprint?▼

A valid blueprint requires Goal & Architecture, Core Concept, at least three named Components, Data Model, API/Interface Contracts, Security, Execution Constraints, Rollback Plan, and an E-## Task Breakdown. Every section must contain domain-specific content, not placeholders.

Why was my blueprint blocked from being written?▼

Blueprints are blocked when any required section is missing, contains boilerplate or TBD/TODO text, or when the total length is under 20 lines. Fill in the flagged sections with specific detail and retry the write.

Can a blueprint contain source code?▼

No, blueprints must not contain source code. Pseudo-code is permitted only inside the Data Model section to sketch schemas and entity relationships.

What happens after a blueprint is written to disk?▼

After the blueprint is saved to .ai/blueprints/<domain>.md, the task-planner skill is activated to register the corresponding E-## engineering tasks in TASKS.md, and a confirmation reports the validated section and task counts.

Related Skills

Explore More Software Engineering Skills→
EMSEROEMSERO

spec-engineer

Convert interactive requirements into a structured markdown specification document.

Official
Advanced
vanman2024vanman2024
3

Task Layering

Decompose specifications into complexity-stratified tasks and generate per-agent task files.

Community
Intermediate
axiomanticaxiomantic
8

reviewing-design-docs

Identify gaps and ambiguities in design documents before implementation.

Official
Advanced
Busboom-FooBusboom-Foo

oop

Apply small code changes directly to master with a deterministic test workflow.

Official
Intermediate