whatisgithub

What is designing-loops?

edwluo/designing-loops — explained in plain English

Analysis updated 2026-05-18

6Audience · developerComplexity · 1/5LicenseSetup · easy

In one sentence

A Claude Code skill that picks the right kind of repeating task and writes stop conditions that actually hold, based on real overnight runs.

Mindmap

mindmap
  root((designing loops))
    What it does
      Picks right loop type
      Writes stop conditions
      Generates runbooks
    Loop types
      Turn based
      Goal based
      Time based
      Proactive
    Use cases
      Babysit a pull request
      Overnight autonomous runs
      Fix many errors safely
    Audience
      Claude Code users
      Agentic coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let Claude Code pick the right loop type when you ask it to babysit a pull request overnight.

USE CASE 2

Get a ready-to-run prompt with clear stop conditions instead of a vague open-ended task.

USE CASE 3

Generate a runbook file to track state during a long autonomous run.

USE CASE 4

Have Claude tell you when a task is really one turn of work, not a loop, to avoid wasted runs.

What is it built with?

Claude CodeMarkdown

How does it compare?

edwluo/designing-loops0xknowles/ruby0xrphl/solar-crypto-mining-farm-maximization-control
Stars666
LanguageC++C++
Setup difficultyeasymoderatehard
Complexity1/54/55/5
Audiencedeveloperresearcherops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

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.

Copy-paste prompts

Prompt 1
Babysit this pull request overnight until all CI checks pass or three hours have elapsed.
Prompt 2
Run this task until all 47 errors are fixed, checking in every 30 minutes.
Prompt 3
Use the designing-loops skill to write a stop condition for this multi-hour task.
Prompt 4
Generate a runbook file for an overnight autonomous run fixing these test failures.

Frequently asked questions

What is designing-loops?

A Claude Code skill that picks the right kind of repeating task and writes stop conditions that actually hold, based on real overnight runs.

What license does designing-loops use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is designing-loops to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is designing-loops for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.