Plan Feature

Plan Feature

Add a new feature to an existing project by generating new phases and integrating them into IMPLEMENTATION_PHASES.md and SESSION.md.

---

Your Task

Follow these steps to plan and integrate a new feature into an existing project.

1. Check Prerequisites

Check that planning docs exist:

ls SESSION.md docs/IMPLEMENTATION_PHASES.md

**If SESSION.md doesn't exist:**

• Output: "❌ No SESSION.md found. This command is for existing projects."
• Suggest: "For new projects, use /plan-project instead."
• Stop

**If IMPLEMENTATION_PHASES.md doesn't exist:**

• Output: "❌ No IMPLEMENTATION_PHASES.md found."
• Suggest: "Create baseline planning with /plan-project first."
• Stop

Read SESSION.md to extract:

• Current phase number and name
• Current phase status (🔄 in progress, ✅ complete, ⏸️ pending)
• Current stage (Implementation/Verification/Debugging)

Read IMPLEMENTATION_PHASES.md to extract:

• All existing phases
• Last phase number
• Project tech stack

2. Check Current Phase Status

**If current phase is in progress (🔄):**

Output warning:

⚠️ WARNING: Phase [N] - [Name] is in progress.

Current phase status: [Stage]
Progress: [Show task completion from SESSION.md]

Adding a new feature now may cause confusion. Options:

1. Finish current phase first (recommended)
2. Add feature anyway (will append after current phases)
3. Cancel and come back later

Your choice (1/2/3):

**If choice 1 (Finish current phase):**

• Output: "Complete Phase [N] first, then run /plan-feature again."
• Stop

**If choice 2 (Add anyway):**

• Output: "⚠️ Adding feature. New phases will start after Phase [last phase number]."
• Continue

**If choice 3 (Cancel):**

• Output: "Cancelled. Run /plan-feature when current phase is complete."
• Stop

**If current phase is complete (✅) or paused (⏸️):**

• Continue normally

3. Gather Feature Requirements

Ask clarifying questions about the feature:

I'll help plan this feature. A few questions:

1. Feature Description: What does this feature do?
   (Be specific: "Add user profiles with avatar upload" vs "Add profiles")

2. Scope: Is this feature...
   - Small (1-2 phases, ~2-4 hours)
   - Medium (3-4 phases, ~6-10 hours)
   - Large (5+ phases, ~12+ hours)

3. Dependencies: Does this feature require...
   - New database tables/columns?
   - New API endpoints?
   - New UI components?
   - Third-party integrations?
   - All of the above?

4. Priority: When should this feature be built?
   - Immediately after current phase
   - After specific phase: [specify phase number]
   - At the end (append to existing phases)

5. Integration: Does this feature...
   - Modify existing functionality (may require changes to existing phases)?
   - Add completely new functionality (independent phases)?

Wait for user answers.

4. Generate Feature Phases

**Invoke project-planning skill** to generate phases for this feature:

• Provide feature description + requirements from user
• Provide context