| name | ghm-status-sync |
| description | Synchronizes README.md Command Center with current project state. Triggers on gate changes, EPIC status changes, or explicit `/ghm-status-sync` invocation. Outputs updated README.md dashboard with current lifecycle stage, blockers, and metrics.
|
| context | inline |
| allowed-tools | ["Read","Write","Edit","Glob","Grep"] |
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
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
Testability Check
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
