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
docs: wire loop-context circuit breaker into fix-capable patterns (#335)
M V Abhirama63571e58060
diff --git a/examples/github-actions/ci-sweeper.yml b/examples/github-actions/ci-sweeper.ymlindex 8744422..8b62966 100644--- a/examples/github-actions/ci-sweeper.yml+++ b/examples/github-actions/ci-sweeper.yml@@ -37,7 +37,21 @@ jobs:echo "- URL: ${{ github.event.workflow_run.html_url }}" >> "$FILE"echo "- Loop action: pending agent invocation" >> "$FILE"+ - name: Circuit breaker check+ id: circuit_breaker+ run: |+ npx --yes @cobusgreyling/loop-context --check --ledger loop-ledger.json \+ --budget-from-pattern ci-sweeper --budget-level L2 || echo "tripped=true" >> "$GITHUB_OUTPUT"+ continue-on-error: true+- name: Invoke fix agent+ if: steps.circuit_breaker.outputs.tripped != 'true'run: |echo "::notice::Wire to agent: classify failure, worktree fix, verifier, open PR."- echo "See patterns/ci-sweeper.md and docs/safety.md"\ No newline at end of file+ echo "See patterns/ci-sweeper.md and docs/safety.md"++ - name: Escalate (circuit breaker tripped)+ if: steps.circuit_breaker.outputs.tripped == 'true'+ run: |+ echo "::warning::Circuit breaker tripped — same failure recurred or attempt cap reached."+ echo "Escalating to human instead of retrying. See docs/safety.md#human-gates-required."\ No newline at end of filediff --git a/examples/github-actions/dependency-sweeper.yml b/examples/github-actions/dependency-sweeper.ymlindex 95a42c9..974bdca 100644--- a/examples/github-actions/dependency-sweeper.yml+++ b/examples/github-actions/dependency-sweeper.yml@@ -18,8 +18,21 @@ jobs:with:node-version: '22'+ - name: Circuit breaker check+ id: circuit_breaker+ run: |+ npx --yes @cobusgreyling/loop-context --check --ledger loop-ledger.json \+ --budget-from-pattern dependency-sweeper --budget-level L2 || echo "tripped=true" >> "$GITHUB_OUTPUT"+ continue-on-error: true+- name: Placeholder — wire to your agent runtime+ if: steps.circuit_breaker.outputs.tripped != 'true'run: |echo "Run dependency-triage (npm audit / outdated)."echo "Patch-only fixes in worktree with verifier."- echo "Update dependency-sweeper-state.md — escalate majors."\ No newline at end of file+ echo "Update dependency-sweeper-state.md — escalate majors."++ - name: Escalate (circuit breaker tripped)+ if: steps.circuit_breaker.outputs.tripped == 'true'+ run: |+ echo "::warning::Circuit breaker tripped for this package — see docs/safety.md#human-gates-required."\ No newline at end of filediff --git a/patterns/dependency-sweeper.md b/patterns/dependency-sweeper.mdindex 9248707..9eb1c50 100644--- a/patterns/dependency-sweeper.md+++ b/patterns/dependency-sweeper.md@@ -43,6 +43,21 @@ Prune merged/closed entries on every run.6. Update the state file and (optionally) comment on open dependency PRs.7. On next run, re-evaluate open items and close stale or conflicting ones.+## Circuit Breaker++This is a fix-capable (L2) pattern, so `loop-init` scaffolds the `loop-guard` skill and a seeded `loop-ledger.json` for it automatically. Before each retry on the same package, run the circuit breaker:++```bash+npx @cobusgreyling/loop-context --check --ledger loop-ledger.json \+ --budget-from-pattern dependency-sweeper --budget-level L2+```++If the same failure recurs or the attempt cap is hit (see "Escalate after 2+tries" below), it exits non-zero — stop retrying and escalate to a human+instead of looping. See [docs/safety.md](../docs/safety.md).+++## Verification Strategy- **Never** let the implementer sub-agent declare success.diff --git a/patterns/post-merge-cleanup.md b/patterns/post-merge-cleanup.mdindex aaf35d6..cca61b4 100644--- a/patterns/post-merge-cleanup.md+++ b/patterns/post-merge-cleanup.md@@ -50,6 +50,18 @@ Last run: 2026-06-09 22:00 UTC6. Open small PRs or batch into a single "cleanup" PR per day.7. Update state; prune completed items.+## Circuit Breaker++This is a fix-capable (L2) pattern, so `loop-init` scaffolds the `loop-guard` skill and a seeded `loop-ledger.json` for it automatically. Run the circuit breaker before each retry on the same regression:++```bash+npx @cobusgreyling/loop-context --check --ledger loop-ledger.json \+ --budget-from-pattern post-merge-cleanup --budget-level L2+```++Non-zero exit means the same failure repeated or the attempt cap was hit —+stop and escalate to a human. See [docs/safety.md](../docs/safety.md).+## Verification Strategy- Cleanup must not alter behavior unless explicitly removing dead code paths.diff --git a/patterns/pr-babysitter.md b/patterns/pr-babysitter.mdindex 2a4f48c..98f671b 100644--- a/patterns/pr-babysitter.md+++ b/patterns/pr-babysitter.md@@ -44,6 +44,20 @@ Example state entry:4. Write concise updates back to the PR and to state.5. Anything ambiguous or high-risk → surface to human with context.+## Circuit Breaker++This is a fix-capable (L2) pattern, so `loop-init` scaffolds the `loop-guard` skill and a seeded `loop-ledger.json` for it automatically. Run the circuit breaker before each retry attempt on a watched PR:++```bash+npx @cobusgreyling/loop-context --check --ledger loop-ledger.json \+ --budget-from-pattern pr-babysitter --budget-level L2+```++Non-zero exit means the same failure repeated or the attempt cap was hit —+stop and escalate to a human instead of continuing to comment/retry on the+PR. See [docs/safety.md](../docs/safety.md).++## Verification Strategy- Never let the implementer sub-agent mark its own work "done".diff --git a/starters/dependency-sweeper/README.md b/starters/dependency-sweeper/README.mdindex caeb5da..e8343bd 100644--- a/starters/dependency-sweeper/README.md+++ b/starters/dependency-sweeper/README.md@@ -24,7 +24,7 @@ Claude Code / Codex: use `--tool claude` or `--tool codex` with `loop-init`.Start (Grok):```-/loop 6h Run dependency-triage on package manifests and lockfiles. Patch-only auto-fix in worktree + verifier (npm ci && npm test). Run loop-gate check before commit. Escalate majors, high-sev CVEs, and denylist packages. Update dependency-sweeper-state.md.+/loop 6h Run dependency-triage on package manifests and lockfiles. Patch-only auto-fix in worktree + verifier (npm ci && npm test). Run loop-context --check before each retry on the same package; run loop-gate check before commit. Escalate majors, high-sev CVEs, and denylist packages after 2 attempts. Update dependency-sweeper-state.md.```## What's Includeddiff --git a/starters/post-merge-cleanup/README.md b/starters/post-merge-cleanup/README.mdindex 80b0c39..181c1b0 100644--- a/starters/post-merge-cleanup/README.md+++ b/starters/post-merge-cleanup/README.md@@ -17,7 +17,7 @@ cp starters/post-merge-cleanup/LOOP.md .Start (Grok):```-/loop 1d Run post-merge-scan on merges to main (last 7d). Update post-merge-state.md. Small doc/link fixes only in worktree. Run loop-gate check before commit. Escalate refactors.+/loop 1d Run post-merge-scan on merges to main (last 7d). Update post-merge-state.md. Small doc/link fixes only in worktree. Run loop-context --check before each retry on the same regression; run loop-gate check before commit. Escalate refactors.```## Filesdiff --git a/starters/pr-babysitter/README.md b/starters/pr-babysitter/README.mdindex c86f3cf..29735d8 100644--- a/starters/pr-babysitter/README.md+++ b/starters/pr-babysitter/README.md@@ -17,7 +17,7 @@ Scaffold for the [PR Babysitter](../../patterns/pr-babysitter.md) loop (L2 — a3. Start (Grok):```bash- /loop 5m Check open PRs. Update pr-babysitter-state.md. For CI failures or actionable review comments on allowlisted PRs: worktree + minimal-fix + loop-verifier. Run loop-gate check before commit. Never merge — propose only. Escalate after 3 attempts per PR.+ /loop 5m Check open PRs. Update pr-babysitter-state.md. For CI failures or actionable review comments on allowlisted PRs: worktree + minimal-fix + loop-verifier. Run loop-context --check before each retry; run loop-gate check before commit. Never merge — propose only. Escalate after 3 attempts per PR.```4. Sign PR comments: `🤖 Loop Engineering — PR Babysitter`