What problem does it solve? Story markdown files can drift out of sync with their actual workflow status, making it hard to visually scan document state. This Skill keeps the H1 heading emoji of each legacy Story .md file aligned with its status field after create-story, dev-story, or code-review workflows run. ## Core Features & Use Cases - Status-Emoji Mapping: Maps workflow states (backlog, ready-for-dev, in-progress, review, done) and decision states (cancelled, superseded, split, cancelled-merged) to standard emoji in the H1 heading. - Compound Tech Debt Markers: Applies the 🟢🚧 compound marker when a done Story has pending entries in tech-debt/registry.yaml, reverting to 🟢 once all debt resolves. - Single-File and Batch Modes: Updates one Story file after a workflow status change, or batch-scans all Story files under docs/implementation-artifacts/stories to fix mismatches. - Use Case: After code-review approves Story QGR-E6 with deferred tech debt, the heading is updated from 🟠 to 🟢🚧 so the pending debt is visible at a glance. ## Quick Start Ask the AI to run the story-status-emoji skill in batch mode to synchronize all Story file heading emoji with their status fields.
