What problem does it solve?
Iterative GitHub tasks like fixing failing CI, resolving lint errors, or iterating on pull requests often lead to infinite loops, stacked broken fixes, and unclear completion criteria when handled without structured guardrails.
Core Features & Use Cases
- Structured iterative loop: Organizes multi-step GitHub tasks into a 6-step observe-decide-execute-verify loop with explicit stop conditions.
- Verification guardrails: Distinguishes objective verifiable criteria (CI green, tests passing) from subjective criteria (doc quality, tone) to determine when autonomous looping is appropriate.
- Safety guardrails: Includes maximum attempt limits, stagnation detection to stop repeated failed fixes, and rollback functionality to revert to a known-good state before retrying.
- Use case example: Resolve failing markdownlint CI errors on a PR by reading the exact error, applying a minimal fix, pushing, and re-checking CI until all checks pass or a stagnation threshold is hit.
Quick Start
Use the agentic-loop-github skill to fix the failing CI checks on your current GitHub PR by following the structured iterative loop with explicit stop conditions and safety guardrails.