prd-hygiene

What problem does it solve?

Normalize a PRD-derived GitHub backlog into a strict native GitHub graph so Ralph can follow it deterministically. Audits every epic's acceptance criteria against its child tasks to identify coverage gaps — AC items with no task are silent black holes that no agent will ever work on. Creates missing tasks, sharpens vague task AC, and wires everything with native sub-issues and blockedBy links. Use immediately after grill-me, write-a-prd, and prd-to-issues, or whenever a repo has PRD/epic/task issues still held together by prose instead of native links. Reach for this skill when the user wants Ralph to "just follow the graph", asks to clean up backlog hygiene, wants ordering or blockers wired correctly, mentions AC coverage gaps, or says the next task should be mechanically obvious even if they do not mention "hygiene" by name.

Core Features & Use Cases

• Identify the target kind:prd issue and classify issues as kind:prd, kind:epic, or kind:task to reflect a clean hierarchy.
• Audit AC coverage for each epic, create missing tasks for uncovered acceptance criteria, and sharpen vague AC details so work is actionable.
• Wire native GitHub relationships: create sub-issue links, establish blockedBy edges, and enforce deterministic sibling ordering for a single obvious next task.
• Improve execution discipline by building a trustworthy graph that Ralph can follow end-to-end, then report the exact next task.

Quick Start

Use the prd-hygiene skill to normalize the backlog into a deterministic, execution-ready native graph and wire blockers.