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
chore: discoverability polish — mobile nav, TOC, social preview asset (#32)
Cobus Greylingdacc3dd44586
diff --git a/README.md b/README.mdindex b68580b..d798e96 100644--- a/README.md+++ b/README.md@@ -38,6 +38,20 @@ A loop is a recursive goal: you define a purpose and the AI iterates (often with<strong><a href="https://cobusgreyling.substack.com/p/loop-engineering">→ Read the Loop Engineering essay on Substack</a></strong></p>+## Contents++- [Quick Links](#quick-links)+- [Why This Matters](#why-this-matters)+- [The Five Building Blocks + Memory](#the-five-building-blocks--memory)+- [Patterns](#patterns)+- [Getting Started (5 minutes)](#getting-started-5-minutes)+- [Examples by Tool](#examples-by-tool)+- [Operating & Safety](#operating--safety)+- [Caveats](#caveats)+- [Contributing](#contributing)+- [Sources](#sources)+- [License](#license)+## Quick Links| Start here | Description |diff --git a/assets/cobus-greyling.jpg b/assets/author-banner.jpgsimilarity index 100%rename from assets/cobus-greyling.jpgrename to assets/author-banner.jpgdiff --git a/assets/visuals/social-preview.jpg b/assets/visuals/social-preview.jpgnew file mode 100644index 0000000..225bfb3Binary files /dev/null and b/assets/visuals/social-preview.jpg differdiff --git a/docs/assets/css/showcase.css b/docs/assets/css/showcase.cssindex 2bb301f..5ba09a6 100644--- a/docs/assets/css/showcase.css+++ b/docs/assets/css/showcase.css@@ -56,7 +56,9 @@ a:hover { color: #6ff5d8; }display: flex;align-items: center;justify-content: space-between;+ gap: 16px;height: 64px;+ position: relative;}.logo {@@ -82,6 +84,47 @@ a:hover { color: #6ff5d8; }.nav-links a:hover { color: var(--text); }+.nav-menu {+ display: flex;+ align-items: center;+ gap: 28px;+}++.nav-toggle {+ display: none;+ flex-direction: column;+ justify-content: center;+ gap: 5px;+ width: 40px;+ height: 40px;+ padding: 8px;+ border-radius: 10px;+ border: 1px solid var(--border);+ background: var(--bg-card);+ cursor: pointer;+}++.nav-toggle-bar {+ display: block;+ width: 100%;+ height: 2px;+ background: var(--text);+ border-radius: 2px;+ transition: transform 0.2s, opacity 0.2s;+}++.nav-toggle[aria-expanded="true"] .nav-toggle-bar:nth-child(1) {+ transform: translateY(7px) rotate(45deg);+}++.nav-toggle[aria-expanded="true"] .nav-toggle-bar:nth-child(2) {+ opacity: 0;+}++.nav-toggle[aria-expanded="true"] .nav-toggle-bar:nth-child(3) {+ transform: translateY(-7px) rotate(-45deg);+}+.btn {display: inline-flex;align-items: center;@@ -491,6 +534,24 @@ section {margin-bottom: 28px;}+.cta-actions {+ display: flex;+ align-items: center;+ justify-content: center;+ flex-wrap: wrap;+ gap: 12px;+}++.cta-stars {+ display: inline-flex;+ line-height: 0;+}++.cta-stars img {+ display: block;+ border-radius: 999px;+}+.footer {padding: 32px 24px;text-align: center;@@ -503,7 +564,50 @@ section {.footer a:hover { color: var(--accent); }@media (max-width: 640px) {- .nav-links { display: none; }+ .nav-toggle { display: flex; }++ .nav-menu {+ position: absolute;+ top: calc(100% + 8px);+ left: 0;+ right: 0;+ display: none;+ flex-direction: column;+ align-items: stretch;+ gap: 16px;+ padding: 20px;+ background: rgba(7, 11, 18, 0.98);+ border: 1px solid var(--border);+ border-radius: var(--radius);+ box-shadow: 0 24px 64px rgba(0, 0, 0, 0.45);+ }++ .nav-menu.open { display: flex; }++ .nav-links {+ flex-direction: column;+ align-items: stretch;+ gap: 4px;+ width: 100%;+ }++ .nav-links a {+ display: block;+ padding: 10px 12px;+ border-radius: 8px;+ }++ .nav-links a:hover {+ background: rgba(62, 232, 197, 0.08);+ }++ .nav-menu .btn {+ width: 100%;+ justify-content: center;+ }++ body.nav-open { overflow: hidden; }+.hero { padding: 48px 0 40px; }.flow-arrow { display: none; }}diff --git a/docs/index.html b/docs/index.htmlindex 1ecf717..3e51ce5 100644--- a/docs/index.html+++ b/docs/index.html@@ -20,14 +20,28 @@ title: Loop Engineering — Showcase<nav class="nav"><div class="wrap nav-inner"><a href="#" class="logo">Loop <span>Engineering</span></a>- <ul class="nav-links">- <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>+ <button+ type="button"+ class="nav-toggle"+ aria-label="Open menu"+ aria-expanded="false"+ aria-controls="nav-menu"+ >+ <span class="nav-toggle-bar"></span>+ <span class="nav-toggle-bar"></span>+ <span class="nav-toggle-bar"></span>+ </button>+ <div id="nav-menu" class="nav-menu">+ <ul class="nav-links">+ <li><a href="#patterns">Patterns</a></li>+ <li><a href="#primitives">Primitives</a></li>+ <li><a href="#interactive">Picker</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>+ </div></div></nav>@@ -402,8 +416,17 @@ npx @cobusgreyling/loop-audit . --suggest<div class="cta"><h2>Ready to stop prompting?</h2><p>The best loops are boring, reliable, and transparent.</p>- <a href="https://github.com/cobusgreyling/loop-engineering" class="btn btn-primary">Star on GitHub</a>- <a href="https://github.com/cobusgreyling/loop-engineering/blob/main/CONTRIBUTING.md" class="btn btn-ghost" style="margin-left: 12px;">Contribute a pattern</a>+ <div class="cta-actions">+ <a href="https://github.com/cobusgreyling/loop-engineering" class="btn btn-primary">Star on GitHub</a>+ <a href="https://github.com/cobusgreyling/loop-engineering/stargazers" class="cta-stars" aria-label="GitHub stars">+ <img+ src="https://img.shields.io/github/stars/cobusgreyling/loop-engineering?style=for-the-badge&logo=github&label=Stars&labelColor=111a28&color=3ee8c5"+ alt="GitHub stars"+ height="32"+ />+ </a>+ <a href="https://github.com/cobusgreyling/loop-engineering/blob/main/CONTRIBUTING.md" class="btn btn-ghost">Contribute a pattern</a>+ </div></div><footer class="footer">@@ -625,8 +648,37 @@ function setupSimulator() {computeLive();}+function setupMobileNav() {+ const toggle = document.querySelector('.nav-toggle');+ const menu = document.getElementById('nav-menu');+ if (!toggle || !menu) return;++ const closeMenu = () => {+ menu.classList.remove('open');+ toggle.setAttribute('aria-expanded', 'false');+ toggle.setAttribute('aria-label', 'Open menu');+ document.body.classList.remove('nav-open');+ };++ toggle.addEventListener('click', () => {+ const open = menu.classList.toggle('open');+ toggle.setAttribute('aria-expanded', open ? 'true' : 'false');+ toggle.setAttribute('aria-label', open ? 'Close menu' : 'Open menu');+ document.body.classList.toggle('nav-open', open);+ });++ menu.querySelectorAll('a').forEach((link) => {+ link.addEventListener('click', closeMenu);+ });++ document.addEventListener('keydown', (e) => {+ if (e.key === 'Escape') closeMenu();+ });+}+// Bootdocument.addEventListener('DOMContentLoaded', () => {+ setupMobileNav();setupPatternPicker();setupSimulator();});diff --git a/scripts/upload-social-preview.sh b/scripts/upload-social-preview.shnew file mode 100755index 0000000..b911b0f--- /dev/null+++ b/scripts/upload-social-preview.sh@@ -0,0 +1,30 @@+#!/usr/bin/env bash+set -euo pipefail++REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"+IMAGE="${REPO_ROOT}/assets/visuals/social-preview.jpg"+SETTINGS_URL="https://github.com/cobusgreyling/loop-engineering/settings"++if [[ ! -f "${IMAGE}" ]]; then+ echo "Missing ${IMAGE}"+ echo "Regenerate with:"+ echo " sips -c 640 1280 assets/visuals/loop-engineering-social-banner.jpg --out assets/visuals/social-preview.jpg"+ exit 1+fi++BYTES=$(wc -c < "${IMAGE}" | tr -d ' ')+if (( BYTES > 1048576 )); then+ echo "Warning: social preview should be under 1 MB (current: ${BYTES} bytes)"+fi++echo "Ready: ${IMAGE} ($(sips -g pixelWidth -g pixelHeight "${IMAGE}" 2>/dev/null | awk '/pixel/{print $2}' | tr '\n' 'x' | sed 's/x$//'))"+echo+echo "GitHub has no public API for social preview upload."+echo "1. Open: ${SETTINGS_URL}"+echo "2. Social preview → Edit → Upload an image"+echo "3. Choose: assets/visuals/social-preview.jpg"+echo++if command -v open >/dev/null 2>&1; then+ open "${SETTINGS_URL}"+fi\ No newline at end of file