spec-management

# Specification Management

Central hub for specification-driven development workflows. This skill provides navigation to specialized skills for different specification formats and workflows.

## When to Use This Skill

**Keywords:** specifications, requirements, acceptance criteria, spec-driven development, SDD, EARS, Gherkin, Kiro, Spec Kit, BDD, user stories, feature specifications, canonical spec

**Use this skill when:**

- Starting a new specification-driven workflow
- Converting between specification formats
- Understanding available specification providers
- Navigating to specialized authoring skills
- Working with the canonical specification model

## Quick Decision Tree

**What do you want to do?**

1. **Start Spec Kit 5-phase workflow** → Use `/spec:speckit:run` or see [speckit-workflow skill](../speckit-workflow/SKILL.md)
2. **Generate a specification** → Use `/spec:specify` command
3. **Write EARS requirements** → See [ears-authoring skill](../ears-authoring/SKILL.md)
4. **Write Gherkin scenarios** → See [gherkin-authoring skill](../gherkin-authoring/SKILL.md)
5. **Sync with AWS Kiro** → See [kiro-integration skill](../kiro-integration/SKILL.md)
6. **Check requirement quality** → See [requirements-quality skill](../requirements-quality/SKILL.md)
7. **Understand canonical format** → See [canonical-spec-format skill](../canonical-spec-format/SKILL.md)
8. **Convert between formats** → Use `/spec:convert` command

## Specification Providers

The canonical specification model (ADR-115) supports multiple providers:

| Provider | Format | Best For |
| --- | --- | --- |
| **ears** | EARS syntax | Precise, unambiguous requirements |
| **gherkin** | .feature files | BDD tests with Reqnroll |
| **kiro** | AWS Kiro | IDE integration with steering files |
| **speckit** | GitHub Spec Kit | AI agent prompts, 5-phase workflow |
| **adr** | MADR format | Architecture decisions |
| **userstory** | Agile format | Product backlog items |
| **canonical** | YAML/JSON | Direc