increment-planner

# Increment Planner Skill

**Self-contained increment planning for ANY user project after `specweave init`.**

## Progressive Disclosure

Load phases as needed to reduce context:

| Phase | When to Load | File |
|-------|--------------|------|
| Pre-flight | Starting planning | `phases/00-preflight.md` |
| Project Context | Resolving project/board | `phases/01-project-context.md` |
| Create Increment | Creating files | `phases/02-create-increment.md` |
| Reference | Examples, troubleshooting | `phases/03-reference.md` |

## Quick Reference

### Increment Types

| Type | Use When | WIP Limit |
|------|----------|-----------|
| **feature** | New functionality | Max 2 |
| **hotfix** | Production broken | Unlimited |
| **bug** | Needs RCA | Unlimited |
| **change-request** | Business changes | Max 2 |
| **refactor** | Technical debt | Max 1 |
| **experiment** | POC/spike | Unlimited |

### Directory Structure

```
.specweave/increments/####-name/
├── metadata.json  # REQUIRED - create FIRST
├── spec.md        # REQUIRED - user stories, ACs
├── plan.md        # OPTIONAL - architecture
└── tasks.md       # REQUIRED - implementation
```

## Workflow Overview

```
STEP 0: Pre-flight (TDD mode, multi-project, Deep Interview)
        → Load phases/00-preflight.md
        → CHECK: Deep Interview Mode enabled?

STEP 0.5: Deep Interview (if enabled)
        → PM skill loads phases/00-deep-interview.md
        → Ask 10-40+ questions about architecture, integrations, etc.
        → Continue until all categories covered

STEP 1: Project Context (resolve project/board)
        → Load phases/01-project-context.md

STEP 2: Create Increment (via Template API)
        → Load phases/02-create-increment.md

STEP 3: Guide User (complete in main conversation)
```

## Deep Interview Mode Detection (STEP 0.5)

**Check during pre-flight:**

```bash
# Detect deep interview mode and enforcement level
deepInterview=$(jq -r '.planning.deepInterview.enabled // false' .specweave/config.json 2>/dev/n