Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.**
Expand Down Expand Up @@ -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>
35 changes: 31 additions & 4 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,8 @@ <h1>Design the system<br>that prompts your agents</h1>
</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>
Expand All @@ -76,6 +76,13 @@ <h1>Design the system<br>that prompts your agents</h1>
<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>
Expand Down Expand Up @@ -204,7 +211,18 @@ <h3>Dependency Sweeper</h3>
</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">
Expand All @@ -217,7 +235,7 @@ <h3>Changelog Drafter</h3>
</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">
Expand Down Expand Up @@ -280,6 +298,7 @@ <h3 style="font-size:1rem; margin-bottom:8px;">What's hurting right now?</h3>
<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;">
Expand Down Expand Up @@ -471,6 +490,14 @@ <h2>Ready to stop prompting?</h2>
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'
}
};

Expand Down