goal-alignment

# Goal-Alignment Skill

## Purpose

This skill implements Shannon Framework's quantitative goal-wave alignment validation system. It calculates 0-100% alignment scores between wave deliverables and goal milestones, detects scope drift, and enforces goal consistency throughout wave execution.

**Core Value**: Prevents wasted effort by ensuring every wave delivers against actual goal milestones, not assumed requirements.

## When to Use

Use this skill in these situations:

**MANDATORY (Must Use)**:
- Before wave execution (pre-wave validation)
- After wave completion (post-wave verification)
- When user adds features mid-project (scope drift detection)
- When wave plan created (validate wave-goal alignment)

**RECOMMENDED (Should Use)**:
- Complex projects (complexity >= 0.50)
- Multi-wave projects (>= 3 waves)
- Projects with vague initial goals

**CONDITIONAL (May Use)**:
- Single-wave projects (for goal clarity validation)
- Retrospective analysis (alignment trending over time)

DO NOT rationalize skipping goal-alignment because:
- ❌ "This wave is obviously aligned" → Assumptions cause drift
- ❌ "Goal is simple, no validation needed" → Simple goals still drift
- ❌ "Alignment check is overhead" → 30 seconds vs hours of rework
- ❌ "We're close enough" → "Close" = partial credit = incomplete milestone
- ❌ "User didn't ask for validation" → Alignment is framework responsibility

## Core Competencies

1. **Alignment Scoring**: Calculates 0-100% score between wave deliverables and goal milestones
2. **Drift Detection**: Identifies when waves diverge from goal structure
3. **Scope Monitoring**: Alerts on implicit goal expansion (features not in milestones)
4. **Qualitative Quantification**: Forces vague goals into measurable criteria
5. **Pre/Post Wave Validation**: Quality gates before and after wave execution
6. **Recommendation Engine**: Suggests continue/adjust/halt based on alignment score

## Inputs

**Required:**
- `mode` (string): Operation mode
  - `"validate"`: