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.

chore: polish showcase and README for incoming traffic (#31)

Cobus Greylingc8958fd8858e
diff --git a/README.md b/README.md
index db4ab1d..b68580b 100644
--- a/README.md
+++ b/README.md
@@ -11,13 +11,15 @@
<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://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>
<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>
+ <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>
+ <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>
<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>
<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>
</p>
<p align="center">
- <img src="assets/cobus-greyling.jpg" alt="Cobus Greyling" />
+ <img src="assets/visuals/loop-engineering-logo.jpg" alt="Loop Engineering" width="96" />
</p>
**Loop engineering is replacing yourself as the person who prompts the agent. You design the system that does it instead.**
@@ -193,3 +195,11 @@ MIT
---
*Practical, tool-aware reference for loop engineering — patterns you can clone, checklists you can ship against, and stories that include what broke.*
+
+<p align="center">
+ <a href="https://cobusgreyling.substack.com/p/loop-engineering">Essay</a>
+ ·
+ <a href="https://cobusgreyling.github.io/loop-engineering/">Showcase</a>
+ ·
+ <a href="https://github.com/cobusgreyling">Cobus Greyling</a>
+</p>
diff --git a/docs/index.html b/docs/index.html
index 2f9cf00..1ecf717 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -51,8 +51,8 @@ title: Loop Engineering — Showcase
</p>
<img
class="hero-img"
- src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/cobus-greyling.jpg"
- alt="Loop Engineering"
+ src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-engineering-social-banner.jpg"
+ alt="Loop Engineering — Design the system that prompts your agents"
loading="lazy"
/>
</header>
@@ -76,6 +76,13 @@ title: Loop Engineering — Showcase
<p class="section-label">Anatomy</p>
<h2 class="section-title">What one loop looks like</h2>
<p class="section-desc">You design it once. You're not prompting every micro-step.</p>
+ <img
+ class="hero-img"
+ src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-anatomy.jpg"
+ alt="Anatomy of a loop — schedule, triage, state, worktree, implementer, verifier, MCP, human gate"
+ loading="lazy"
+ style="margin-bottom: 24px;"
+ />
<div class="flow">
<span class="flow-step">⏱ Schedule</span>
<span class="flow-arrow">→</span>
@@ -204,7 +211,18 @@ title: Loop Engineering — Showcase
</article>
<article class="pattern-card">
- <span class="tag" style="color:#ffb347;">New · Low risk</span>
+ <span class="tag">Low risk</span>
+ <h3>Issue Triage</h3>
+ <p>Dedupe, score, and label incoming issues. Propose-only week one — pairs well with Daily Triage.</p>
+ <div class="pattern-meta">
+ <span>⏱ 2h–1d</span>
+ <span>◆ Low risk</span>
+ </div>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/blob/main/patterns/issue-triage.md">Read pattern →</a>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/tree/main/starters/minimal-loop" style="margin-left:12px">Starter →</a>
+ </article>
+ <article class="pattern-card">
+ <span class="tag" style="color:#ffb347;">Low risk</span>
<h3>Changelog Drafter</h3>
<p>Scan merges &amp; commits, produce polished categorized release notes drafts. Human approves before publish. Huge leverage, tiny risk.</p>
<div class="pattern-meta">
@@ -217,7 +235,7 @@ title: Loop Engineering — Showcase
</div>
<div class="stats">
<div class="stat">
- <div class="num">6</div>
+ <div class="num">7</div>
<div class="label">Patterns</div>
</div>
<div class="stat">
@@ -280,6 +298,7 @@ npx @cobusgreyling/loop-audit . --suggest
<div class="symptom-pill" data-symptom="deps">Dependabot / CVE noise</div>
<div class="symptom-pill" data-symptom="debt">Merge debt / TODOs piling up</div>
<div class="symptom-pill" data-symptom="releases">Stale release notes / changelogs</div>
+ <div class="symptom-pill" data-symptom="issues">Noisy issue backlog / duplicates</div>
</div>
<div id="reco-output" class="reco-card" style="display:none;">
@@ -471,6 +490,14 @@ const PATTERNS = {
loop: '/loop 1d Run changelog-scan + draft-release-notes. Write RELEASE_NOTES_DRAFT.md. Human review only.',
patternHref: 'https://github.com/cobusgreyling/loop-engineering/blob/main/patterns/changelog-drafter.md',
starterHref: 'https://github.com/cobusgreyling/loop-engineering/tree/main/starters/changelog-drafter'
+ },
+ issues: {
+ name: 'Issue Triage',
+ meta: '2h–1d • Low risk • Pairs with Daily Triage',
+ npx: 'npx @cobusgreyling/loop-init . --pattern issue-triage --tool grok',
+ loop: '/loop 1d Run issue-triage. Update issue-triage-state.md. Propose labels and priorities only — no auto-close.',
+ patternHref: 'https://github.com/cobusgreyling/loop-engineering/blob/main/patterns/issue-triage.md',
+ starterHref: 'https://github.com/cobusgreyling/loop-engineering/tree/main/starters/minimal-loop'
}
};