edwluo/designing-loops — explained in plain English
Analysis updated 2026-05-18
Let Claude Code pick the right loop type when you ask it to babysit a pull request overnight.
Get a ready-to-run prompt with clear stop conditions instead of a vague open-ended task.
Generate a runbook file to track state during a long autonomous run.
Have Claude tell you when a task is really one turn of work, not a loop, to avoid wasted runs.
| edwluo/designing-loops | 0xknowles/ruby | 0xrphl/solar-crypto-mining-farm-maximization-control | |
|---|---|---|---|
| Stars | 6 | 6 | 6 |
| Language | — | C++ | C++ |
| Setup difficulty | easy | moderate | hard |
| Complexity | 1/5 | 4/5 | 5/5 |
| Audience | developer | researcher | ops devops |
Figures from each repo's GitHub metadata at analysis time.
This project is a skill for Claude Code, the AI coding assistant, that helps it decide how to structure a long-running or repeated task and write stop conditions that actually work. When you ask Claude Code to babysit a pull request, run something overnight, or fix a long list of errors, this skill kicks in behind the scenes to figure out which of four loop types fits the job, then writes a ready-to-run plan that includes clear conditions for when the work is finished. The four loop types it chooses between are turn-based, goal-based, time-based, and proactive, an idea drawn from the Claude Code team's own writing on the subject. The skill adds practical lessons learned from watching real multi-hour autonomous runs and checking afterward whether they actually did what they claimed. Its core advice includes always writing the stop condition first, since a number is more reliable than a vague description, and making sure every loop can stop either on success or on a bounded failure. It also warns against letting a long-running task quietly redefine what counts as done under pressure, and recommends that heavier overnight jobs keep their state in a saved file rather than only in the prompt, using a template the project provides. Installation is a single git clone command into a specific Claude Code skills folder. Once installed, the skill also knows when a task is not actually loop-shaped, such as polishing a README, and will say so rather than forcing an unnecessary repeated process. The project is released under the MIT license, so it can be freely used, copied, and modified.
A Claude Code skill that picks the right kind of repeating task and writes stop conditions that actually hold, based on real overnight runs.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.