---
description: Plan and create issues for a feature or improvement. Breaks down work into well-structured issues with vision alignment.
argument-hint: <feature-description>
---

# Plan Feature: $1

@~/.claude/skills/gitea/SKILL.md
@~/.claude/skills/roadmap-planning/SKILL.md
@~/.claude/skills/issue-writing/SKILL.md
@~/.claude/skills/vision-management/SKILL.md

1. **Check vision context**: If `vision.md` exists, read it to understand personas, jobs to be done, and goals
2. **Identify persona**: Which persona does "$1" serve?
3. **Identify job**: Which job to be done does this enable?
4. **Understand the feature**: Analyze what "$1" involves
5. **Explore the codebase** if needed to understand context
6. **Break down** into discrete, actionable issues:
   - Each issue should be independently completable
   - Clear dependencies between issues
   - Appropriate scope (not too big, not too small)

7. **Present the plan** (include vision alignment if vision exists):
   ```
   ## Proposed Issues for: $1

   For: [Persona name]
   Job: "[Job to be done this enables]"
   Supports: [Milestone/Goal name]

   1. [Title] - Brief description
      Dependencies: none

   2. [Title] - Brief description
      Dependencies: #1

   3. [Title] - Brief description
      Dependencies: #1, #2
   ```

   If the feature doesn't align with any persona/job/goal, note this and ask if:
   - A new persona or job should be added to the vision
   - A new milestone should be created
   - This should be added as a non-goal
   - Proceed anyway (with justification)

8. **Ask for approval** before creating issues
9. **Create issues** in dependency order (blockers first)
10. **Link dependencies** using `tea issues deps add <issue> <blocker>` for each dependency
11. **Present summary** with links to created issues and dependency graph