issue-grooming

Groom GitHub issues into implementation-ready specs that a human can ship without follow-up questions. Use when a GitHub issue is ambiguous or incomplete and needs: clear scope and non-goals, dependencies, file touchpoints, a step-by-step implementation strategy, a test plan (with explicit test type per scenario), and acceptance criteria. Also use when you need a GitHub-renderable Mermaid diagram (2+ systems/data flows) and a way to sanity-check Mermaid syntax.