create-feature-plan

Create Feature Plan

Required for any feature, refactor, or multi-step development — no exceptions.

Location

docs/planning/ with filename FEATURE_NAME_PLAN.md (SCREAMING_SNAKE_CASE).

Subfolders

• completed/ — move finished plans here
• testing/ — plans in testing / validation
• backlog/ — plans queued but not active
• docs-archive/ — archived reference documentation

The canonical template lives at docs/planning/TEMPLATE.md.

Template (copy into the new file)

# [Feature Name] Plan

**Status:** Planning | In Progress | Complete
**Created:** YYYY-MM-DD
**Last Updated:** YYYY-MM-DD

## Overview
Brief description of what this feature/refactor accomplishes.

## Approach
High-level strategy and key decisions.

## Milestones

- [ ] Milestone 1: Description
- [ ] Milestone 2: Description
- [ ] Milestone 3: Description

## Progress Log

### YYYY-MM-DD
- What was done
- Blockers encountered
- Next steps

## Files Changed
List of files created/modified (update as work progresses).

## Testing
How this will be tested; link to test files when complete.

## Notes
Open questions, alternatives considered, lessons learned.

After scaffolding

1. Update the Jira ticket (Task / Bug) with a link to the plan file.
2. Run /unleashed-mail:gemini-review and /unleashed-mail:codex-review on the plan before any code is written.
3. Incorporate reviewer feedback into the plan doc before the implementation batch begins.