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
fix(docs): serve README/showcase images via jsDelivr (#514)
Cobus Greylingb449b4f7291e
diff --git a/.github/workflows/update-star-history.yml b/.github/workflows/update-star-history.ymlindex 122b8d4..19fddac 100644--- a/.github/workflows/update-star-history.yml+++ b/.github/workflows/update-star-history.yml@@ -98,6 +98,11 @@ jobs:echo "number=${PR_NUMBER}" >> "$GITHUB_OUTPUT"gh pr merge "$PR_NUMBER" --auto --squash --delete-branch+ # README/showcase serve charts via jsDelivr (@main). Purge so the+ # next visit is not stuck on a stale cached SVG after merge lands.+ curl -fsS "https://purge.jsdelivr.net/gh/${{ github.repository }}@main/assets/visuals/star-history.svg" || true+ curl -fsS "https://purge.jsdelivr.net/gh/${{ github.repository }}@main/assets/visuals/star-history-dark.svg" || true+- name: Post required commit statuses for branch protectionif: steps.generate.outputs.skipped != 'true' && steps.pr.outputs.opened == 'true'uses: actions/github-script@v9diff --git a/README.md b/README.mdindex b28b5ac..aceb0a6 100644--- a/README.md+++ b/README.md@@ -25,14 +25,14 @@<p align="center"><a href="https://cobusgreyling.github.io/loop-engineering/">- <img src="assets/visuals/loop-engineering-logo.svg" alt="Loop Engineering logo" width="88" />+ <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-engineering-logo.svg" alt="Loop Engineering logo" width="88" /></a></p>> **Stop prompting. Design the loop. Get a score.**<p align="center">- <img src="assets/visuals/LE5.jpeg" alt="Loop Engineering — design the system that prompts your agents" width="100%" />+ <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">@@ -55,7 +55,7 @@ npx @cobusgreyling/loop doctor .<p align="center"><a href="docs/QUICKSTART.md">- <img src="assets/visuals/loop-audit-demo.gif" alt="Loop Ready score climbs from 10 to 100 in 15 seconds" width="100%" />+ <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-audit-demo.gif" alt="Loop Ready score climbs from 10 to 100 in 15 seconds" width="100%" /></a></p>@@ -152,7 +152,7 @@ memory-engineering → loop-engineering → harness-foundry → outerloop → fl| [Add your project](https://github.com/cobusgreyling/loop-engineering/discussions/92) | **Pinned:** Loop Ready badge + adopters list |<p align="center">- <img src="assets/visuals/section-divider.svg" alt="" width="100%" />+ <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/section-divider.svg" alt="" width="100%" /></p>## Why This Matters@@ -181,13 +181,13 @@ Full detail: [docs/primitives.md](docs/primitives.md) · Cross-tool matrix: [doc### Visual Overview<p align="center">- <img src="assets/visuals/primitives-infographic.jpg" alt="The Five Building Blocks + Memory — Loop Engineering" width="100%" />+ <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/primitives-infographic.jpg" alt="The Five Building Blocks + Memory — Loop Engineering" width="100%" /></p>### Anatomy of a Loop<p align="center">- <img src="assets/visuals/loop-cycle-animated.svg" alt="Animated loop flow — schedule, triage, state, worktree, implement, verify, MCP, human gate" width="100%" />+ <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-cycle-animated.svg" alt="Animated loop flow — schedule, triage, state, worktree, implement, verify, MCP, human gate" width="100%" /></p><details>@@ -217,7 +217,7 @@ Deeper diagrams — the actor-level sequence within one run, the run lifecycle's## Patterns<p align="center">- <img src="assets/visuals/patterns-overview.svg" alt="Seven production loop patterns with cadence and token cost" width="100%" />+ <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/patterns-overview.svg" alt="Seven production loop patterns with cadence and token cost" width="100%" /></p>| Pattern | Cadence | Starter | Week 1 | Token cost |@@ -357,9 +357,9 @@ MIT<p align="center"><a href="https://cobusgreyling.github.io/loop-engineering/star-history.html"><picture>- <source media="(prefers-color-scheme: dark)" srcset="assets/visuals/star-history-dark.svg" />- <source media="(prefers-color-scheme: light)" srcset="assets/visuals/star-history.svg" />- <img alt="Star History Chart" src="assets/visuals/star-history.svg" />+ <source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/star-history-dark.svg" />+ <source media="(prefers-color-scheme: light)" srcset="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/star-history.svg" />+ <img alt="Star History Chart" src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/star-history.svg" /></picture></a></p>diff --git a/docs/distribution/v1.6.0-social-drafts.md b/docs/distribution/v1.6.0-social-drafts.mdindex c8a2890..f215402 100644--- a/docs/distribution/v1.6.0-social-drafts.md+++ b/docs/distribution/v1.6.0-social-drafts.md@@ -6,7 +6,7 @@ Use these as-is or lightly edit. Goal: **score 10→100 in ~15s**, then point at- Release: https://github.com/cobusgreyling/loop-engineering/releases/tag/v1.6.0- Repo: https://github.com/cobusgreyling/loop-engineering-- Demo GIF: https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-audit-demo.gif+- Demo GIF: https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-audit-demo.gif- Showcase: https://cobusgreyling.github.io/loop-engineering/- Show your loop: https://github.com/cobusgreyling/loop-engineering/discussions/326- Story (Substack source): `stories/score-climbs-then-budget-burns.md`diff --git a/docs/index.html b/docs/index.htmlindex e0a01de..cc4625f 100644--- a/docs/index.html+++ b/docs/index.html@@ -11,9 +11,9 @@ title: Loop Engineering — Showcase<meta name="description" content="The practical reference for loop engineering. Patterns, starters, checklists, and tooling for Grok, Claude Code, Codex, OpenClaw, and Opencode."><meta property="og:title" content="Loop Engineering"><meta property="og:description" content="Stop prompting. Design the loop. Get a score. Two npx commands.">- <meta property="og:image" content="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-engineering-social-banner.jpg">+ <meta property="og:image" content="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-engineering-social-banner.jpg"><link rel="stylesheet" href="{{ site.baseurl }}/assets/css/showcase.css">- <link rel="icon" href="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-engineering-logo.svg">+ <link rel="icon" href="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-engineering-logo.svg"><script type="module">import mermaid from "https://cdn.jsdelivr.net/npm/[email protected]/dist/mermaid.esm.min.mjs";mermaid.initialize({@@ -43,7 +43,7 @@ title: Loop Engineering — Showcase<nav class="nav"><div class="wrap nav-inner"><a href="#" class="logo">- <img src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-engineering-logo.svg" alt="" width="28" height="28" style="vertical-align:-6px;margin-right:8px;border-radius:6px;" />+ <img src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-engineering-logo.svg" alt="" width="28" height="28" style="vertical-align:-6px;margin-right:8px;border-radius:6px;" />Loop <span>Engineering</span></a><button@@ -97,7 +97,7 @@ npx @cobusgreyling/loop doctor .</pre></div><imgclass="hero-img"- src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-audit-demo.gif"+ src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-audit-demo.gif"alt="Loop Ready score climbs from 10 to 100"loading="lazy"style="margin-top:24px;"@@ -125,7 +125,7 @@ npx @cobusgreyling/loop doctor .</pre><p class="section-desc">You design it once. You're not prompting every micro-step.</p><imgclass="hero-img"- src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-cycle-animated.svg"+ src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-cycle-animated.svg"alt="Anatomy of a loop — schedule, triage, state, worktree, implementer, verifier, MCP, human gate"loading="lazy"style="margin-bottom: 24px;"@@ -348,7 +348,7 @@ flowchart TB<p class="section-desc">Documented loops with scheduling, skills, state schemas, verification, and honest failure modes.</p><imgclass="hero-img"- src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/patterns-overview.svg"+ src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/patterns-overview.svg"alt="Seven production loop patterns — cadence and token cost overview"loading="lazy"style="margin-bottom: 28px;"@@ -1059,7 +1059,7 @@ function setupMobileNav() {async function renderTelemetry() {try {- const res = await fetch('https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/loop-run-log.md');+ const res = await fetch('https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/loop-run-log.md');const text = await res.text();// Parse JSON lines from the markdown filediff --git a/docs/star-history.html b/docs/star-history.htmlindex af8a56e..fc2e59b 100644--- a/docs/star-history.html+++ b/docs/star-history.html@@ -10,7 +10,7 @@ title: Star History — Loop Engineering<title>GitHub Star History — Loop Engineering</title><meta name="description" content="View and compare GitHub star history for loop-engineering and other repos you own."><meta name="theme-color" content="#363636">- <link rel="icon" href="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/loop-engineering-logo.svg">+ <link rel="icon" href="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/loop-engineering-logo.svg"><link rel="stylesheet" href="{{ site.baseurl }}/assets/css/star-history.css"></head><body>@@ -101,9 +101,9 @@ title: Star History — Loop EngineeringDefault: <code>cobusgreyling/loop-engineering</code> — add comma-separated repos to compare.<div class="sh-static-fallback" style="margin-top:24px;"><picture>- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/star-history-dark.svg" />- <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/star-history.svg" />- <img alt="Static star history (CI-updated daily)" src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/visuals/star-history.svg" />+ <source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/star-history-dark.svg" />+ <source media="(prefers-color-scheme: light)" srcset="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/star-history.svg" />+ <img alt="Static star history (CI-updated daily)" src="https://cdn.jsdelivr.net/gh/cobusgreyling/loop-engineering@main/assets/visuals/star-history.svg" /></picture><p>Static chart from CI. Live data needs your token (settings ⚙).</p></div>