goal-management

# Goal Management Skill

## Purpose

This skill implements Shannon Framework's North Star goal tracking system through structured goal parsing, progress monitoring, and Serena MCP persistence. It transforms vague aspirations into measurable objectives and ensures goals survive context compaction.

**Core Value**: Guarantees goal alignment across multi-session projects by maintaining persistent, measurable goal state with history tracking.

## When to Use

Use this skill in these situations:

**MANDATORY (Must Use)**:
- User provides project specification with goals (parse immediately)
- User asks "What's our goal?" or "What's our progress?"
- Before wave execution (validate wave aligns with goal)
- After wave completion (update goal progress)
- During checkpoint creation (include goal state)

**RECOMMENDED (Should Use)**:
- User sets multiple concurrent goals (establish priority)
- Complex projects (complexity ≥ 0.50) needing North Star
- Multi-session projects (goal persistence critical)
- When goal clarity is low (parse and validate)

**CONDITIONAL (May Use)**:
- User requests goal history review
- Retrospective analysis (velocity, patterns)
- Goal completion ceremonies

DO NOT rationalize skipping goal management because:
- ❌ "This goal is simple and obvious" → Vague goals lead to drift
- ❌ "I'll remember the goal" → Context compaction erases memory
- ❌ "User didn't explicitly ask for tracking" → Goal tracking is Shannon infrastructure
- ❌ "Goal is already clear" → Parsing adds structure and measurement
- ❌ "Only one goal, no need to store" → Even single goals need persistence

## Core Competencies

1. **Goal Parsing**: Converts vague goals into structured format with measurable criteria
2. **Progress Tracking**: Calculates completion percentages based on milestone status
3. **Serena Storage**: Persists goals to shannon/goals namespace with rich metadata
4. **Priority Management**: Supports multiple goals with North Star designation
5. **History Tracking**: Maint