Files

Use Gitea milestones for goal tracking instead of vision issue

Refactored the vision system to separate concerns:
- vision.md remains the stable "north star" philosophy document
- Gitea milestones now track goals with automatic progress via issue counts
- Updated /vision, /retro, and /create-issue commands to auto-assign milestones

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-01 22:22:06 +01:00

2.1 KiB

Raw Blame History

description, argument-hint

description

argument-hint

View the product vision and goal progress. Manages vision.md and Gitea milestones.

goals

Product Vision

@~~/.claude/skills/vision-management/SKILL.md @~~/.claude/skills/gitea/SKILL.md

Architecture

The vision system has two layers:

Layer	Purpose	Location
vision.md	North star philosophy (why, principles, non-goals)	File in repo root
Milestones	Goals with progress tracking	Gitea milestones

Issues are assigned to milestones. Progress is visible through milestone completion.

Process

Check for existing vision: Look for vision.md in the current repo root.
If no vision exists:
- Ask the user if they want to create one
- Guide them through the philosophy: purpose, principles, non-goals
- Create vision.md (do NOT include goals/progress - that's milestones)
- Ask about initial goals and create them as Gitea milestones
If vision exists:
- Display the vision philosophy from vision.md
- Show current milestones and their progress: tea milestones
- Check if $1 specifies an action:
  - goals: Manage milestones (add, close, view progress)
- If no action specified, just display the current state

Managing Goals (milestones):

# List milestones with progress
tea milestones

# Create a new goal
tea milestones create --title "<goal>" --description "<success criteria>"

# View issues in a milestone
tea milestones issues <milestone-name>

# Close a completed goal
tea milestones close <milestone-name>

Output Format

## Vision

[Summary of vision.md purpose/principles]

## Goals (Milestones)

| Goal | Progress | Due |
|------|----------|-----|
| [title] | 3/5 issues | [date] |

## Current Focus

[Open milestones with nearest due dates or most activity]

Guidelines

vision.md is the stable "why" document - update rarely
Milestones are the actionable goals - create/close as needed
Assign issues to milestones to track progress
Use milestone descriptions for success criteria
Due dates on milestones are optional but help prioritization

2.1 KiB Raw Blame History