Skip to content

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.

Link Substack Loop Engineering essay from repo

Cobus Greyling1efbcc5da14a
diff --git a/README.md b/README.md
index 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.html
index 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 License
diff --git a/resources/sources.md b/resources/sources.md
index 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.