Add vision-driven continuous improvement to product-manager

Transforms the product-manager from a reactive backlog manager into a
vision-driven system with continuous improvement capabilities.

New components:
- vision-management skill: How to create, maintain, and evolve product vision
- /vision command: View, create, or update product vision (syncs to Gitea)
- /improve command: Identify gaps between vision goals and backlog

Enhanced existing components:
- product-manager agent: Now vision-aware with strategic prioritization
- /retro command: Connects learnings back to vision updates
- /plan-issues command: Shows vision alignment for planned work

The vision lives in two places: vision.md (source of truth) and a Gitea
issue labeled "vision" for integration with the issue workflow.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-01-01 21:57:28 +01:00
parent a2c77a338b
commit 9e1ca55196
6 changed files with 386 additions and 17 deletions

View File

@@ -0,0 +1,156 @@
---
name: vision-management
description: Create, maintain, and evolve a product vision. Use when initializing a vision, updating goals, aligning work with vision, or connecting learnings to vision refinement.
---
# Vision Management
How to create, maintain, and evolve a product vision for continuous improvement.
## Vision Document Location
The vision lives in two places:
1. **`vision.md`** at repo root - Source of truth, versionable
2. **Gitea issue** labeled `vision` - Integrates with issue workflow
Keep these in sync. The file is authoritative; the issue mirrors it.
## Vision Document Structure
```markdown
# Product Vision
## Purpose
Why this product exists. The problem it solves.
## Goals
1. [Goal 1] - [Success metric]
2. [Goal 2] - [Success metric]
3. [Goal 3] - [Success metric]
## Current Focus
What we're prioritizing now and why.
## Non-Goals
What we're explicitly NOT doing.
## Progress
- [Goal 1]: [Status/progress]
- [Goal 2]: [Status/progress]
## Last Updated
[Date] - [What changed]
```
## Creating a Vision
When no vision exists:
1. **Identify the purpose**: What problem does this product solve? Who benefits?
2. **Define 3-5 goals**: Concrete, measurable outcomes
3. **Set success metrics**: How will you know each goal is achieved?
4. **Choose current focus**: Which 1-2 goals are priorities right now?
5. **Document non-goals**: What are you explicitly NOT doing?
### Good Goals
- Specific and measurable
- Outcome-focused (not activity-focused)
- Have clear success criteria
| Bad | Good |
|-----|------|
| "Improve performance" | "Page load under 2 seconds" |
| "Better UX" | "User can complete checkout in under 60 seconds" |
| "More features" | "Support 3 export formats (CSV, JSON, PDF)" |
## Updating the Vision
Update the vision when:
- A goal is achieved (update progress, possibly add new goal)
- Learnings from retros reveal new priorities
- Strategic direction changes
- A non-goal becomes a goal (or vice versa)
### Update Process
1. Read current vision
2. Identify what needs to change
3. Draft the update
4. Present changes for approval
5. Update `vision.md`
6. Sync to Gitea issue
## Aligning Issues with Vision
When creating or reviewing issues:
1. **Check goal alignment**: Does this issue support a vision goal?
2. **Tag appropriately**: Reference the goal in the issue description
3. **Prioritize by vision**: Issues supporting current focus get priority
4. **Flag misalignment**: Issues that don't align with any goal need justification
### Alignment Check Template
```markdown
## Vision Alignment
Supports: Goal 2 (Security)
Priority: High (current focus area)
```
### Identifying Gaps
Compare vision goals to current backlog:
- Which goals have no supporting issues?
- Which goals have stalled (no recent progress)?
- Are there issues that don't align with any goal?
## Connecting Retros to Vision
After a retrospective:
1. **Review learnings**: Any that affect the vision?
2. **Goal changes**: Should any goals be added, removed, or modified?
3. **Non-goal additions**: Did we learn something we should explicitly avoid?
4. **Progress updates**: Did completed work advance any goals?
### Retro-to-Vision Questions
- "Did this work reveal a new priority we should add as a goal?"
- "Did we learn something that should become a non-goal?"
- "Should our current focus shift based on what we learned?"
- "Did this work make progress on any goals?"
## Vision Issue in Gitea
Create/update a Gitea issue that mirrors the vision:
```bash
# Create vision issue
tea issues create --title "Product Vision" --description "$(cat vision.md)" --labels "vision"
# Update existing vision issue
tea issues edit <issue-number> --description "$(cat vision.md)"
```
Benefits of the vision issue:
- Other issues can reference it (`Supports #N`)
- Visible in backlog alongside work items
- Provides discussion space for vision questions
## Continuous Improvement Loop
```
Vision → Issues → Work → Retro → Vision (updated)
```
1. **Vision** defines what success looks like
2. **Issues** are created to achieve vision goals
3. **Work** implements the issues
4. **Retros** capture learnings from the work
5. **Vision updates** incorporate learnings (loop continues)
The vision is a living document that evolves as you learn.