Files
architecture/commands/plan-issues.md
Hugo Nijhuis bbd7870483 Configure model settings for commands, agents, and skills
Set explicit model preferences to optimize for speed vs capability:

- haiku: 11 commands, 2 agents (issue-worker, pr-fixer), 10 skills
  Fast execution for straightforward tasks

- sonnet: 4 commands (groom, improve, plan-issues, review-pr),
  1 agent (code-reviewer)
  Better judgment for analysis and review tasks

- opus: 2 commands (arch-refine-issue, arch-review-repo),
  1 agent (software-architect)
  Deep reasoning for architectural analysis

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 00:06:53 +01:00

68 lines
2.4 KiB
Markdown

---
description: Plan and create issues for a feature or improvement. Breaks down work into well-structured issues with vision alignment.
model: sonnet
argument-hint: <feature-description>
context: fork
---
# 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. **Discovery phase**: Before proposing issues, walk through the user workflow:
- Who is the specific user?
- What is their goal?
- What is their step-by-step workflow to reach that goal?
- What exists today?
- Where does the workflow break or have gaps?
- What's the MVP that delivers value?
Present this as a workflow walkthrough before proposing any issues.
7. **Break down** into discrete, actionable issues:
- Derive issues from the workflow gaps identified in discovery
- Each issue should be independently completable
- Clear dependencies between issues
- Appropriate scope (not too big, not too small)
8. **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
Addresses gap: [which workflow gap this solves]
Dependencies: none
2. [Title] - Brief description
Addresses gap: [which workflow gap this solves]
Dependencies: #1
3. [Title] - Brief description
Addresses gap: [which workflow gap this solves]
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)
9. **Ask for approval** before creating issues
10. **Create issues** in dependency order (blockers first)
11. **Link dependencies** using `tea issues deps add <issue> <blocker>` for each dependency
12. **Present summary** with links to created issues and dependency graph