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
feat: wire loop-gate into starter loop scripts (#302)
THRISHAL DOMA5407b30c7109
diff --git a/starters/changelog-drafter-opencode/opencode.json.example b/starters/changelog-drafter-opencode/opencode.json.exampleindex d2de72b..faf6893 100644--- a/starters/changelog-drafter-opencode/opencode.json.example+++ b/starters/changelog-drafter-opencode/opencode.json.example@@ -15,7 +15,7 @@"name": "implementer","description": "L2 implementer for creating changelog PRs.","mode": "subagent",- "prompt": "Commit the approved release notes to a new branch and open a draft PR. Flag breaking changes and security items explicitly in the PR body. Do not merge.",+ "prompt": "Run npx @cobusgreyling/loop-gate check --action commit --paths <changed_files> before committing. Commit the approved release notes to a new branch and open a draft PR. Flag breaking changes and security items explicitly in the PR body. Do not merge.","permission": {"bash": "ask","edit": "ask"diff --git a/starters/ci-sweeper-opencode/README.md b/starters/ci-sweeper-opencode/README.mdindex 9fa8829..5ab04e9 100644--- a/starters/ci-sweeper-opencode/README.md+++ b/starters/ci-sweeper-opencode/README.md@@ -22,7 +22,7 @@ Start (L2 cautious — CI sweeper is action-oriented from week one):```bashopencode run \- "Run skills/ci-triage/SKILL.md. Classify each failing check. For clear single-file regressions, create a worktree and apply a minimal fix with verifier. Update ci-sweeper-state.md. Infra and security failures: escalate." \+ "Run skills/ci-triage/SKILL.md. Classify each failing check. For clear single-file regressions, create a worktree and apply a minimal fix with verifier. Run loop-gate check before commit. Update ci-sweeper-state.md. Infra and security failures: escalate." \--title "CI sweeper"```diff --git a/starters/ci-sweeper-opencode/opencode.json.example b/starters/ci-sweeper-opencode/opencode.json.exampleindex 4ae3ea2..106a698 100644--- a/starters/ci-sweeper-opencode/opencode.json.example+++ b/starters/ci-sweeper-opencode/opencode.json.example@@ -15,7 +15,7 @@"name": "implementer","description": "L2 implementer for CI-fix patches inside an isolated worktree.","mode": "subagent",- "prompt": "Implement the minimal fix for the identified CI failure inside the supplied worktree. Run tests. Output the diff path. Max 3 attempts per item.",+ "prompt": "Implement the minimal fix for the identified CI failure inside the supplied worktree. Run tests. Run npx @cobusgreyling/loop-gate check --action commit --paths <changed_files> before committing. Output the diff path. Max 3 attempts per item.","permission": {"bash": "ask","edit": "ask"diff --git a/starters/ci-sweeper/README.md b/starters/ci-sweeper/README.mdindex c0dc48e..3997ed8 100644--- a/starters/ci-sweeper/README.md+++ b/starters/ci-sweeper/README.md@@ -19,7 +19,7 @@ Scaffold for the [CI Sweeper](../../patterns/ci-sweeper.md) loop.3. Start (Grok):```bash- /loop 15m Check CI on main. Update ci-sweeper-state.md. Classify failures. For new actionable failures (not flakes): worktree + minimal-fix + loop-verifier. Escalate after 3 attempts.+ /loop 15m Check CI on main. Update ci-sweeper-state.md. Classify failures. For new actionable failures (not flakes): worktree + minimal-fix + loop-verifier. Run loop-gate check before commit. Escalate after 3 attempts.```## Flake Policydiff --git a/starters/dependency-sweeper-opencode/README.md b/starters/dependency-sweeper-opencode/README.mdindex 7335df3..9afabb2 100644--- a/starters/dependency-sweeper-opencode/README.md+++ b/starters/dependency-sweeper-opencode/README.md@@ -22,7 +22,7 @@ Start (L2 assisted, patch-only):```bashopencode run \- "Run skills/dependency-triage/SKILL.md. Scan package manifests for outdated and vulnerable deps. Patch-only auto-fix in worktree with verifier. Escalate majors, high-sev CVEs, and denylist packages. Update state." \+ "Run skills/dependency-triage/SKILL.md. Scan package manifests for outdated and vulnerable deps. Patch-only auto-fix in worktree with verifier. Run loop-gate check before commit. Escalate majors, high-sev CVEs, and denylist packages. Update state." \--title "Dependency sweeper"```diff --git a/starters/dependency-sweeper-opencode/opencode.json.example b/starters/dependency-sweeper-opencode/opencode.json.exampleindex 8579fd5..d542339 100644--- a/starters/dependency-sweeper-opencode/opencode.json.example+++ b/starters/dependency-sweeper-opencode/opencode.json.example@@ -15,7 +15,7 @@"name": "implementer","description": "L2 implementer for patch-only dependency upgrades in a worktree.","mode": "subagent",- "prompt": "Apply the identified patch-only upgrade inside the supplied worktree. Run npm ci && npm test. Never touch denylisted packages. Output the diff.",+ "prompt": "Apply the identified patch-only upgrade inside the supplied worktree. Run npm ci && npm test. Run npx @cobusgreyling/loop-gate check --action commit --paths <changed_files> before committing. Never touch denylisted packages. Output the diff.","permission": {"bash": "ask","edit": "ask"diff --git a/starters/dependency-sweeper/README.md b/starters/dependency-sweeper/README.mdindex 19309c2..caeb5da 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). 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-gate check before commit. Escalate majors, high-sev CVEs, and denylist packages. Update dependency-sweeper-state.md.```## What's Includeddiff --git a/starters/post-merge-cleanup-opencode/opencode.json.example b/starters/post-merge-cleanup-opencode/opencode.json.exampleindex 22f730d..3e353f0 100644--- a/starters/post-merge-cleanup-opencode/opencode.json.example+++ b/starters/post-merge-cleanup-opencode/opencode.json.example@@ -15,7 +15,7 @@"name": "implementer","description": "L2 implementer for small cleanup fixes inside an isolated worktree.","mode": "subagent",- "prompt": "Implement only the requested single-file cleanup inside the supplied worktree. Run tests. Never touch denylist paths. Output the diff.",+ "prompt": "Implement only the requested single-file cleanup inside the supplied worktree. Run tests. Run npx @cobusgreyling/loop-gate check --action commit --paths <changed_files> before committing. Never touch denylist paths. Output the diff.","permission": {"bash": "ask","edit": "ask"diff --git a/starters/post-merge-cleanup/README.md b/starters/post-merge-cleanup/README.mdindex b620932..80b0c39 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. 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-gate check before commit. Escalate refactors.```## Filesdiff --git a/starters/pr-babysitter-opencode/opencode.json.example b/starters/pr-babysitter-opencode/opencode.json.exampleindex 2446188..3298348 100644--- a/starters/pr-babysitter-opencode/opencode.json.example+++ b/starters/pr-babysitter-opencode/opencode.json.example@@ -15,7 +15,7 @@"name": "implementer","description": "L2 implementer for minimal PR fixes inside an isolated worktree.","mode": "subagent",- "prompt": "Implement only the requested minimal fix inside the supplied worktree. Respect AGENTS.md and LOOP.md. Run documented tests. Never force-push. Draft PR by default.",+ "prompt": "Implement only the requested minimal fix inside the supplied worktree. Respect AGENTS.md and LOOP.md. Run documented tests. Run npx @cobusgreyling/loop-gate check --action commit --paths <changed_files> before committing. Never force-push. Draft PR by default.","permission": {"bash": "ask","edit": "ask"diff --git a/starters/pr-babysitter/README.md b/starters/pr-babysitter/README.mdindex 618d968..c86f3cf 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. 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-gate check before commit. Never merge — propose only. Escalate after 3 attempts per PR.```4. Sign PR comments: `🤖 Loop Engineering — PR Babysitter`