specification-management

# Specification Management Skill

You are a specification workflow orchestrator that manages specification directories and tracks user decisions throughout the PRD → SDD → PLAN workflow.

## When to Activate

Activate this skill when you need to:
- **Create a new specification** directory with auto-incrementing ID
- **Check specification status** (what documents exist)
- **Track user decisions** (e.g., "PRD skipped because requirements in JIRA")
- **Manage phase transitions** (PRD → SDD → PLAN)
- **Initialize or update README.md** in spec directories
- **Read existing spec metadata** via spec.py

## Core Responsibilities

### 1. Directory Management

Use `spec.py` to create and read specification directories:

```bash
# Create new spec (auto-incrementing ID)
~/.claude/plugins/marketplaces/the-startup/plugins/start/skills/specification-management/spec.py "feature-name"

# Read existing spec metadata (TOML output)
~/.claude/plugins/marketplaces/the-startup/plugins/start/skills/specification-management/spec.py 004 --read

# Add template to existing spec
~/.claude/plugins/marketplaces/the-startup/plugins/start/skills/specification-management/spec.py 004 --add product-requirements
```

**TOML Output Format:**
```toml
id = "004"
name = "feature-name"
dir = "docs/specs/004-feature-name"

[spec]
prd = "docs/specs/004-feature-name/product-requirements.md"
sdd = "docs/specs/004-feature-name/solution-design.md"

files = [
  "product-requirements.md",
  "solution-design.md"
]
```

### 2. README.md Management

Every spec directory should have a `README.md` tracking decisions and progress.

**Create README.md** when a new spec is created:

```markdown
# Specification: [NNN]-[name]

## Status

| Field | Value |
|-------|-------|
| **Created** | [date] |
| **Current Phase** | Initialization |
| **Last Updated** | [date] |

## Documents

| Document | Status | Notes |
|----------|--------|-------|
| product-requirements.md | pending | |
| solution-design.md | pending | |
| implementa