loop-grill

What problem does it solve?

Dev loops often stall or require rework when GitHub issues or local plan files lack clear acceptance criteria, defined scope boundaries, identified primary actors, or documentation of irreversible decisions. This Skill surfaces these underspecified gaps before implementation begins, reducing wasted effort and rework.

Core Features & Use Cases

• Dual input support: Run gap checks on GitHub issues (tracker-first) or local plan files (local-planning) to match your workflow.
• Flexible gap resolution: Choose interactive Socratic Q&A for human-led clarification, or auto-answer mode that pulls evidence from your codebase, docs, and repository context to resolve gaps without prompting.
• Idempotent write-back: Writes structured findings directly back to the source artifact, with guards to avoid duplicate sections on re-runs.
• Use Case: You have a GitHub issue for a new payment processing feature with no acceptance criteria. Run loop-grill to surface the missing criteria, get clarifying answers, and write findings back to the issue before starting the dev loop.

Quick Start

Use the loop-grill skill to run a pre-loop gap check on GitHub issue 42 or your local feature plan file.