$git clone https://github.com/cobusgreyling/loop-engineering> Stop prompting. Design the loop. Get a score.
| 1 | # Loop Engineering |
| 2 | |
| 3 | |
| 4 | <p align="center"> |
| 5 | <a href="https://cobusgreyling.github.io/loop-engineering/"> |
| 6 | <img src="https://img.shields.io/badge/✨_Explore_the_Showcase-Design_systems_that_prompt_your_agents-0d1117?style=for-the-badge&labelColor=111a28&color=3ee8c5" alt="Explore the Showcase" /> |
| 7 | </a> |
| 8 | </p> |
| 9 | |
| 10 | <p align="center"> |
| 11 | <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> |
| 12 | <a href="https://github.com/cobusgreyling/loop-engineering/actions/workflows/audit.yml"><img src="https://img.shields.io/github/actions/workflow/status/cobusgreyling/loop-engineering/audit.yml?label=loop-audit%20dogfood" alt="loop-audit dogfood"></a> |
| 13 | <a href="https://www.npmjs.com/package/@cobusgreyling/loop-audit"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-audit?label=loop-audit" alt="loop-audit npm"></a> |
| 14 | <a href="https://www.npmjs.com/package/@cobusgreyling/loop-init"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-init?label=loop-init" alt="loop-init npm"></a> |
| 15 | <a href="https://www.npmjs.com/package/@cobusgreyling/loop-cost"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-cost?label=loop-cost" alt="loop-cost npm"></a> |
| 16 | <a href="https://www.npmjs.com/package/@cobusgreyling/loop-sync"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-sync?label=loop-sync" alt="loop-sync npm"></a> |
| 17 | <a href="https://www.npmjs.com/package/@cobusgreyling/loop-context"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-context?label=loop-context" alt="loop-context npm"></a> |
| 18 | <a href="https://www.npmjs.com/package/@cobusgreyling/loop-mcp-server"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-mcp-server?label=loop-mcp-server" alt="loop-mcp-server npm"></a> |
| 19 | <a href="https://www.npmjs.com/package/@cobusgreyling/loop-worktree"><img src="https://img.shields.io/npm/v/@cobusgreyling/loop-worktree?label=loop-worktree" alt="loop-worktree npm"></a> |
| 20 | <a href="https://github.com/cobusgreyling/loop-engineering/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT"></a> |
| 21 | <a href="https://cobusgreyling.github.io/loop-engineering/"><img src="https://img.shields.io/badge/GitHub_Pages-live%20%7C%20interactive-3ee8c5" alt="Pages"></a> |
| 22 | </p> |
| 23 | |
| 24 | |
| 25 | <p align="center"> |
| 26 | <a href="https://cobusgreyling.github.io/loop-engineering/"> |
| 27 | <img src="assets/visuals/loop-engineering-logo.svg" alt="Loop Engineering logo" width="88" /> |
| 28 | </a> |
| 29 | </p> |
| 30 | |
| 31 | > **Stop prompting. Design the loop. Get a score.** |
| 32 | |
| 33 | <p align="center"> |
| 34 | <img src="assets/visuals/LE5.jpeg" alt="Loop Engineering — design the system that prompts your agents" width="100%" /> |
| 35 | </p> |
| 36 | |
| 37 | ```bash |
| 38 | npx @cobusgreyling/loop-init . |
| 39 | # Optional: also scaffold a versioned harness (harness-foundry) |
| 40 | npx @cobusgreyling/loop-init . --with-foundry |
| 41 | ``` |
| 42 | |
| 43 | `loop-init` scaffolds skills, state, and budget files, then prints your **Loop Ready** score and first loop command. Swap `--tool` for `claude`, `codex`, or `opencode`. Use `--with-foundry` when you want the loop as a composable runtime stack. |
| 44 | |
| 45 | <p align="center"> |
| 46 | <a href="docs/QUICKSTART.md"> |
| 47 | <img src="assets/visuals/loop-audit-demo.gif" alt="Loop Ready score climbs from 10 to 100 in 15 seconds" width="100%" /> |
| 48 | </a> |
| 49 | </p> |
| 50 | |
| 51 | Loop engineering replaces you as the person who prompts the agent — you design the system that does it instead. |
| 52 | |
| 53 | **New here?** [Quickstart (5 min)](docs/QUICKSTART.md) · [Interactive picker](https://cobusgreyling.github.io/loop-engineering/#interactive) |
| 54 | |
| 55 | For developers using Grok, Claude Code, Codex, Cursor, and other AI coding agents. |
| 56 | |
| 57 | <p align="center"> |
| 58 | <strong><a href="https://cobusgreyling.github.io/loop-engineering/">→ Interactive showcase + pattern picker</a></strong> |
| 59 | · |
| 60 | <a href="https://cobusgreyling.substack.com/p/loop-engineering">Essay</a> |
| 61 | · |
| 62 | <a href="https://addyosmani.com/blog/loop-engineering/">Addy Osmani</a> |
| 63 | </p> |
| 64 | |
| 65 | ## Contents |