Spec Management

What problem does it solve?

Inconsistent or incomplete requirement specifications can lead to miscommunication, rework, and project delays. This skill provides structured templates and validation tools to ensure high-quality requirements documentation.

Core Features & Use Cases

• Requirements Document Templates: Offers templates and patterns for creating comprehensive specification documents, ensuring all critical sections are included.
• Spec Structure Validation: Includes a script (validate-spec.sh) to mechanically check if a specification document contains all required sections (e.g., Overview, Requirements, Acceptance Criteria).
• Task Extraction: Provides a script (extract-tasks.sh) to automatically extract task lists from specification checkboxes, facilitating task management and progress tracking.
• Actionable Documentation: Emphasizes clear, actionable documentation and reusable patterns for managing requirements, promoting consistency.
• Use Case: A product manager is drafting a new feature specification and wants to ensure it's complete and well-structured. This skill can validate the document against required sections and automatically extract all defined tasks into a separate markdown file for easier tracking.

Quick Start

Validate the structure of 'feature-spec.md' to ensure all required sections are present, then extract all tasks from its checkboxes into a 'tasks.md' file.