managing-specs

What problem does it solve?

This Skill acts as a centralized governance layer for the SPX specs framework, providing a single source of truth for specs/ directory structure and all document templates (PRD/TRD, ADRs, and work items) to ensure consistency across products.

Core Features & Use Cases

• Template access and discovery: Locate and reuse templates for product requirements, architectural decisions, and work items.
• Structured spec hierarchy: Enforce the specs/ directory layout (PRD/TRD, ADRs, and BSP-based work items) with co-located tests and templates.
• Work item scaffolding: Create capabilities, features, and stories with the correct folder paths and naming conventions.
• Template-driven governance: Apply BSP numbering rules and ensure alignment between product, capability, feature, and story artifacts.

Quick Start

1. Read the templates from the skill base directory, e.g. Read: ${SKILL_DIR}/templates/work-items/feature-name.feature.md
2. Initialize a specs directory structure under specs/ and begin with a product PRD (PRD template) followed by ADRs, and work items as described.
3. Use the templates to generate PRD/TRD, ADRs, and work item definitions, then attach co-located tests as you implement.