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.

Add interactive showcase page and prominent README link

Cobus Greyling47ab5c156f9b
diff --git a/README.md b/README.md
index d27b6af..262f240 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,15 @@
# Loop Engineering
+<p align="center">
+ <a href="https://cobusgreyling.github.io/loop-engineering/">
+ <img src="https://img.shields.io/badge/✨_Explore_the_Showcase-Design_systems_that_prompt_your_agents-0d1117?style=for-the-badge&labelColor=111a28&color=3ee8c5" alt="Explore the Showcase" />
+ </a>
+</p>
+
+<p align="center">
+ <strong><a href="https://cobusgreyling.github.io/loop-engineering/">→ cobusgreyling.github.io/loop-engineering</a></strong>
+</p>
+
<p align="center">
<img src="assets/cobus-greyling.jpg" alt="Cobus Greyling" width="640" />
</p>
@@ -10,8 +20,6 @@
A loop is a recursive goal: you define a purpose and the AI iterates (often with sub-agents, verification, and external state) until the goal is complete or the loop decides to hand off to you.
-📖 **Docs site**: [cobusgreyling.github.io/loop-engineering](https://cobusgreyling.github.io/loop-engineering/) (GitHub Pages)
-
## Quick Links
| Start here | Description |
diff --git a/docs/GITHUB_PAGES.md b/docs/GITHUB_PAGES.md
index 91873a7..44e7346 100644
--- a/docs/GITHUB_PAGES.md
+++ b/docs/GITHUB_PAGES.md
@@ -3,6 +3,8 @@
1. Repo **Settings** → **Pages**
2. **Source**: Deploy from branch `main`
3. **Folder**: `/docs`
-4. Save — site at `https://cobusgreyling.github.io/loop-engineering/`
+4. Save — showcase at `https://cobusgreyling.github.io/loop-engineering/`
+
+The homepage (`docs/index.md`) is the full interactive showcase with patterns, primitives, and quick-start.
First deploy may take 1–2 minutes.
\ No newline at end of file
diff --git a/docs/assets/css/showcase.css b/docs/assets/css/showcase.css
new file mode 100644
index 0000000..baf7adf
--- /dev/null
+++ b/docs/assets/css/showcase.css
@@ -0,0 +1,509 @@
+:root {
+ --bg: #070b12;
+ --bg-elevated: #0d1420;
+ --bg-card: #111a28;
+ --border: rgba(120, 180, 255, 0.12);
+ --text: #e8edf5;
+ --text-muted: #8b9cb3;
+ --accent: #3ee8c5;
+ --accent-2: #5b9dff;
+ --accent-warm: #ffb347;
+ --glow: rgba(62, 232, 197, 0.35);
+ --radius: 14px;
+ --font-sans: "SF Pro Display", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+ --font-mono: "SF Mono", "Fira Code", "JetBrains Mono", ui-monospace, monospace;
+}
+
+* { box-sizing: border-box; margin: 0; padding: 0; }
+
+html {
+ scroll-behavior: smooth;
+ background: var(--bg);
+ color: var(--text);
+ font-family: var(--font-sans);
+ line-height: 1.6;
+}
+
+body {
+ min-height: 100vh;
+ background:
+ radial-gradient(ellipse 80% 50% at 50% -20%, rgba(62, 232, 197, 0.12), transparent),
+ radial-gradient(ellipse 60% 40% at 100% 0%, rgba(91, 157, 255, 0.1), transparent),
+ radial-gradient(ellipse 50% 30% at 0% 100%, rgba(255, 179, 71, 0.06), transparent),
+ var(--bg);
+}
+
+a { color: var(--accent); text-decoration: none; transition: color 0.2s; }
+a:hover { color: #6ff5d8; }
+
+.wrap {
+ max-width: 1120px;
+ margin: 0 auto;
+ padding: 0 24px;
+}
+
+/* Nav */
+.nav {
+ position: sticky;
+ top: 0;
+ z-index: 100;
+ backdrop-filter: blur(16px);
+ background: rgba(7, 11, 18, 0.85);
+ border-bottom: 1px solid var(--border);
+}
+
+.nav-inner {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ height: 64px;
+}
+
+.logo {
+ font-weight: 700;
+ font-size: 1.05rem;
+ letter-spacing: -0.02em;
+ color: var(--text);
+}
+
+.logo span { color: var(--accent); }
+
+.nav-links {
+ display: flex;
+ gap: 28px;
+ list-style: none;
+}
+
+.nav-links a {
+ color: var(--text-muted);
+ font-size: 0.9rem;
+ font-weight: 500;
+}
+
+.nav-links a:hover { color: var(--text); }
+
+.btn {
+ display: inline-flex;
+ align-items: center;
+ gap: 8px;
+ padding: 10px 20px;
+ border-radius: 999px;
+ font-weight: 600;
+ font-size: 0.9rem;
+ border: none;
+ cursor: pointer;
+ transition: transform 0.2s, box-shadow 0.2s;
+}
+
+.btn-primary {
+ background: linear-gradient(135deg, var(--accent), #2bc4a8);
+ color: #041210;
+ box-shadow: 0 0 24px var(--glow);
+}
+
+.btn-primary:hover {
+ transform: translateY(-1px);
+ box-shadow: 0 0 36px var(--glow);
+ color: #041210;
+}
+
+.btn-ghost {
+ background: transparent;
+ color: var(--text);
+ border: 1px solid var(--border);
+}
+
+.btn-ghost:hover {
+ border-color: var(--accent);
+ color: var(--accent);
+}
+
+/* Hero */
+.hero {
+ padding: 80px 0 64px;
+ text-align: center;
+}
+
+.badge {
+ display: inline-flex;
+ align-items: center;
+ gap: 8px;
+ padding: 6px 14px;
+ border-radius: 999px;
+ background: rgba(62, 232, 197, 0.08);
+ border: 1px solid rgba(62, 232, 197, 0.25);
+ color: var(--accent);
+ font-size: 0.8rem;
+ font-weight: 600;
+ letter-spacing: 0.04em;
+ text-transform: uppercase;
+ margin-bottom: 28px;
+}
+
+.badge::before {
+ content: "";
+ width: 6px;
+ height: 6px;
+ border-radius: 50%;
+ background: var(--accent);
+ animation: pulse 2s infinite;
+}
+
+@keyframes pulse {
+ 0%, 100% { opacity: 1; }
+ 50% { opacity: 0.4; }
+}
+
+.hero h1 {
+ font-size: clamp(2.4rem, 6vw, 3.75rem);
+ font-weight: 800;
+ letter-spacing: -0.03em;
+ line-height: 1.1;
+ margin-bottom: 24px;
+ background: linear-gradient(135deg, #fff 0%, var(--accent) 50%, var(--accent-2) 100%);
+ -webkit-background-clip: text;
+ -webkit-text-fill-color: transparent;
+ background-clip: text;
+}
+
+.hero .lead {
+ font-size: 1.2rem;
+ color: var(--text-muted);
+ max-width: 640px;
+ margin: 0 auto 36px;
+}
+
+.hero-cta {
+ display: flex;
+ gap: 16px;
+ justify-content: center;
+ flex-wrap: wrap;
+ margin-bottom: 56px;
+}
+
+.hero-img {
+ width: 100%;
+ max-width: 720px;
+ border-radius: var(--radius);
+ border: 1px solid var(--border);
+ box-shadow: 0 24px 80px rgba(0, 0, 0, 0.5);
+ margin: 0 auto;
+ display: block;
+}
+
+/* Quote strip */
+.quotes {
+ display: grid;
+ grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+ gap: 20px;
+ padding: 48px 0;
+}
+
+.quote-card {
+ background: var(--bg-card);
+ border: 1px solid var(--border);
+ border-radius: var(--radius);
+ padding: 24px;
+}
+
+.quote-card blockquote {
+ font-size: 0.95rem;
+ color: var(--text);
+ font-style: italic;
+ margin-bottom: 12px;
+ line-height: 1.5;
+}
+
+.quote-card cite {
+ font-size: 0.8rem;
+ color: var(--text-muted);
+ font-style: normal;
+}
+
+/* Section */
+section {
+ padding: 64px 0;
+}
+
+.section-label {
+ font-size: 0.75rem;
+ font-weight: 700;
+ letter-spacing: 0.12em;
+ text-transform: uppercase;
+ color: var(--accent);
+ margin-bottom: 12px;
+}
+
+.section-title {
+ font-size: 2rem;
+ font-weight: 700;
+ letter-spacing: -0.02em;
+ margin-bottom: 16px;
+}
+
+.section-desc {
+ color: var(--text-muted);
+ max-width: 560px;
+ margin-bottom: 40px;
+}
+
+/* Flow diagram */
+.flow {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ flex-wrap: wrap;
+ gap: 8px;
+ padding: 32px;
+ background: var(--bg-elevated);
+ border: 1px solid var(--border);
+ border-radius: var(--radius);
+ margin-bottom: 48px;
+}
+
+.flow-step {
+ display: flex;
+ align-items: center;
+ gap: 8px;
+ padding: 10px 16px;
+ background: var(--bg-card);
+ border: 1px solid var(--border);
+ border-radius: 8px;
+ font-size: 0.85rem;
+ font-weight: 500;
+}
+
+.flow-arrow {
+ color: var(--accent);
+ font-size: 1.2rem;
+}
+
+/* Primitives */
+.primitives {
+ display: grid;
+ grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
+ gap: 16px;
+}
+
+.primitive {
+ background: var(--bg-card);
+ border: 1px solid var(--border);
+ border-radius: var(--radius);
+ padding: 20px;
+ text-align: center;
+ transition: border-color 0.2s, transform 0.2s;
+}
+
+.primitive:hover {
+ border-color: rgba(62, 232, 197, 0.4);
+ transform: translateY(-2px);
+}
+
+.primitive .icon {
+ font-size: 1.75rem;
+ margin-bottom: 10px;
+}
+
+.primitive h3 {
+ font-size: 0.9rem;
+ font-weight: 700;
+ margin-bottom: 6px;
+}
+
+.primitive p {
+ font-size: 0.78rem;
+ color: var(--text-muted);
+}
+
+/* Pattern cards */
+.patterns {
+ display: grid;
+ grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+ gap: 20px;
+}
+
+.pattern-card {
+ background: var(--bg-card);
+ border: 1px solid var(--border);
+ border-radius: var(--radius);
+ padding: 28px;
+ display: flex;
+ flex-direction: column;
+ transition: border-color 0.2s, box-shadow 0.2s;
+}
+
+.pattern-card:hover {
+ border-color: rgba(91, 157, 255, 0.35);
+ box-shadow: 0 8px 32px rgba(0, 0, 0, 0.3);
+}
+
+.pattern-card .tag {
+ font-size: 0.7rem;
+ font-weight: 700;
+ letter-spacing: 0.08em;
+ text-transform: uppercase;
+ color: var(--accent-2);
+ margin-bottom: 12px;
+}
+
+.pattern-card h3 {
+ font-size: 1.15rem;
+ font-weight: 700;
+ margin-bottom: 8px;
+}
+
+.pattern-card p {
+ font-size: 0.88rem;
+ color: var(--text-muted);
+ flex: 1;
+ margin-bottom: 16px;
+}
+
+.pattern-meta {
+ display: flex;
+ gap: 12px;
+ font-size: 0.75rem;
+ color: var(--text-muted);
+ margin-bottom: 16px;
+}
+
+.pattern-card .link {
+ font-weight: 600;
+ font-size: 0.88rem;
+}
+
+/* Tools */
+.tools {
+ display: flex;
+ gap: 16px;
+ flex-wrap: wrap;
+ justify-content: center;
+}
+
+.tool-pill {
+ padding: 12px 24px;
+ background: var(--bg-card);
+ border: 1px solid var(--border);
+ border-radius: 999px;
+ font-weight: 600;
+ font-size: 0.95rem;
+}
+
+.tool-pill.grok { border-color: rgba(62, 232, 197, 0.3); color: var(--accent); }
+.tool-pill.claude { border-color: rgba(255, 179, 71, 0.3); color: var(--accent-warm); }
+.tool-pill.codex { border-color: rgba(91, 157, 255, 0.3); color: var(--accent-2); }
+
+/* Code block */
+.code-block {
+ background: #050810;
+ border: 1px solid var(--border);
+ border-radius: var(--radius);
+ overflow: hidden;
+ margin-top: 32px;
+}
+
+.code-header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 12px 20px;
+ background: var(--bg-elevated);
+ border-bottom: 1px solid var(--border);
+ font-size: 0.8rem;
+ color: var(--text-muted);
+}
+
+.code-dots {
+ display: flex;
+ gap: 6px;
+}
+
+.code-dots span {
+ width: 10px;
+ height: 10px;
+ border-radius: 50%;
+ background: var(--border);
+}
+
+.code-dots span:first-child { background: #ff5f57; }
+.code-dots span:nth-child(2) { background: #febc2e; }
+.code-dots span:nth-child(3) { background: #28c840; }
+
+.code-block pre {
+ padding: 24px;
+ overflow-x: auto;
+ font-family: var(--font-mono);
+ font-size: 0.82rem;
+ line-height: 1.7;
+ color: #c5d4e8;
+}
+
+.code-block .cmd { color: var(--accent); }
+.code-block .flag { color: var(--accent-2); }
+.code-block .comment { color: #5a6b82; }
+
+/* Stats */
+.stats {
+ display: grid;
+ grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+ gap: 20px;
+ margin-top: 48px;
+}
+
+.stat {
+ text-align: center;
+ padding: 24px;
+ background: var(--bg-card);
+ border: 1px solid var(--border);
+ border-radius: var(--radius);
+}
+
+.stat .num {
+ font-size: 2rem;
+ font-weight: 800;
+ color: var(--accent);
+ letter-spacing: -0.02em;
+}
+
+.stat .label {
+ font-size: 0.8rem;
+ color: var(--text-muted);
+ margin-top: 4px;
+}
+
+/* CTA */
+.cta {
+ text-align: center;
+ padding: 80px 24px;
+ margin: 64px 0 0;
+ background: linear-gradient(180deg, transparent, rgba(62, 232, 197, 0.04));
+ border-top: 1px solid var(--border);
+}
+
+.cta h2 {
+ font-size: 2rem;
+ font-weight: 700;
+ margin-bottom: 16px;
+}
+
+.cta p {
+ color: var(--text-muted);
+ margin-bottom: 28px;
+}
+
+.footer {
+ padding: 32px 24px;
+ text-align: center;
+ font-size: 0.8rem;
+ color: var(--text-muted);
+ border-top: 1px solid var(--border);
+}
+
+.footer a { color: var(--text-muted); }
+.footer a:hover { color: var(--accent); }
+
+@media (max-width: 640px) {
+ .nav-links { display: none; }
+ .hero { padding: 48px 0 40px; }
+ .flow-arrow { display: none; }
+}
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index 70256a8..093c78a 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,38 +1,273 @@
---
-layout: default
-title: Loop Engineering
+layout: null
+title: Loop Engineering — Showcase
---
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="UTF-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <title>Loop Engineering — Design systems that prompt your agents</title>
+ <meta name="description" content="The practical reference for loop engineering. Patterns, starters, checklists, and tooling for Grok, Claude Code, and Codex.">
+ <meta property="og:title" content="Loop Engineering">
+ <meta property="og:description" content="Stop prompting. Start designing loops.">
+ <meta property="og:image" content="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/cobus-greyling.jpg">
+ <link rel="stylesheet" href="{{ site.baseurl }}/assets/css/showcase.css">
+ <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>⟳</text></svg>">
+</head>
+<body>
-# Loop Engineering
+<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://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>
+</nav>
-**Design the system that prompts your agents — don't be the person prompting.**
+<header class="hero wrap">
+ <div class="badge">Open source · Tool-agnostic · Production-ready</div>
+ <h1>Design the system<br>that prompts your agents</h1>
+ <p class="lead">
+ Loop engineering moves you from "I prompt → agent responds → I prompt again"
+ to "I design the autonomous system that discovers work, verifies results, and drives progress."
+ </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://github.com/cobusgreyling/loop-engineering/blob/main/docs/primitives-matrix.md" class="btn btn-ghost">Primitives Matrix</a>
+ </div>
+ <img
+ class="hero-img"
+ src="https://raw.githubusercontent.com/cobusgreyling/loop-engineering/main/assets/cobus-greyling.jpg"
+ alt="Loop Engineering"
+ loading="lazy"
+ />
+</header>
-Practical reference for building reliable, tool-agnostic agent loops.
+<div class="wrap quotes">
+ <div class="quote-card">
+ <blockquote>"You shouldn't be prompting coding agents anymore. You should be designing loops that prompt your agents."</blockquote>
+ <cite>— Peter Steinberger</cite>
+ </div>
+ <div class="quote-card">
+ <blockquote>"I don't prompt Claude anymore. I have loops running that prompt Claude. My job is to write loops."</blockquote>
+ <cite>— Boris Cherny, Head of Claude Code</cite>
+ </div>
+ <div class="quote-card">
+ <blockquote>"Build the loop. But build it like someone who intends to stay the engineer, not just the person who presses go."</blockquote>
+ <cite>— Addy Osmani</cite>
+ </div>
+</div>
-## Start Here
+<section id="flow" class="wrap">
+ <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>
+ <div class="flow">
+ <span class="flow-step">⏱ Schedule</span>
+ <span class="flow-arrow">→</span>
+ <span class="flow-step">👁 Triage skill</span>
+ <span class="flow-arrow">→</span>
+ <span class="flow-step">📋 STATE.md</span>
+ <span class="flow-arrow">→</span>
+ <span class="flow-step">🌲 Worktree</span>
+ <span class="flow-arrow">→</span>
+ <span class="flow-step">⚙️ Implementer</span>
+ <span class="flow-arrow">→</span>
+ <span class="flow-step">✓ Verifier</span>
+ <span class="flow-arrow">→</span>
+ <span class="flow-step">🔗 MCP / PR</span>
+ <span class="flow-arrow">→</span>
+ <span class="flow-step">🧑 Human gate</span>
+ </div>
+</section>
-- [README](../README.md) — manifesto and quick start
-- [Primitives Matrix](./primitives-matrix.md) — Grok vs Claude Code vs Codex
-- [Loop Design Checklist](./loop-design-checklist.md) — ship readiness
-- [Patterns](../patterns/README.md) — copy-paste loop patterns
+<section id="primitives" class="wrap">
+ <p class="section-label">Building blocks</p>
+ <h2 class="section-title">Five primitives + memory</h2>
+ <p class="section-desc">The same shape works in Grok, Claude Code, and Codex. Tool names differ; capabilities converge.</p>
+ <div class="primitives">
+ <div class="primitive">
+ <div class="icon">⏱</div>
+ <h3>Scheduling</h3>
+ <p>/loop, cron, automations</p>
+ </div>
+ <div class="primitive">
+ <div class="icon">🌲</div>
+ <h3>Worktrees</h3>
+ <p>Parallel without collisions</p>
+ </div>
+ <div class="primitive">
+ <div class="icon">📚</div>
+ <h3>Skills</h3>
+ <p>Intent written once</p>
+ </div>
+ <div class="primitive">
+ <div class="icon">🔌</div>
+ <h3>Connectors</h3>
+ <p>MCP → real tools</p>
+ </div>
+ <div class="primitive">
+ <div class="icon">🔀</div>
+ <h3>Sub-agents</h3>
+ <p>Maker / checker split</p>
+ </div>
+ <div class="primitive">
+ <div class="icon">💾</div>
+ <h3>State</h3>
+ <p>Memory outside the model</p>
+ </div>
+ </div>
+ <div class="tools" style="margin-top: 40px;">
+ <span class="tool-pill grok">Grok Build</span>
+ <span class="tool-pill claude">Claude Code</span>
+ <span class="tool-pill codex">Codex</span>
+ <span class="tool-pill">GitHub Actions</span>
+ </div>
+ <p style="text-align: center; margin-top: 24px;">
+ <a href="https://github.com/cobusgreyling/loop-engineering/blob/main/docs/primitives-matrix.md">Full cross-tool matrix →</a>
+ </p>
+</section>
-## Deep Dives
+<section id="patterns" class="wrap">
+ <p class="section-label">Copy & run</p>
+ <h2 class="section-title">Production patterns</h2>
+ <p class="section-desc">Documented loops with scheduling, skills, state schemas, verification, and honest failure modes.</p>
+ <div class="patterns">
+ <article class="pattern-card">
+ <span class="tag">Most popular</span>
+ <h3>PR Babysitter</h3>
+ <p>Shepherd PRs through review, CI, rebase, and merge. Human stays in the judgment seat.</p>
+ <div class="pattern-meta">
+ <span>⏱ 5–15m</span>
+ <span>◆ Medium risk</span>
+ </div>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/blob/main/patterns/pr-babysitter.md">Read pattern →</a>
+ </article>
+ <article class="pattern-card">
+ <span class="tag">Start here</span>
+ <h3>Daily Triage</h3>
+ <p>Morning scan of CI, issues, and commits. Report-only week one, then small auto-wins.</p>
+ <div class="pattern-meta">
+ <span>⏱ 1d–2h</span>
+ <span>◆ Low risk</span>
+ </div>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/blob/main/patterns/daily-triage.md">Read pattern →</a>
+ </article>
+ <article class="pattern-card">
+ <span class="tag">High frequency</span>
+ <h3>CI Sweeper</h3>
+ <p>React to failing checks with minimal fixes. Classify flakes. Escalate after 3 attempts.</p>
+ <div class="pattern-meta">
+ <span>⏱ 5–15m</span>
+ <span>◆ Medium risk</span>
+ </div>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/blob/main/patterns/ci-sweeper.md">Read pattern →</a>
+ </article>
+ <article class="pattern-card">
+ <span class="tag">Off-peak</span>
+ <h3>Post-Merge Cleanup</h3>
+ <p>TODOs, deprecations, and tech debt after merges. Small PRs overnight.</p>
+ <div class="pattern-meta">
+ <span>⏱ 1d–6h</span>
+ <span>◆ Low risk</span>
+ </div>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/blob/main/patterns/post-merge-cleanup.md">Read pattern →</a>
+ </article>
+ </div>
+ <div class="stats">
+ <div class="stat">
+ <div class="num">4</div>
+ <div class="label">Patterns</div>
+ </div>
+ <div class="stat">
+ <div class="num">3</div>
+ <div class="label">Starter kits</div>
+ </div>
+ <div class="stat">
+ <div class="num">L0→L3</div>
+ <div class="label">Readiness levels</div>
+ </div>
+ <div class="stat">
+ <div class="num">100</div>
+ <div class="label">Audit score max</div>
+ </div>
+ </div>
+</section>
-- [Concepts & Vocabulary](./concepts.md)
-- [The Five Primitives](./primitives.md)
-- [Failure Modes](./failure-modes.md)
-- [Operating Loops](./operating-loops.md)
-- [Safety & Guardrails](./safety.md)
+<section id="start" class="wrap">
+ <p class="section-label">5 minutes</p>
+ <h2 class="section-title">Get started</h2>
+ <p class="section-desc">Clone a starter, audit your project, run report-only for one week.</p>
+ <div class="code-block">
+ <div class="code-header">
+ <div class="code-dots"><span></span><span></span><span></span></div>
+ <span>terminal — minimal loop</span>
+ </div>
+ <pre><span class="comment"># Copy starter into your project</span>
+cp -r starters/minimal-loop/.grok/skills/loop-triage .grok/skills/
+cp starters/minimal-loop/STATE.md.example STATE.md
-## Build
+<span class="comment"># Score loop readiness</span>
+node tools/loop-audit/dist/cli.js .
-- [Starters](../starters/) — cloneable kits
-- [Templates](../templates/) — skills and state schemas
-- [Examples](../examples/) — multi-tool implementations
-- [loop-audit](../tools/loop-audit/) — Loop Readiness Score CLI
+<span class="comment"># Grok — report only, week one</span>
+<span class="cmd">/loop</span> <span class="flag">1d</span> Run loop-triage. Update STATE.md. No auto-fix.</pre>
+ </div>
+ <p style="margin-top: 24px; text-align: center;">
+ <a href="https://github.com/cobusgreyling/loop-engineering/tree/main/starters">All starters</a>
+ ·
+ <a href="https://github.com/cobusgreyling/loop-engineering/blob/main/docs/loop-design-checklist.md">Design checklist</a>
+ ·
+ <a href="https://github.com/cobusgreyling/loop-engineering/tree/main/stories">Production stories</a>
+ </p>
+</section>
-## Community
+<section class="wrap" style="padding-top: 0;">
+ <p class="section-label">Deep dives</p>
+ <h2 class="section-title">Engineering, not hype</h2>
+ <div class="patterns">
+ <article class="pattern-card">
+ <h3>Failure Modes</h3>
+ <p>Infinite fix loops, verifier theater, token burn — with mitigations.</p>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/blob/main/docs/failure-modes.md">Read catalog →</a>
+ </article>
+ <article class="pattern-card">
+ <h3>Safety & Guardrails</h3>
+ <p>Path denylist, auto-merge policy, MCP least privilege.</p>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/blob/main/docs/safety.md">Read safety doc →</a>
+ </article>
+ <article class="pattern-card">
+ <h3>loop-audit CLI</h3>
+ <p>Loop Readiness Score 0–100. Know before you ship unattended.</p>
+ <a class="link" href="https://github.com/cobusgreyling/loop-engineering/tree/main/tools/loop-audit">Run audit →</a>
+ </article>
+ </div>
+</section>
-- [Contributing](../CONTRIBUTING.md)
-- [Production Stories](../stories/)
-- [Sources](../resources/sources.md)
\ No newline at end of file
+<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>
+
+<footer class="footer">
+ <p>
+ <a href="https://github.com/cobusgreyling/loop-engineering">GitHub</a>
+ ·
+ <a href="https://addyosmani.com/blog/loop-engineering/">Addy Osmani</a>
+ ·
+ MIT License
+ ·
+ Built by <a href="https://github.com/cobusgreyling">Cobus Greyling</a>
+ </p>
+</footer>
+
+</body>
+</html>
\ No newline at end of file