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.

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.example
index 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.md
index 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):
```bash
opencode 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.example
index 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.md
index 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 Policy
diff --git a/starters/dependency-sweeper-opencode/README.md b/starters/dependency-sweeper-opencode/README.md
index 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):
```bash
opencode 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.example
index 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.md
index 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 Included
diff --git a/starters/post-merge-cleanup-opencode/opencode.json.example b/starters/post-merge-cleanup-opencode/opencode.json.example
index 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.md
index 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.
```
## Files
diff --git a/starters/pr-babysitter-opencode/opencode.json.example b/starters/pr-babysitter-opencode/opencode.json.example
index 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.md
index 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 — a
3. 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`