loop-execute

Executes published multi-phase plans autonomously with parallel headless runners and merge orchestration.

1|Updated Nov 25, 2021
One-click install
npx skills add https://github.com/rstagi/dotfile --skill loop-execute-rstagi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: loop-execute
Source: https://github.com/rstagi/dotfile/tree/main/.claude/skills/loop-execute
Command: npx skills add https://github.com/rstagi/dotfile --skill loop-execute-rstagi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Executing a large multi-phase engineering plan by hand means repeatedly spawning agents, monitoring their progress, resolving merge conflicts, and escalating failures — a process that quickly exhausts an interactive chat's context window and demands constant human babysitting. ## Core Features & Use Cases - Autonomous phase execution: Spawns detached headless runners (Codex or Claude) per phase in parallel lanes across separate git worktrees, capped at 3 concurrent, each claiming its own task and reporting via status.json. - Two-tier orchestration: A thin interactive supervise session delegates heavy scheduling, merging, and escalation to self-recycling sub-orchestrators that measure their own token occupancy and hand off before hitting context limits. - Merge and escalation pipeline: Serializes merges into per-repository integration branches, resolves conflicts via dedicated merge-runners, and escalates stuck work through a ladder (retry → stronger model → human-in-the-loop pause). - Use Case: After publishing a multi-phase plan with the multiphase-plan skill, run the loop to have every phase implemented, verified, merged, and reviewed — ending with one draft PR per repository ready for human review. ## Quick Start Ask the assistant to run the loop on the published plan for this project and execute all phases autonomously.

Frequently Asked Questions about loop-execute

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

FAQPage Schema
How do I run a multi-phase plan autonomously with AI agents?

Publish the plan with the multiphase-plan skill so it is registered on the Loop daemon, then invoke loop-execute with the plan. It spawns headless Codex or Claude runners per phase, merges each lane into the repository integration branch, and opens one draft PR per repository.

How does loop-execute avoid filling up the chat context?

It uses two-tier orchestration: the interactive session stays thin and spawns a detached loop-orchestrator that runs disposable sub-orchestrator instances. Each sub measures its own token occupancy from its transcript and recycles via a handoff file before reaching the context ceiling.

Can loop-execute run phases in parallel across repositories?

Yes, it schedules phases in parallel lanes in separate git worktrees, capped at 3 concurrent runners by default. Each phase targets its own repository's integration branch, and merges are serialized globally to avoid conflicts.

What happens when a runner gets stuck or fails?

Failures follow an escalation ladder: transient API errors retry, verify failures relaunch with context, blocked work gets one takeover attempt on a stronger model chain, and unresolvable cases pause only that lane with a human-in-the-loop request while other lanes continue.

When should I not use loop-execute?

Do not use it to implement an in-chat plan yourself — it requires a published plan with a Loop config, per-phase Done-when criteria, and repository verify commands. Small single-phase tasks are better handled directly in the interactive session.