Ghm Status Sync Skill for Claude

Status Sync

Synchronize the README.md Command Center with the current project state after gate advancement or EPIC status changes.

Workflow Overview

• Load Context → Read README.md, PRD.md metadata, Active EPIC Session State section
• Extract State → Pull lifecycle stage, blockers, metrics
• Update Dashboard → Sync README sections with current truth

Core Output Template

| Element | Definition | Evidence |

|---------|------------|----------|

| Lifecycle Stage | Current PRD version from PRD.md | Current Lifecycle Gate: v0.X |

| Gate Status | Visual progress indicators | 🟢 Complete / 🟡 In Progress / ⚪ Pending |

| Active EPIC | Current work from EPIC header | EPIC-XX: Title |

| Blockers | Open blockers from EPIC Session State section | List with severity |

Step 1: Load Context

Read these files in order:

• README.md (current state)
• PRD.md (metadata block for lifecycle stage)
• Active EPIC Session State section (blockers, progress)

Checklist

• [ ] README.md loaded
• [ ] PRD.md metadata extracted
• [ ] Active EPIC identified and Session State section read

Step 2: Extract Current State

Pull authoritative values:

| Field | Source |

|-------|--------|

| Lifecycle Stage | PRD.md Current Lifecycle Gate |

| Gate Progress | PRD.md gate table |

| Active EPIC | README.md Active Work section |

| Blockers | EPIC Session State section |

| Metrics | README.md Truth Table |

Step 3: Update README Dashboard

Apply synchronization rules:

• Lifecycle Stage: Update header to match PRD.md
• Gate Table:
• 🟢 = Passed gates (all criteria met)
• 🟡 = Current gate (in progress)
• ⚪ = Future gates (not started)
• Active EPIC: Update metadata in Active Work section
• Blockers: Sync from EPIC Session State section
• Squad Status (Section: squad-status): Update agent and EPIC tables:
• For each agent in .claude/agents/: check MEMORY.md mtime for "Last Active", grep EPICs for agent name for "Current EPIC"
• For each EPIC in epics/: read State field, Epic Lead, and Change Log last date
• Status values: active (session <2h old), idle (no recent activity), blocked (blocker in session state)

Quality Gates

Pass Checklist

• [ ] README lifecycle stage matches PRD.md
• [ ] Gate indicators are accurate (no 🟢 on incomplete gates)
• [ ] Active EPIC reference is current
• [ ] Blockers reflect actual state

Testability Check

• [ ] Can be validated by comparing README to PRD.md
• [ ] Gate status is traceable to gate criteria

Anti-Patterns

| Pattern | Example | Fix |

|---------|---------|-----|

| Stale gate status | 🟢 on gate with missing criteria | → Verify all criteria before marking complete |

| Missing blockers | EPIC has blockers, README shows none | → Always sync from EPIC Session State section |

| Wrong EPIC reference | README points to closed EPIC | → Check EPIC status before updating |

Boundaries

DO:

• Status synchronization
• Link updates
• Gate progression indicators

DON'T:

• Content changes to descriptions
• Create new sections
• Modify PRD.md (read-only source)

Handoff

After status sync completes:

• README.md is current and accurate
• Ready for next work session
• Gate-check skill can validate if advancing