Spec Generator

What it does

The Spec Generator skill assists AI agents in producing complete specification packages for software projects. It generates documents including a Product Brief, PRD (Product Requirements Document), Architecture documentation, and Epics through six sequential phases. The process involves analysis using command-line interfaces (CLI) and interactive refinement to ensure thoroughness and consistency. This skill focuses solely on document generation; execution handoff is handled by separate workflows.

When to use it

• When you need a structured approach to creating comprehensive software specifications.
• For projects requiring detailed documentation of product requirements, architecture, and epics.
• To ensure consistent terminology and scope across all specification documents.
• When needing an initial draft for a new project that can be refined through interactive discussion.

Key capabilities

• Generates a full specification package including Product Brief, PRD, Architecture documentation, and Epics.
• Uses six sequential phases: Specification Study, Discovery, Requirement Expansion, Product Brief creation, Requirements (PRD) definition, Architecture design, Epic & Story generation, and Readiness Check.
• Incorporates multi-CLI analysis for parallel review of different aspects of the specification.
• Supports interactive refinement through discussion and CLI gap analysis.
• Includes an auto-fix feature to address inconsistencies identified during the readiness check (limited to two iterations).

Example prompts

• "Generate a product specification package for a new mobile application."
• "Create a PRD outlining the requirements for a user authentication system."
• "Develop architecture documentation for a microservices-based API."

Tips & gotchas

• Prerequisite: Phase 0, Specification Study, requires reading existing specifications and templates.
• The skill generates documents; it does not execute any code or workflows. Handoff to execution workflows (like "lite-plan" or "plan") is a separate step.
• Interactive refinement in Phase 1.5 ("Req Expansion") can be skipped using the -y auto flag for automated expansion, but this may reduce accuracy and require more manual review later.