architecture/skills/improve/SKILL.md

name, description, model, context, user-invocable

name	description	model	context	user-invocable
improve	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.	sonnet	fork	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