loop-engineering

# Loop Engineering

<p align="center">
  <a href="https://cobusgreyling.github.io/loop-engineering/"><img src="https://img.shields.io/badge/✨_Showcase-live-3ee8c5?style=for-the-badge&labelColor=111a28" alt="Showcase" /></a>
  <a href="https://github.com/cobusgreyling/loop-engineering/stargazers"><img src="https://img.shields.io/github/stars/cobusgreyling/loop-engineering?style=social" alt="GitHub stars"></a>
  <a href="https://www.npmjs.com/package/@cobusgreyling/loop"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop?label=loop" alt="loop npm"></a>
  <a href="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/docs/last-run.json"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/docs/last-run.json" alt="last triage"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT"></a>
</p>

<p align="center">
  <a href="https://cobusgreyling.github.io/loop-engineering/">
    <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-engineering-logo.svg" alt="Loop Engineering logo" width="72" />
  </a>
</p>

> **Stop prompting. Design the loop. Get a score.**

<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/LE5.jpeg" alt="Loop Engineering — design the system that prompts your agents" width="100%" />
</p>

<p align="center"><strong>Start in 5 minutes</strong> ·
  <a href="docs/QUICKSTART.md">Quickstart</a> ·
  <a href="docs/jobs.md">What do you want to do?</a> ·
  <a href="docs/refactor.md">Refactor path</a> ·
  <a href="README.zh-CN.md">中文</a> ·
  <a href="https://cobusgreyling.github.io/loop-engineering/#interactive">Pattern picker</a>
</p>

```bash
npx @cobusgreyling/loop init . --pattern daily-triage --tool claude
npx @cobusgreyling/loop doctor .
```

`--tool` defaults to `claude` if you omit it. Swap for `grok`, `codex`, or `opencode`. Week one is **report-only**.

<p align="center">
  <a href="docs/QUICKSTART.md">
    <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-audit-demo.gif" alt="Loop Ready score climbing" width="100%" />
  </a>
</p>

You design a system that discovers work, hands it to agents, verifies results, and persists state — instead of typing the next prompt yourself.

**New here?** [Quickstart](docs/QUICKSTART.md) · [Refactor a project](docs/refactor.md) · [Thin GitHub Action loop](starters/thin-loop/) (no `STATE.md` required)

## What do you want to do?

This is a **pattern library for operating agents around a codebase**. It is not a “rewrite the module” button.

| I want to… | Start here |
|------------|------------|
| Keep the repo healthy (issues, CI, deps) | [Quickstart](docs/QUICKSTART.md) → `daily-triage` |
| Land and babysit PRs | [PR Babysitter](patterns/pr-babysitter.md) |
| Run a loop in GitHub Actions with almost no files | [Thin loop](starters/thin-l