loop-driver

Orchestrate autonomous development loops with CI-gated merge control.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/eumemic/dev-skills --skill loop-driver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loop-driver
Source: https://github.com/eumemic/dev-skills/tree/main/skills/loop-driver
Command: npx skills add https://github.com/eumemic/dev-skills --skill loop-driver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It standardizes an autonomous development loop that turns a candidate target into a shipped, CI-green change with an iteration retrospective and safe merge control.

Core Features & Use Cases

  • Shared loop skeleton: Implements the common phases for autonomous iterations, including branch/plan, handoff to ship, an iteration-scoped /retro pass, merge handling, and loop re-arming or escalation.
  • Quality gate for “nothing to ship” outcomes: Prevents shipping borderline work by treating “found something but not worth it” as a healthy iteration result, using the specialization’s Phase 1.5 bar.
  • Operational safety invariants: Enforces one-change-per-PR and blocks merges before CI is green, with explicit pass-through of loop flags on re-wake.
  • Use Case: Keep a repo’s engineering throughput moving by repeatedly selecting the next high-ROI target (issue label queue, complexity reduction audit, or risk/provability-driven bug hunting) and driving it through ship → retro → merge until idle escalation triggers.

Quick Start

Use the loop-driver indirectly by invoking one of its specializations (such as shovel-ready, kaizen, or bughunt) rather than calling loop-driver directly.

Frequently Asked Questions about loop-driver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate a development loop with CI monitoring and quality gates for GitHub pull requests?

Automating an autonomous development loop with CI monitoring uses a shared driver to enforce quality gates, branch orchestration, and safe merge control for GitHub pull requests. It standardizes iterations by blocking merges before CI is green and enforcing a strict one-change-per-PR invariant.

What is an autonomous development loop and when do I need quality gates for agent handoffs?

An autonomous development loop turns a candidate target into a shipped, CI-green change with retrospectives and safe merge control. You need quality gates for agent handoffs when running multi-phase autonomous workflows to enforce operational invariants like one-change-per-PR and branch orchestration.

How do I enforce a no merge before CI green policy across automated pull requests?

To enforce a no merge before CI green policy across automated pull requests, an autonomous loop driver applies strict operational safety invariants during merge handling. It explicitly passes through loop flags on re-wake to maintain deterministic scheduling behavior.

Can I run a single autonomous development iteration instead of a continuous loop?

You can run a single autonomous development iteration instead of a continuous loop by utilizing deterministic scheduling flags like --once. This executes one complete phase of branching, shipping, retrospectives, and CI-gated merge control without re-arming the loop.

How do I handle a "nothing to ship" outcome during an autonomous iteration retro?

Handling a "nothing to ship" outcome during an iteration retro treats finding borderline work as a healthy iteration result. The autonomous loop driver prevents shipping borderline work by enforcing the specialization's Phase 1.5 bar, safely concluding the cycle.

Do I need a specific target acquisition tool to use the autonomous loop driver?

You need a specialization tool for target acquisition to use the autonomous loop driver. It should be invoked indirectly through specializations like shovel-ready, kaizen, or bughunt, which supply target acquisition and implementation discipline while the shared driver enforces quality gates and invariants.