90 lines
2.5 KiB
Markdown
90 lines
2.5 KiB
Markdown
---
|
|
name: improve
|
|
description: >
|
|
Identify improvement opportunities based on product vision. Analyzes gaps between
|
|
vision goals and current backlog. Use when analyzing alignment, finding gaps, or
|
|
when user says /improve.
|
|
model: sonnet
|
|
context: fork
|
|
user-invocable: true
|
|
---
|
|
|
|
# Improvement Analysis
|
|
|
|
@~/.claude/skills/vision-management/SKILL.md
|
|
@~/.claude/skills/gitea/SKILL.md
|
|
@~/.claude/skills/issue-writing/SKILL.md
|
|
@~/.claude/skills/roadmap-planning/SKILL.md
|
|
|
|
## Process
|
|
|
|
1. **Read the vision**: Load `vision.md` from the repo root.
|
|
- If no vision exists, suggest running `/vision` first
|
|
|
|
2. **Fetch current backlog**: Get all open issues from Gitea using `tea issues`
|
|
|
|
3. **Analyze alignment**:
|
|
|
|
For each vision goal, check:
|
|
- Are there issues supporting this goal?
|
|
- Is there recent activity/progress?
|
|
- Are issues blocked or stalled?
|
|
|
|
For each open issue, check:
|
|
- Does it align with a vision goal?
|
|
- Is it supporting the current focus?
|
|
|
|
4. **Identify gaps and opportunities**:
|
|
|
|
- **Unsupported goals**: Vision goals with no issues
|
|
- **Stalled goals**: Goals with issues but no recent progress
|
|
- **Orphan issues**: Issues that don't support any goal
|
|
- **Focus misalignment**: Issues not aligned with current focus getting priority
|
|
- **Missing non-goals**: Patterns suggesting things we should explicitly avoid
|
|
|
|
5. **Present findings**:
|
|
|
|
```
|
|
## Vision Alignment Report
|
|
|
|
### Goals Coverage
|
|
- Goal 1: [status] - N issues, [progress]
|
|
- Goal 2: [status] - N issues, [progress]
|
|
|
|
### Gaps Identified
|
|
1. [Gap description]
|
|
Suggestion: [concrete action]
|
|
|
|
2. [Gap description]
|
|
Suggestion: [concrete action]
|
|
|
|
### Orphan Issues
|
|
- #N: [title] - No goal alignment
|
|
|
|
### Recommended Actions
|
|
1. [Action with rationale]
|
|
2. [Action with rationale]
|
|
```
|
|
|
|
6. **Offer to take action**:
|
|
|
|
For unsupported goals:
|
|
- Ask if user wants to plan issues for the gap
|
|
- If yes, run the `/plan-issues` workflow for that goal
|
|
- This breaks down the goal into concrete, actionable issues
|
|
|
|
For other findings:
|
|
- Re-prioritize issues based on focus
|
|
- Close or re-scope orphan issues
|
|
- Update vision with suggested changes
|
|
|
|
Always ask for approval before making changes.
|
|
|
|
## Guidelines
|
|
|
|
- Focus on actionable improvements, not just observations
|
|
- Prioritize suggestions by impact on vision goals
|
|
- Keep suggestions specific and concrete
|
|
- One issue per improvement (don't bundle)
|
|
- Reference specific goals when suggesting new issues
|