Feature Lifecycle Skill
Phase-gated feature workflow: DESIGN > PLAN > IMPLEMENT > VALIDATE > RELEASE. Each phase must pass its gate before the next begins.
Phase Routing
Determine which phase to execute based on feature state:
If .feature/ exists, check current phase:
python3 ~/.claude/scripts/feature-state.py status
Route to the phase indicated by the state machine.
If no feature state exists, determine entry point from user intent:
- Validated
Architecture Change Handoff targeting feature-lifecycle -> DESIGN; the design phase adopts it before approach work
- "design", "think through", "explore approaches" -> DESIGN
- "plan", "break down", "create tasks" -> PLAN (requires completed design)
- "implement", "execute plan", "start building" -> IMPLEMENT (requires completed plan)
- "validate", "quality gates", "check feature" -> VALIDATE (requires completed implementation)
- "release", "merge", "ship it" -> RELEASE (requires passed validation)
- "end to end", "full lifecycle", "from scratch" -> DESIGN (start from beginning)
Load the phase reference for the current phase:
- DESIGN: Read
references/design.md
- PLAN: Read
references/plan.md
- IMPLEMENT: Read
references/implement.md
- VALIDATE: Read
references/validate.md — run quality gate commands, do not reason about whether they would pass. Paste exit codes and output.
- RELEASE: Read
references/release.md
- END-TO-END: Read
references/pipeline.md
Follow the loaded reference exactly. Each reference contains the full phase instructions, gates, and checkpoints.
State Conventions
Read references/shared.md for directory structure, state management commands, context loading rules, and naming conventions. All state operations go through python3 ~/.claude/scripts/feature-state.py -- never manipulate state files directly.
Phase Ordering
DESIGN -> PLAN -> IMPLEMENT -> VALIDATE -> RELEASE
| | | | |
v v v v v
design.md plan.md impl.md report.md PR merged
Each phase produces an artifact consumed by the next. Skipping phases is not supported because downstream phases depend on artifacts from earlier phases.
Reference Loading Table
| Signal |
Load These Files |
Why |
| Phase 1 DESIGN: idea to design document |
design.md |
Loads detailed guidance from design.md. |
| Architecture Change Handoff targets feature-lifecycle |
design.md |
Validate and adopt architecture scope/interface/migration; create/register the feature ADR in DESIGN. |
| errors, error handling |
error-handling.md |
Loads detailed guidance from error-handling.md. |
| Phase 3 IMPLEMENT: dispatching task waves to domain agents |
implement.md |
Loads detailed guidance from implement.md. |
| running the full design-to-release pipeline |
pipeline.md |
Loads detailed guidance from pipeline.md. |
| Phase 2 PLAN: decomposing design into wave-ordered tasks |
plan.md |
Loads detailed guidance from plan.md. |
| Phase 5 RELEASE: PR merge, tagging, worktree cleanup |
release.md |
Loads detailed guidance from release.md. |
| feature state directory layout, naming, write protection |
shared.md |
Loads detailed guidance from shared.md. |
| Phase 4 VALIDATE: running quality gates |
validate.md |
Loads detailed guidance from validate.md. |
Error Handling
| Error |
Cause |
Solution |
| Phase mismatch |
User requests phase N but state is at phase M |
Report current state, suggest correct next phase |
| Missing artifact |
Previous phase did not produce expected output |
Route back to previous phase |
| Gate failure |
Phase requirements not met |
Report what failed, suggest fixes |
References
| Task Signal |
Load |
| Phase routing (design/plan/implement/validate/release) |
Phase reference (design.md, plan.md, implement.md, validate.md, release.md) |
| End-to-end or full pipeline |
references/pipeline.md |
| State commands, directory structure, naming |
references/shared.md |
| Error, failure, blocked, gate fail, retry, deviation |
references/error-handling.md |
references/design.md -- Design phase: explore requirements, discuss trade-offsreferences/plan.md -- Plan phase: break design into wave-ordered tasksreferences/implement.md -- Implement phase: dispatch tasks to domain agentsreferences/validate.md -- Validate phase: run quality gatesreferences/release.md -- Release phase: merge, tag, cleanupreferences/pipeline.md -- End-to-end orchestration across all phasesreferences/shared.md -- State conventions shared across all phasesreferences/error-handling.md -- Recovery patterns for phase errors, gate failures, agent dispatch failures
1---2name: feature-lifecycle3description: Feature lifecycle: design, plan, implement, validate, release. Phase-gated workflow.4---56# Feature Lifecycle Skill78Phase-gated feature workflow: DESIGN > PLAN > IMPLEMENT > VALIDATE > RELEASE. Each phase must pass its gate before the next begins.910## Phase Routing1112Determine which phase to execute based on feature state:13141. **If `.feature/` exists**, check current phase:15 ```bash16 python3 ~/.claude/scripts/feature-state.py status17 ```18 Route to the phase indicated by the state machine.19202. **If no feature state exists**, determine entry point from user intent:21 - Validated `Architecture Change Handoff` targeting `feature-lifecycle` -> DESIGN; the design phase adopts it before approach work22 - "design", "think through", "explore approaches" -> DESIGN23 - "plan", "break down", "create tasks" -> PLAN (requires completed design)24 - "implement", "execute plan", "start building" -> IMPLEMENT (requires completed plan)25 - "validate", "quality gates", "check feature" -> VALIDATE (requires completed implementation)26 - "release", "merge", "ship it" -> RELEASE (requires passed validation)27 - "end to end", "full lifecycle", "from scratch" -> DESIGN (start from beginning)28293. **Load the phase reference** for the current phase:30 - DESIGN: Read `references/design.md`31 - PLAN: Read `references/plan.md`32 - IMPLEMENT: Read `references/implement.md`33 - VALIDATE: Read `references/validate.md` — **run quality gate commands, do not reason about whether they would pass. Paste exit codes and output.**34 - RELEASE: Read `references/release.md`35 - END-TO-END: Read `references/pipeline.md`36374. **Follow the loaded reference** exactly. Each reference contains the full phase instructions, gates, and checkpoints.3839## State Conventions4041Read `references/shared.md` for directory structure, state management commands, context loading rules, and naming conventions. All state operations go through `python3 ~/.claude/scripts/feature-state.py` -- never manipulate state files directly.4243## Phase Ordering4445```46DESIGN -> PLAN -> IMPLEMENT -> VALIDATE -> RELEASE47 | | | | |48 v v v v v49design.md plan.md impl.md report.md PR merged50```5152Each phase produces an artifact consumed by the next. Skipping phases is not supported because downstream phases depend on artifacts from earlier phases.5354## Reference Loading Table5556| Signal | Load These Files | Why |57|---|---|---|58| Phase 1 DESIGN: idea to design document | `design.md` | Loads detailed guidance from `design.md`. |59| Architecture Change Handoff targets feature-lifecycle | `design.md` | Validate and adopt architecture scope/interface/migration; create/register the feature ADR in DESIGN. |60| errors, error handling | `error-handling.md` | Loads detailed guidance from `error-handling.md`. |61| Phase 3 IMPLEMENT: dispatching task waves to domain agents | `implement.md` | Loads detailed guidance from `implement.md`. |62| running the full design-to-release pipeline | `pipeline.md` | Loads detailed guidance from `pipeline.md`. |63| Phase 2 PLAN: decomposing design into wave-ordered tasks | `plan.md` | Loads detailed guidance from `plan.md`. |64| Phase 5 RELEASE: PR merge, tagging, worktree cleanup | `release.md` | Loads detailed guidance from `release.md`. |65| feature state directory layout, naming, write protection | `shared.md` | Loads detailed guidance from `shared.md`. |66| Phase 4 VALIDATE: running quality gates | `validate.md` | Loads detailed guidance from `validate.md`. |6768## Error Handling6970| Error | Cause | Solution |71|-------|-------|----------|72| Phase mismatch | User requests phase N but state is at phase M | Report current state, suggest correct next phase |73| Missing artifact | Previous phase did not produce expected output | Route back to previous phase |74| Gate failure | Phase requirements not met | Report what failed, suggest fixes |7576## References7778| Task Signal | Load |79|-------------|------|80| Phase routing (design/plan/implement/validate/release) | Phase reference (design.md, plan.md, implement.md, validate.md, release.md) |81| End-to-end or full pipeline | `references/pipeline.md` |82| State commands, directory structure, naming | `references/shared.md` |83| Error, failure, blocked, gate fail, retry, deviation | `references/error-handling.md` |8485- `references/design.md` -- Design phase: explore requirements, discuss trade-offs86- `references/plan.md` -- Plan phase: break design into wave-ordered tasks87- `references/implement.md` -- Implement phase: dispatch tasks to domain agents88- `references/validate.md` -- Validate phase: run quality gates89- `references/release.md` -- Release phase: merge, tag, cleanup90- `references/pipeline.md` -- End-to-end orchestration across all phases91- `references/shared.md` -- State conventions shared across all phases92- `references/error-handling.md` -- Recovery patterns for phase errors, gate failures, agent dispatch failures
notque