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>
2.4 KiB
2.4 KiB
description, argument-hint, context
| description | argument-hint | context |
|---|---|---|
| Identify improvement opportunities based on product vision. Analyzes gaps between vision goals and current backlog. | 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
-
Read the vision: Load
vision.mdfrom the repo root.- If no vision exists, suggest running
/visionfirst
- If no vision exists, suggest running
-
Fetch current backlog: Get all open issues from Gitea using
tea issues -
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?
-
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
-
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] -
Offer to take action:
For unsupported goals:
- Ask if user wants to plan issues for the gap
- If yes, run the
/plan-issuesworkflow 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