moai-foundation-specslisted

# SPEC Foundation Skill - Expert v4.0 ## Skill Overview **SPEC** (Specification) is the formal requirements document that drives SPEC-first, TDD development. This Skill provides comprehensive guidance on SPEC lifecycle management, version control, approval workflows, traceability, and integration with MoAI-ADK development pipeline. ### Quick Facts - **4 SPEC Lifecycle States**: Draft, Active, Deprecated, Archived - **Version Management**: Semantic versioning (major.minor.patch) - **Approval Workflow**: Author → Review → Approval → Deployment - **Integration**: Core of `/alfred:1-plan` workflow in MoAI-ADK ### When to Use This Skill - Creating formal specifications before development - Managing specification versions and evolution - Setting up approval workflows for requirements - Tracing requirements through code and tests - Organizing multiple specifications in complex projects --- ## Level 1: Foundation - SPEC Lifecycle ### 1. Draft State - Specification Creation **Purpose**: Initial specification authoring and refinement **Activities**: ``` 1. Specification Author creates SPEC-XXX/spec.md 2. Define requirements using EARS patterns 3. Gather stakeholder input 4. Refine until ready for review 5. Create acceptance criteria 6. Document known risks and constraints ``` **Typical Duration**: 2-5 days (simple features) to 2-4 weeks (complex systems) **Key Artifacts**: - `spec.md` - Main specification document - `acceptance-criteria.md` - Acceptance tests (if separate) -