Spec Architect

What problem does it solve?

This skill eliminates ambiguity between product requirements and implementation by generating, validating, and versioning specification files (.spec.md) according to the SDD v2.0 standard, ensuring requirements are actionable and testable.

Core Features & Use Cases

• Spec Generation: Produces dated, versioned spec files in specs/ using a mandatory master template that includes context, KPIs, data schemas, persistence changes, business invariants, stack constraints, and Gherkin acceptance criteria.
• Refinement Workflow: Analyzes existing specs for ambiguities and missing edge cases, prompts for clarifying technical decisions, and enforces traceability to originating tickets.
• Audit & Drift Detection: Compares implementation files against the spec to report deviations such as type mismatches, missing validations, or security rule omissions, and recommends corrective actions.
• Use Case: Product managers and engineers use /specify to create a new feature spec before development, iterate with /refine during planning, and run /audit post-implementation to surface spec drift.

Quick Start

Use the command /specify to generate a new SDD v2.0 specification for a described feature.