Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.
TypeScript agentic-aiai-agentsai-codinganthropicautomationclaudeclaude-codecodexcoding-agentsdevops-automationdevtoolsgithub-actionsgrokllmloop-engineeringmcpprompt-engineering
Link Substack Loop Engineering essay from repo
Cobus Greyling1efbcc5da14a
diff --git a/README.md b/README.mdindex 023cc2b..681e897 100644--- a/README.md+++ b/README.md@@ -35,12 +35,15 @@ A loop is a recursive goal: you define a purpose and the AI iterates (often with<p align="center"><strong><a href="https://cobusgreyling.github.io/loop-engineering/">→ cobusgreyling.github.io/loop-engineering</a></strong>+ <br>+ <strong><a href="https://cobusgreyling.substack.com/p/loop-engineering">→ Read the Loop Engineering essay on Substack</a></strong></p>## Quick Links| Start here | Description ||------------|-------------|+| [Loop Engineering essay](https://cobusgreyling.substack.com/p/loop-engineering) | The concept, primitives, and Grok mapping — **read this first** || [Pattern Picker](docs/pattern-picker.md) | Which loop to run first — **start here if unsure** || [Primitives Matrix](docs/primitives-matrix.md) | Grok vs Claude Code vs Codex — bookmark this || [Loop Design Checklist](docs/loop-design-checklist.md) | Ship readiness rubric |@@ -167,6 +170,7 @@ Share production patterns, tool mappings, and failure stories. See [CONTRIBUTING## Sources+- [Cobus Greyling – Loop Engineering (Substack)](https://cobusgreyling.substack.com/p/loop-engineering)- [Addy Osmani – Loop Engineering](https://addyosmani.com/blog/loop-engineering/)- [Attribution & further reading](resources/sources.md)diff --git a/docs/index.html b/docs/index.htmlindex c9bc50b..a7a2f4a 100644--- a/docs/index.html+++ b/docs/index.html@@ -24,6 +24,7 @@ title: Loop Engineering — Showcase<li><a href="#patterns">Patterns</a></li><li><a href="#primitives">Primitives</a></li><li><a href="#start">Get Started</a></li>+ <li><a href="https://cobusgreyling.substack.com/p/loop-engineering">Essay</a></li><li><a href="https://github.com/cobusgreyling/loop-engineering">GitHub</a></li></ul><a href="https://github.com/cobusgreyling/loop-engineering" class="btn btn-primary">View Repo</a>@@ -39,6 +40,7 @@ title: Loop Engineering — Showcase</p><div class="hero-cta"><a href="https://github.com/cobusgreyling/loop-engineering/tree/main/starters/minimal-loop" class="btn btn-primary">Clone a Starter →</a>+ <a href="https://cobusgreyling.substack.com/p/loop-engineering" class="btn btn-ghost">Read the Essay</a><a href="https://github.com/cobusgreyling/loop-engineering/blob/main/docs/primitives-matrix.md" class="btn btn-ghost">Primitives Matrix</a></div><img@@ -318,6 +320,8 @@ npx @cobusgreyling/loop-audit . --suggest<p><a href="https://github.com/cobusgreyling/loop-engineering">GitHub</a>·+ <a href="https://cobusgreyling.substack.com/p/loop-engineering">Essay</a>+ ·<a href="https://addyosmani.com/blog/loop-engineering/">Addy Osmani</a>·MIT Licensediff --git a/resources/sources.md b/resources/sources.mdindex 3d7b5c8..2f3f2ff 100644--- a/resources/sources.md+++ b/resources/sources.md@@ -4,6 +4,9 @@ This repository exists because of public discussion and practice by experienced## Core Definition & Framework+- **Cobus Greyling** — [Loop Engineering](https://cobusgreyling.substack.com/p/loop-engineering) (June 2026)+ Companion essay for this repository: context engineering vs harness engineering vs loop engineering, the five primitives + memory, Grok mapping, and production realities.+- **Addy Osmani** — [Loop Engineering](https://addyosmani.com/blog/loop-engineering/) (June 2026)The most complete written synthesis of the concept, including the five primitives + memory table and the concrete daily loop example.