Hugo Nijhuis
d980a0d0bc
Update documentation and apply new frontmatter capabilities: Documentation: - Add user-invocable, context, agent, hooks fields to writing-skills.md - Add disallowedTools, permissionMode, hooks fields to writing-agents.md - Add model, context, hooks, allowed-tools fields to writing-commands.md - Document skill hot-reload, built-in agents, background execution Skills: - Add user-invocable: false to gitea (CLI reference) - Add user-invocable: false to repo-conventions (standards reference) Commands: - Add context: fork to heavy exploration commands (improve, plan-issues, create-repo, update-claude-md) - Add missing argument-hint to roadmap, manifesto, improve Agents: - Add disallowedTools: [Edit, Write] to code-reviewer for safety Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
85 lines
2.4 KiB
Markdown
85 lines
2.4 KiB
Markdown
---
|
|
description: Identify improvement opportunities based on product vision. Analyzes gaps between vision goals and current backlog.
|
|
argument-hint:
|
|
context: fork
|
|
---
|
|
|
|
# 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
|