Sprint Sync

Overview

This skill provides comprehensive project context from four leadership perspectives. Unlike the previous append-only approach, this skill now updates the Current Status section in context/PROJECT_STATE.md to keep context files manageable.

When to Use This Skill

Activate when the user:

• Says "sprint sync", "/sprint-sync", or "sync me up"
• Starts a new session and needs context
• Asks "where are we?" or "what's the status?"
• Wants to understand current priorities
• Says "onboard me" or "catch me up"

Invocation Modes

Execution Steps

Phase 0: Gather Context

Read this file first:

Run these commands:

git log --oneline -10                    # Recent commits
npm run test 2>&1 | tail -20             # Test status
npm run build 2>&1 | tail -10            # Bundle size

Phase 1: Generate Briefing

Output the briefing to the user with multi-perspective analysis.

Quick Mode Output:

## Sprint Sync — [YYYY-MM-DD]

**Status**: [X]% ready | **Bundle**: [X]KB | **Tests**: [X] passing

### PM View
- **Phase**: [current phase]
- **Focus**: [current objective]
- **Blockers**: [P0 items]

### Architect View
- **Tests**: [passing/failing]
- **Bundle**: [size] (target <200KB)
- **Debt**: [top items]

### Engineer View
- **Last 5 commits**: [summary]
- **Working**: [recent wins]
- **Attention**: [blockers]

### Recommended Actions
1. [P0 priority]
2. [P0 priority]
3. [Next item]

Phase 2: Update PROJECT_STATE.md

CRITICAL: Update the "Current Status" section in context/PROJECT_STATE.md.

Process:

1. Read current PROJECT_STATE.md
2. Find the ### Current Status section (in Part VI)
3. Replace the content between ### Current Status and the next ### Session: header
4. Write updated file

Current Status Format:

### Current Status

**Date**: YYYY-MM-DD
**Objective**: [current focus from analysis]
**Bundle**: [X]KB (target <200KB)
**Tests**: [X] passing, [X] failing
**Variants**: [X] active

**Blockers**:
1. [Most critical blocker]
2. [Second blocker if any]

**Recent Wins**:
- [Win 1]
- [Win 2]
- [Win 3]

Phase 3: Add Session Entry (if significant work done)

If the sync reveals significant changes since last session, add a new session entry:

### Session: [Month Day, Year] — [Brief Title]

**Summary**: [1-2 sentences]

**Changes**:
- [Key change 1]
- [Key change 2]

**Next**: [What to do next]

Rules for session entries:

• Only add if there are NEW commits since last session
• Keep only last 3 sessions in PROJECT_STATE.md
• Archive older sessions to docs/history/session-archive.md

Hardcore Mode (--hardcore)

When --hardcore flag is present:

1. Run ALL four deep dives (PM, Design, Arch, Eng)
2. Generate ASCII diagrams for visual context
3. Cross-reference findings between perspectives
4. Generate comprehensive action plan
5. Include risk assessment matrix

ASCII Diagrams (output to user, not saved):

┌─ ROADMAP STATUS ─────────────────────────────────────────────────────────────┐
│  Phase 1: Foundation    ████████████████████ 100%  COMPLETE                  │
│  Phase 2: Polish        ████████████████████ 100%  COMPLETE                  │
│  Phase 3: Social        ████████████░░░░░░░░  60%  IN PROGRESS               │
│  Phase 4: Performance   ░░░░░░░░░░░░░░░░░░░░   0%  BLOCKED                   │
└──────────────────────────────────────────────────────────────────────────────┘

┌─ PRIORITY MATRIX ────────────────────────────────────────────────────────────┐
│               │  LOW EFFORT   │  MED EFFORT   │  HIGH EFFORT  │              │
│  ─────────────┼───────────────┼───────────────┼───────────────┤              │
│  HIGH IMPACT  │ ★ Code Split  │               │               │              │
│               │ ★ Lazy Load   │               │               │              │
│  ─────────────┼───────────────┼───────────────┼───────────────┤              │
│  MED IMPACT   │               │ Testimonials  │ Scroll Story  │              │
│  ─────────────┼───────────────┼───────────────┼───────────────┤              │
│  LOW IMPACT   │ Dead Code     │ Style Refactor│               │              │
└──────────────────────────────────────────────────────────────────────────────┘

File Locations Reference

Key Differences from Previous Version

Notes

• Always run tests and build to get current metrics
• Update Current Status, don't append
• Keep session log compact (last 3 sessions only)
• ASCII diagrams are for user display, not saved to file
• Archive old sessions when adding new ones