feature-dev

name	feature-dev
description	Feature development workflow — explore, plan, implement, verify. Use when adding a non-trivial feature. NOT for single-file bug fixes (use fix-bug).

Feature Development Workflow

Structured workflow for implementing a new feature.

Arguments

• $ARGUMENTS — feature name/description

Workflow

Phase 1: Explore

Use 3-5 parallel subagents to explore the areas of the codebase relevant to this feature. Do NOT read code directly in the main context — delegate to subagents. Summarize findings before proceeding.

Phase 2: Spec

Enter plan mode. Draft the implementation plan:

• Files to create/modify
• Dependencies affected
• Test strategy
• Risk assessment

Present the plan and wait for user approval before proceeding.

Phase 3: Implement

• Work through the plan step by step
• Use subagents for independent subtasks (with worktree isolation if needed)
• Verify each step compiles/passes before moving on
• Run relevant tests after each significant change

Phase 4: Verify

Launch verification subagents in parallel:

1. Correctness — do the changes work as intended?
2. Edge cases — what could break?
3. Quality — code style, naming, complexity
4. Integration — python3 scripts/validate_schema.py --all still passes?

Phase 5: Record

• Update CLAUDE.md if any new conventions or gotchas were discovered
• Summarize what was done and any follow-up items