What problem does it solve?
This Skill ensures that specification documents are complete, unambiguous, and adhere to a consistent methodology, preventing costly errors and rework downstream.
Core Features & Use Cases
- Progressive Writing: Guides the user to write one section at a time, ensuring each part is fully defined before moving on.
- Completeness Testing: Implements a two-implementer test to verify that each section is clear enough for independent developers to produce the same implementation.
- Cross-Reference Validation: Mandates checks between different specification layers (IA, BE, FE) to identify and document coverage gaps.
- Ambiguity Gate: Provides a clear mechanism to halt the process and seek user clarification when requirements are unclear or have multiple valid interpretations.
- Use Case: When writing a new API endpoint specification, this skill ensures all fields, responses, errors, and permissions are meticulously defined, preventing misunderstandings between backend and frontend teams.
Quick Start
Use the spec-writing skill to draft the 'user-authentication' section of the BE specification, ensuring all fields, endpoints, and permissions are fully detailed.