OpenSkillIndex← back to search
claude-codedevelopment

Claude-skill-registry ghm-status-sync

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/ghm-status-sync" ~/.claude/skills/majiayu000-claude-skill-registry-ghm-status-sync && rm -rf "$T"
manifest: skills/data/ghm-status-sync/SKILL.md
tags
#readme-sync#project-state#lifecycle-tracking#status-updates
source content

Status Sync

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

Workflow Overview

  1. Load Context → Read README.md, PRD.md metadata, Active EPIC Section 0
  2. Extract State → Pull lifecycle stage, blockers, metrics
  3. Update Dashboard → Sync README sections with current truth

Core Output Template

ElementDefinitionEvidence
Lifecycle StageCurrent PRD version from PRD.md
Current Lifecycle Gate: v0.X
Gate StatusVisual progress indicators🟢 Complete / 🟡 In Progress / ⚪ Pending
Active EPICCurrent work from EPIC header
EPIC-XX: Title
BlockersOpen blockers from EPIC Section 0List with severity

Step 1: Load Context

Read these files in order:

  1. README.md
    (current state)
  2. PRD.md
    (metadata block for lifecycle stage)
  3. Active EPIC Section 0 (blockers, progress)

Checklist

  • README.md loaded
  • PRD.md metadata extracted
  • Active EPIC identified and Section 0 read

Step 2: Extract Current State

Pull authoritative values:

FieldSource
Lifecycle StagePRD.md 
Current Lifecycle Gate
Gate ProgressPRD.md gate table
Active EPICREADME.md 
Active Work
section
BlockersEPIC Section 0
MetricsREADME.md Truth Table

Step 3: Update README Dashboard

Apply synchronization rules:

  1. Lifecycle Stage: Update header to match PRD.md
  2. Gate Table:
    • 🟢 = Passed gates (all criteria met)
    • 🟡 = Current gate (in progress)
    • ⚪ = Future gates (not started)
  3. Active EPIC: Update metadata in Active Work section
  4. Blockers: Sync from EPIC Section 0

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

PatternExampleFix
Stale gate status🟢 on gate with missing criteria→ Verify all criteria before marking complete
Missing blockersEPIC has blockers, README shows none→ Always sync from EPIC Section 0
Wrong EPIC referenceREADME 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