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
merge: opencode + openclaw 7/7 coverage, loop-init 1.3.2 (#111)
Cobus Greyling9b040f5696ab
diff --git a/examples/README.md b/examples/README.mdindex 977fff6..4f3651b 100644--- a/examples/README.md+++ b/examples/README.md@@ -19,21 +19,21 @@ Start with [primitives-matrix.md](../docs/primitives-matrix.md) to map capabilit| Pattern | Grok | Claude | Codex | OpenClaw | Opencode | GH Actions ||---------|------|--------|-------|----------|----------|------------|| Daily Triage | [grok/daily-triage.md](./grok/daily-triage.md) | [claude-code/daily-triage.md](./claude-code/daily-triage.md) | [codex/daily-triage.md](./codex/daily-triage.md) | [openclaw/daily-triage.md](./openclaw/daily-triage.md) | [opencode/daily-triage.md](./opencode/daily-triage.md) | [github-actions/daily-triage.yml](./github-actions/daily-triage.yml) |-| PR Babysitter | [grok/pr-babysitter.md](./grok/pr-babysitter.md) | [claude-code/pr-babysitter.md](./claude-code/pr-babysitter.md) | [codex/pr-babysitter.md](./codex/pr-babysitter.md) | — | [opencode/pr-babysitter.md](./opencode/pr-babysitter.md) | [github-actions/pr-babysitter.yml](./github-actions/pr-babysitter.yml) |-| CI Sweeper | [grok/ci-sweeper.md](./grok/ci-sweeper.md) | [claude-code/ci-sweeper.md](./claude-code/ci-sweeper.md) | [codex/ci-sweeper.md](./codex/ci-sweeper.md) | — | [opencode/ci-sweeper.md](./opencode/ci-sweeper.md) | [github-actions/ci-sweeper.yml](./github-actions/ci-sweeper.yml) |-| Post-Merge Cleanup | [grok/post-merge-cleanup.md](./grok/post-merge-cleanup.md) | [claude-code/post-merge-cleanup.md](./claude-code/post-merge-cleanup.md) | [codex/post-merge-cleanup.md](./codex/post-merge-cleanup.md) | — | — | [github-actions/post-merge-cleanup.yml](./github-actions/post-merge-cleanup.yml) |-| Dependency Sweeper | [grok/dependency-sweeper.md](./grok/dependency-sweeper.md) | [claude-code/dependency-sweeper.md](./claude-code/dependency-sweeper.md) | [codex/dependency-sweeper.md](./codex/dependency-sweeper.md) | — | — | [github-actions/dependency-sweeper.yml](./github-actions/dependency-sweeper.yml) |-| Changelog Drafter | [grok/changelog-drafter.md](./grok/changelog-drafter.md) | [claude-code/changelog-drafter.md](./claude-code/changelog-drafter.md) | [codex/changelog-drafter.md](./codex/changelog-drafter.md) | — | — | [github-actions/changelog-drafter.yml](./github-actions/changelog-drafter.yml) |-| Issue Triage | [grok/issue-triage.md](./grok/issue-triage.md) | [claude-code/issue-triage.md](./claude-code/issue-triage.md) | [codex/issue-triage.md](./codex/issue-triage.md) | — | — | [github-actions/issue-triage.yml](./github-actions/issue-triage.yml) |+| PR Babysitter | [grok/pr-babysitter.md](./grok/pr-babysitter.md) | [claude-code/pr-babysitter.md](./claude-code/pr-babysitter.md) | [codex/pr-babysitter.md](./codex/pr-babysitter.md) | [openclaw/pr-babysitter.md](./openclaw/pr-babysitter.md) | [opencode/pr-babysitter.md](./opencode/pr-babysitter.md) | [github-actions/pr-babysitter.yml](./github-actions/pr-babysitter.yml) |+| CI Sweeper | [grok/ci-sweeper.md](./grok/ci-sweeper.md) | [claude-code/ci-sweeper.md](./claude-code/ci-sweeper.md) | [codex/ci-sweeper.md](./codex/ci-sweeper.md) | [openclaw/ci-sweeper.md](./openclaw/ci-sweeper.md) | [opencode/ci-sweeper.md](./opencode/ci-sweeper.md) | [github-actions/ci-sweeper.yml](./github-actions/ci-sweeper.yml) |+| Post-Merge Cleanup | [grok/post-merge-cleanup.md](./grok/post-merge-cleanup.md) | [claude-code/post-merge-cleanup.md](./claude-code/post-merge-cleanup.md) | [codex/post-merge-cleanup.md](./codex/post-merge-cleanup.md) | [openclaw/post-merge-cleanup.md](./openclaw/post-merge-cleanup.md) | [opencode/post-merge-cleanup.md](./opencode/post-merge-cleanup.md) | [github-actions/post-merge-cleanup.yml](./github-actions/post-merge-cleanup.yml) |+| Dependency Sweeper | [grok/dependency-sweeper.md](./grok/dependency-sweeper.md) | [claude-code/dependency-sweeper.md](./claude-code/dependency-sweeper.md) | [codex/dependency-sweeper.md](./codex/dependency-sweeper.md) | [openclaw/dependency-sweeper.md](./openclaw/dependency-sweeper.md) | [opencode/dependency-sweeper.md](./opencode/dependency-sweeper.md) | [github-actions/dependency-sweeper.yml](./github-actions/dependency-sweeper.yml) |+| Changelog Drafter | [grok/changelog-drafter.md](./grok/changelog-drafter.md) | [claude-code/changelog-drafter.md](./claude-code/changelog-drafter.md) | [codex/changelog-drafter.md](./codex/changelog-drafter.md) | [openclaw/changelog-drafter.md](./openclaw/changelog-drafter.md) | [opencode/changelog-drafter.md](./opencode/changelog-drafter.md) | [github-actions/changelog-drafter.yml](./github-actions/changelog-drafter.yml) |+| Issue Triage | [grok/issue-triage.md](./grok/issue-triage.md) | [claude-code/issue-triage.md](./claude-code/issue-triage.md) | [codex/issue-triage.md](./codex/issue-triage.md) | [openclaw/issue-triage.md](./openclaw/issue-triage.md) | [opencode/issue-triage.md](./opencode/issue-triage.md) | [github-actions/issue-triage.yml](./github-actions/issue-triage.yml) |L2 patterns ship multi-tool skills inside one starter folder — see `starters/<pattern>/`.-**Copy-paste starters** (L1 daily triage):+**Copy-paste starters**:-| Tool | Starter |-|------|---------|-| Grok | [starters/minimal-loop](../starters/minimal-loop/) |-| Claude Code | [starters/minimal-loop-claude](../starters/minimal-loop-claude/) |-| Codex | [starters/minimal-loop-codex](../starters/minimal-loop-codex/) |-| OpenClaw | [openclaw/daily-triage.md](./openclaw/daily-triage.md) (manual setup) |-| Opencode | [starters/minimal-loop-opencode](../starters/minimal-loop-opencode/) |+| Tool | Daily Triage (L1) | PR Babysitter | CI Sweeper | Dependency Sweeper | Post-Merge | Changelog | Issue Triage |+|------|-------------------|---------------|------------|-------------------|------------|-----------|--------------|+| Grok | [minimal-loop](../starters/minimal-loop/) | [pr-babysitter](../starters/pr-babysitter/) | [ci-sweeper](../starters/ci-sweeper/) | [dependency-sweeper](../starters/dependency-sweeper/) | [post-merge-cleanup](../starters/post-merge-cleanup/) | [changelog-drafter](../starters/changelog-drafter/) | [issue-triage](../starters/issue-triage/) |+| Claude Code | [minimal-loop-claude](../starters/minimal-loop-claude/) | via `loop-init --tool claude` | via `loop-init --tool claude` | via `loop-init --tool claude` | via `loop-init --tool claude` | via `loop-init --tool claude` | via `loop-init --tool claude` |+| Codex | [minimal-loop-codex](../starters/minimal-loop-codex/) | via `loop-init --tool codex` | via `loop-init --tool codex` | via `loop-init --tool codex` | via `loop-init --tool codex` | via `loop-init --tool codex` | via `loop-init --tool codex` |+| OpenClaw | [openclaw/daily-triage.md](./openclaw/daily-triage.md) (manual) | [openclaw/pr-babysitter.md](./openclaw/pr-babysitter.md) | [openclaw/ci-sweeper.md](./openclaw/ci-sweeper.md) | [openclaw/dependency-sweeper.md](./openclaw/dependency-sweeper.md) | [openclaw/post-merge-cleanup.md](./openclaw/post-merge-cleanup.md) | [openclaw/changelog-drafter.md](./openclaw/changelog-drafter.md) | [openclaw/issue-triage.md](./openclaw/issue-triage.md) |+| Opencode | [minimal-loop-opencode](../starters/minimal-loop-opencode/) | [pr-babysitter-opencode](../starters/pr-babysitter-opencode/) | [ci-sweeper-opencode](../starters/ci-sweeper-opencode/) | [dependency-sweeper-opencode](../starters/dependency-sweeper-opencode/) | [post-merge-cleanup-opencode](../starters/post-merge-cleanup-opencode/) | [changelog-drafter-opencode](../starters/changelog-drafter-opencode/) | [issue-triage-opencode](../starters/issue-triage-opencode/) |diff --git a/examples/openclaw/README.md b/examples/openclaw/README.mdindex 937464a..84d912e 100644--- a/examples/openclaw/README.md+++ b/examples/openclaw/README.md@@ -5,7 +5,13 @@ Self-hosted Gateway: cron scheduling, workspace skills, MCP, multi-agent routing| Example | Pattern ||---------|---------|| [daily-triage.md](./daily-triage.md) | Daily Triage (L1 report → L2 assisted) |+| [pr-babysitter.md](./pr-babysitter.md) | PR Babysitter (L1 watch → L2 assisted) |+| [ci-sweeper.md](./ci-sweeper.md) | CI Sweeper (L2 cautious) |+| [post-merge-cleanup.md](./post-merge-cleanup.md) | Post-Merge Cleanup (L1 report → L2) |+| [dependency-sweeper.md](./dependency-sweeper.md) | Dependency Sweeper (L2 patch-only) |+| [changelog-drafter.md](./changelog-drafter.md) | Changelog Drafter (L1 draft → L2) |+| [issue-triage.md](./issue-triage.md) | Issue Triage (L1 propose-only) |-No `loop-init --tool openclaw` yet — copy skills and state manually; see [daily-triage.md](./daily-triage.md).+No `loop-init --tool openclaw` yet — copy skills and state manually.See [docs/primitives-matrix.md](../../docs/primitives-matrix.md).\ No newline at end of filediff --git a/examples/openclaw/changelog-drafter.md b/examples/openclaw/changelog-drafter.mdnew file mode 100644index 0000000..83fc70d--- /dev/null+++ b/examples/openclaw/changelog-drafter.md@@ -0,0 +1,44 @@+# Changelog Drafter — OpenClaw++Scan merged PRs and commits, produce categorized release notes. Excellent low-risk L1 loop — pairs naturally with Post-Merge Cleanup.++## Prerequisites++```bash+mkdir -p skills/changelog-scan skills/draft-release-notes+cp templates/SKILL.md.loop-triage skills/changelog-scan/SKILL.md+cp templates/SKILL.md.loop-triage skills/draft-release-notes/SKILL.md+cp starters/minimal-loop/STATE.md.example changelog-drafter-state.md+```++## L1 — Report + Draft (Week 1)++```bash+openclaw cron create "0 3 * * *" \+ --name "Changelog drafter" \+ --session isolated \+ --message "Run skills/changelog-scan/SKILL.md. Scan merges since the last tag (or last 7 days). Produce a clean categorized draft in RELEASE_NOTES_DRAFT.md using skills/draft-release-notes/SKILL.md. Update changelog-drafter-state.md. Do not publish, tag, or create PRs." \+ --tools read,write+```++## L2 — PR Proposal (Week 3+)++```bash+openclaw cron edit <job-id> \+ --message "Run changelog-scan and draft-release-notes. If the draft looks good, create a new branch and commit RELEASE_NOTES_DRAFT.md. Open a draft PR. Flag breaking changes and security items explicitly in the PR body. Do not merge."+```++## What the Loop Maintains++- `changelog-drafter-state.md` — last scanned window, draft status, human feedback+- `RELEASE_NOTES_DRAFT.md` — overwritten or versioned each run++## Safety++- Draft-only in week one. No tags, no PRs, no publishes without human approval.+- Breaking changes and security items must be surfaced explicitly.++## References++- [patterns/changelog-drafter.md](../../patterns/changelog-drafter.md)+- [stories/changelog-drafter-week-one.md](../../stories/changelog-drafter-week-one.md)diff --git a/examples/openclaw/ci-sweeper.md b/examples/openclaw/ci-sweeper.mdnew file mode 100644index 0000000..f5e2ca7--- /dev/null+++ b/examples/openclaw/ci-sweeper.md@@ -0,0 +1,55 @@+# CI Sweeper — OpenClaw++React to failing CI with minimal fixes and short cadences. OpenClaw's isolated cron sessions at 5–15 minute intervals are a natural fit.++## Prerequisites++```bash+mkdir -p skills/ci-triage skills/minimal-fix skills/loop-verifier+cp templates/SKILL.md.loop-triage skills/ci-triage/SKILL.md+cp templates/SKILL.md.minimal-fix skills/minimal-fix/SKILL.md+cp templates/SKILL.md.verifier skills/loop-verifier/SKILL.md+cp starters/minimal-loop/STATE.md.example ci-sweeper-state.md+```++## Cadence: cron++```bash+openclaw cron create "*/5 * * * *" \+ --name "CI sweeper" \+ --session isolated \+ --message "Run skills/ci-triage/SKILL.md. Classify each failing check. For clear single-file regressions, create a git worktree, implement the fix, run tests, and have a verifier pass review. Update ci-sweeper-state.md. Infra and security failures escalate to a human. Max 3 attempts per item." \+ --tools read,write,exec+```++Use [loop-cost](https://github.com/cobusgreyling/loop-engineering/blob/main/tools/loop-cost) before choosing a cadence.++## Webhook variant (post-deploy)++```bash+curl -X POST http://127.0.0.1:18789/hooks/agent \+ -H 'Authorization: Bearer <hooks-token>' \+ -H 'Content-Type: application/json' \+ -d '{"message":"Run ci-triage on recent CI failures. Inspect and classify. No fixes in report-only mode.","name":"CI triage","deliver":false}'+```++## Verification Split++| Role | OpenClaw shape |+|------|----------------|+| Triage | Isolated cron + `ci-triage` skill |+| Implementer | Main agent or `coding-agent` in worktree |+| Verifier | Second agent id or checker block in cron `--message` |++## Safety++- Always dispatch into a git worktree per attempt.+- Infra / security / payments test failures: do not auto-fix; flag and stop.+- Max 3 fix attempts per item; escalate after.+- Restrict `--tools` until the loop is trusted.++## References++- [patterns/ci-sweeper.md](../../patterns/ci-sweeper.md)+- [docs/safety.md](../../docs/safety.md)+- [tools/loop-cost](../../tools/loop-cost)diff --git a/examples/openclaw/dependency-sweeper.md b/examples/openclaw/dependency-sweeper.mdnew file mode 100644index 0000000..6ef7cc4--- /dev/null+++ b/examples/openclaw/dependency-sweeper.md@@ -0,0 +1,50 @@+# Dependency Sweeper — OpenClaw++Discover, safely apply, and verify dependency updates. OpenClaw's worktree isolation via `exec` + `git worktree` keeps each attempt safe.++## Prerequisites++```bash+mkdir -p skills/dependency-triage skills/loop-verifier skills/minimal-fix+cp templates/SKILL.md.loop-triage skills/dependency-triage/SKILL.md+cp templates/SKILL.md.verifier skills/loop-verifier/SKILL.md+cp templates/SKILL.md.minimal-fix skills/minimal-fix/SKILL.md+cp starters/minimal-loop/STATE.md.example dependency-sweeper-state.md+```++## L1 — Report Mode (Week 1)++```bash+openclaw cron create "0 */6 * * *" \+ --name "Dependency sweeper" \+ --session isolated \+ --message "Run skills/dependency-triage/SKILL.md. Scan package manifests and lockfiles for outdated and vulnerable deps. Report findings only — do not edit any files. Update dependency-sweeper-state.md with the top-priority items. Escalate majors and high-sev CVEs." \+ --tools read+```++## L2 — Patch-Only Auto-Fix (Week 3+)++```bash+openclaw cron edit <job-id> \+ --message "Run dependency-triage. For the highest-severity patch-only upgrade: apply the fix in a worktree, run npm ci && npm test, have a verifier review the diff. Never touch denylisted packages. Escalate majors to a human."+```++## Verification Split++| Role | OpenClaw shape |+|------|----------------|+| Triage | Isolated cron with `--tools read` |+| Implementer | Main agent or `coding-agent` in worktree |+| Verifier | Second agent id or checker block in cron `--message` |++## Safety++- **Patch-only by default.** Majors and breaking changes escalate to human.+- Maintain a denylist in `dependency-sweeper-state.md`.+- Max 3 fix attempts per run; pause after 5 auto-PRs per day.++## References++- [patterns/dependency-sweeper.md](../../patterns/dependency-sweeper.md)+- [docs/safety.md](../../docs/safety.md)+- [stories/dependency-sweeper-week-one.md](../../stories/dependency-sweeper-week-one.md)diff --git a/examples/openclaw/issue-triage.md b/examples/openclaw/issue-triage.mdnew file mode 100644index 0000000..5b91be8--- /dev/null+++ b/examples/openclaw/issue-triage.md@@ -0,0 +1,44 @@+# Issue Triage — OpenClaw++Keep the issue queue legible so morning triage and humans always know the top five. Low-risk companion to Daily Triage. OpenClaw's frequent cron cadence (2h–1d) keeps the queue fresh.++## Prerequisites++```bash+mkdir -p skills/issue-triage+cp templates/SKILL.md.issue-triage skills/issue-triage/SKILL.md+cp starters/minimal-loop/STATE.md.example issue-triage-state.md+```++## L1 — Propose Only (Week 1)++```bash+openclaw cron create "0 */2 * * *" \+ --name "Issue triage" \+ --session isolated \+ --message "Run skills/issue-triage/SKILL.md. Read issue-triage-state.md first. Scan open issues since last run. Update state with top 5 prioritized items, proposed labels, and needs-human bucket. Propose only — do not apply labels, close, or comment on issues. Escalate duplicates as possible duplicate of #NNN for human confirmation." \+ --tools read+```++## L2 — Auto-Label Allowlisted Labels (Week 3+)++```bash+openclaw cron edit <job-id> \+ --message "Run issue-triage. For allowlisted labels (area:*, needs-repro, needs-info, duplicate?) apply them after verifier passes. Never auto-apply P0, P1, security, or breaking-change labels. Never close or comment without human approval."+```++## Pairing with Daily Triage++Issue Triage runs more frequently (2h–1d) and produces a clean queue. Daily Triage (1d) reads `issue-triage-state.md` and merges the top items into `STATE.md` High Priority.++## Safety++- L1: propose only — never auto-label, auto-close, or auto-comment.+- P0/P1 on auth, payments, security, or public API: always escalate to a human.+- L2 auto-labels limited to curated allowlist; verifier gate required.++## References++- [patterns/issue-triage.md](../../patterns/issue-triage.md)+- [docs/primitives-matrix.md](../../docs/primitives-matrix.md)+- [examples/github-actions/issue-triage.yml](../github-actions/issue-triage.yml)diff --git a/examples/openclaw/post-merge-cleanup.md b/examples/openclaw/post-merge-cleanup.mdnew file mode 100644index 0000000..b7c2263--- /dev/null+++ b/examples/openclaw/post-merge-cleanup.md@@ -0,0 +1,43 @@+# Post-Merge Cleanup — OpenClaw++Follow-up tech debt after merges land on main. Low-risk L1 loop — pairs naturally with Daily Triage.++## Prerequisites++```bash+mkdir -p skills/post-merge-scan+cp templates/SKILL.md.loop-triage skills/post-merge-scan/SKILL.md+cp starters/minimal-loop/STATE.md.example post-merge-state.md+```++## Report-Only (Week 1)++Run off-peak (evening) to avoid colliding with active work:++```bash+openclaw cron create "0 2 * * *" \+ --name "Post-merge cleanup" \+ --session isolated \+ --message "Run skills/post-merge-scan/SKILL.md. Read post-merge-state.md first. Scan merges to main in the last 48h. Propose small doc/lint/comment fixes only — ticket anything architectural or multi-file. Update post-merge-state.md. Do not edit source code." \+ --tools read+```++## With Small Auto-Fixes (Week 2+)++```bash+openclaw cron edit <job-id> \+ --message "Run post-merge-scan. For the highest-priority single-file cleanup: implement the fix in a worktree, run tests, have a verifier review. Escalate to a human for anything on denylist paths."+```++## Safety++- Run off-peak to avoid collision with active branches.+- Never auto-fix architectural debt — file a ticket.+- Denylist paths always go to a human.+- Max 2 fix attempts per run.++## References++- [patterns/post-merge-cleanup.md](../../patterns/post-merge-cleanup.md)+- [docs/safety.md](../../docs/safety.md)+- [stories/post-merge-cleanup-honest-win.md](../../stories/post-merge-cleanup-honest-win.md)diff --git a/examples/openclaw/pr-babysitter.md b/examples/openclaw/pr-babysitter.mdnew file mode 100644index 0000000..6c924e4--- /dev/null+++ b/examples/openclaw/pr-babysitter.md@@ -0,0 +1,51 @@+# PR Babysitter — OpenClaw++Watch open PRs, surface blockers, and act only on safe obvious maintenance tasks. OpenClaw's channel delivery (Slack, Telegram) makes it ideal for PR notifications.++## Report-Only (Week 1)++```bash+openclaw cron create "*/15 * * * *" \+ --name "PR babysitter" \+ --session isolated \+ --message "Run PR babysitter triage. Read pr-babysitter-state.md first. List PRs with red CI, stale review, merge conflicts, or unanswered review comments. Do not edit code. Update pr-babysitter-state.md and end with the top 3 human actions." \+ --tools read \+ --announce \+ --channel slack \+ --to "channel:C1234567890"+```++Omit `--announce` to keep output in the Gateway only. Report-only in week one: read GitHub state, update state, notify humans.++## With Small Auto-Fixes (Week 3+)++```bash+openclaw cron edit <job-id> \+ --message "Run PR babysitter triage. For PRs authored by us with red CI caused by a clear single-file regression: create a git worktree, apply a minimal fix, run tests, have a verifier pass review the diff. Draft PR by default — never force-push."+```++## Idempotency++Before pushing, the loop must check whether an open PR or branch already exists for the same intent. Use a webhook or GitHub CLI within the worktree.++## Verification Split++| Role | OpenClaw shape |+|------|----------------|+| Triage | Isolated cron with `--tools read` |+| Implementer | `coding-agent` in worktree via `exec`, or main agent with expanded tools |+| Verifier | Second agent id in `agents.list`, or checker block in cron `--message` |++## Safety++- Never force-push without explicit human opt-in.+- Draft PRs by default; humans mark ready for review.+- Do not resolve review threads without approval.+- Security, auth, payments, infra, or public API changes always escalate.+- Max 3 fix attempts per PR before handoff.++## References++- [patterns/pr-babysitter.md](../../patterns/pr-babysitter.md)+- [docs/safety.md](../../docs/safety.md)+- [examples/github-actions/pr-babysitter.yml](../github-actions/pr-babysitter.yml)diff --git a/examples/opencode/changelog-drafter.md b/examples/opencode/changelog-drafter.mdnew file mode 100644index 0000000..95fc546--- /dev/null+++ b/examples/opencode/changelog-drafter.md@@ -0,0 +1,53 @@+# Changelog Drafter — Opencode++Scan merged PRs and commits, produce categorized release notes. Excellent low-risk L1 loop — pairs naturally with Post-Merge Cleanup.++## Prerequisites++```bash+mkdir -p skills/changelog-scan skills/draft-release-notes+cp templates/SKILL.md.loop-triage skills/changelog-scan/SKILL.md # adapt for merge scan+cp templates/SKILL.md.loop-triage skills/draft-release-notes/SKILL.md # adapt for drafting+cp starters/minimal-loop-opencode/opencode.json.example opencode.json+cp starters/changelog-drafter-opencode/changelog-drafter-state.md.example changelog-drafter-state.md+```++## L1 — Report + Draft (Week 1)++```bash+opencode run \+ "Run skills/changelog-scan/SKILL.md. Read changelog-drafter-state.md. Scan merges to main since the last tag (or last 7 days). Produce a clean categorized draft in RELEASE_NOTES_DRAFT.md using skills/draft-release-notes/SKILL.md. Update state with the scanned window and draft status. Do not publish, tag, or create any PRs." \+ --title "Changelog drafter"+```++Cron (daily, after merges settle):++```cron+0 3 * * * cd /repo && opencode run "Scan merges since last tag, draft categorized release notes, update state. Human review only."+```++## L2 — PR Proposal (Week 3+)++Once drafts are consistently well-structured, let the loop open a draft PR with the approved notes:++```bash+opencode run \+ "Run changelog-scan and draft-release-notes. If the draft looks good, create a new branch and commit RELEASE_NOTES_DRAFT.md. Open a draft PR titled 'chore: release notes draft'. Flag breaking changes and security items explicitly in the PR body. Do not merge." \+ --agent implementer+```++## What the Loop Maintains++- `changelog-drafter-state.md` — last scanned window, draft status, human feedback+- `RELEASE_NOTES_DRAFT.md` — overwritten or versioned each run++## Safety++- **Draft-only in week one.** No tags, no PRs, no publishes without human approval.+- Breaking changes and security items must be surfaced explicitly for human sign-off.+- After L2 graduation: draft PRs only, never auto-merge.++## References++- [patterns/changelog-drafter.md](../../patterns/changelog-drafter.md)+- [stories/changelog-drafter-week-one.md](../../stories/changelog-drafter-week-one.md)diff --git a/examples/opencode/dependency-sweeper.md b/examples/opencode/dependency-sweeper.mdnew file mode 100644index 0000000..39ae118--- /dev/null+++ b/examples/opencode/dependency-sweeper.md@@ -0,0 +1,68 @@+# Dependency Sweeper — Opencode++Discover, safely apply, and verify dependency updates. opencode handles this well because `npm audit` and `cargo audit` are CLI-first tools the agent can invoke inside isolated worktrees.++## Prerequisites++```bash+mkdir -p skills/dependency-triage skills/loop-verifier skills/minimal-fix+cp templates/SKILL.md.loop-triage skills/dependency-triage/SKILL.md # adapt for dep scan+cp templates/SKILL.md.verifier skills/loop-verifier/SKILL.md+cp templates/SKILL.md.minimal-fix skills/minimal-fix/SKILL.md+cp starters/minimal-loop-opencode/opencode.json.example opencode.json+cp starters/dependency-sweeper-opencode/dependency-sweeper-state.md.example dependency-sweeper-state.md+```++## L1 — Report Mode (Week 1)++```bash+opencode run \+ "Run skills/dependency-triage/SKILL.md. Read dependency-sweeper-state.md. Scan package manifests and lockfiles for outdated and vulnerable deps. Report findings only — do not edit any files. Update state with the top-priority items." \+ --title "Dependency sweeper"+```++Cron (6h cadence):++```cron+0 */6 * * * cd /repo && opencode run "Run dependency-triage on package manifests. Report outdated deps and CVEs. Update state. No fixes."+```++## L2 — Patch-Only Auto-Fix (Week 3+)++After tuning the triage skill, enable patch-only auto-fixes with a verifier gate:++```bash+FIX_ID="$(date +%Y%m%d%H%M%S)"+WORKTREE="../wt-depfix-$FIX_ID"+git worktree add "$WORKTREE" -b "loop/depfix-$FIX_ID"+opencode run \+ "Run dependency-triage. For the highest-severity patch-only upgrade (not a major bump): apply the fix in this worktree, run npm ci && npm test, commit the change, and output the diff path. Never touch denylisted packages. Escalate majors and high-sev CVEs to a human." \+ --agent implementer \+ --dir "$WORKTREE"+DIFF_FILE="$(mktemp /tmp/depfix.XXXXXX.patch)"+git -C "$WORKTREE" diff > "$DIFF_FILE"+opencode run "Review this dependency patch diff. Verify tests pass and no denylisted packages are touched. APPROVE or REJECT only." \+ --agent verifier \+ --file "$DIFF_FILE"+```++## Verification Split++| Role | Opencode shape |+|------|----------------|+| Triage | `skills/dependency-triage/SKILL.md` |+| Implementer | `opencode run "..." --agent implementer --dir <worktree>` (patch-only) |+| Verifier | `opencode run "Verify diff" --agent verifier --file <diff.patch>` (must run full test suite) |++## Safety++- **Patch-only by default.** Majors and breaking changes always escalate to a human.+- Maintain a denylist in `dependency-sweeper-state.md` of packages the loop must never touch.+- Max 3 fix attempts per run; pause after 5 auto-PRs per day.+- Verifier must run `npm ci && npm test` (or equivalent) before approving.++## References++- [patterns/dependency-sweeper.md](../../patterns/dependency-sweeper.md)+- [docs/safety.md](../../docs/safety.md)+- [stories/dependency-sweeper-week-one.md](../../stories/dependency-sweeper-week-one.md)diff --git a/examples/opencode/issue-triage.md b/examples/opencode/issue-triage.mdnew file mode 100644index 0000000..ec0caa5--- /dev/null+++ b/examples/opencode/issue-triage.md@@ -0,0 +1,100 @@+# Issue Triage — Opencode++Keep the issue queue legible so morning triage and humans always know the top five. Low-risk companion to [Daily Triage](./daily-triage.md). Opencode lets you run this on a faster cadence (2h–1d) headless via cron.++## Prerequisites++```bash+mkdir -p skills/issue-triage+cp templates/SKILL.md.issue-triage skills/issue-triage/SKILL.md+cp starters/minimal-loop-opencode/opencode.json.example opencode.json+cp starters/issue-triage-opencode/issue-triage-state.md.example issue-triage-state.md+```++Optionally enable GitHub MCP read-only for richer issue discovery:++```json+{+ "mcpServers": {+ "github": {+ "type": "stdio",+ "command": "npx",+ "args": ["-y", "@modelcontextprotocol/server-github"]+ }+ }+}+```++## L1 — Propose Only (Week 1)++```bash+opencode run \+ "Run skills/issue-triage/SKILL.md. Read issue-triage-state.md first. Scan open issues and discussions since last run. Update state with:+- Top 5 prioritized items (P0-P3) with one-sentence summaries+- Suggested labels (proposed only — do not apply)+- Needs human bucket for ambiguous or security-sensitive items+Do not auto-label, close, or comment on issues. Escalate duplicates as 'possible duplicate of #NNN' for human confirmation." \+ --title "Issue triage"+```++Cron (faster cadence for busy repos):++```cron+0 */2 * * * cd /repo && opencode run "Run issue-triage. Report top 5 open issues. Propose labels. Do not edit issues."+```++## L2 — Auto-Label Allowlisted Labels (Week 3+)++After 10 stable L1 runs, enable auto-apply for safe label categories:++```bash+opencode run \+ "Run issue-triage. For allowlisted labels (area:*, needs-repro, needs-info, duplicate?) apply them after verifier passes. Never auto-apply P0, P1, security, or breaking-change labels. Never close or comment without human approval." \+ --agent implementer+```++## State Shape++```markdown+# Issue Triage State+Last run: 2026-06-20 09:00 UTC+Open actionable: 14 (was 17)+New since last run: 3+Needs human: 2++## Top 5 (by loop score)+- #487 (bug, p1, 2d old) — "Crash on export with large files" — suggested: bug, needs-repro, area:export+- #491 (feature, p2) — "Dark mode for settings" — suggested: enhancement, area:ui++## Proposed Labels (not applied — L1)+- #487: bug, needs-repro, area:export+- #491: enhancement, area:ui+```++## Verification Split++| Role | Opencode shape |+|------|----------------|+| Triage | `skills/issue-triage/SKILL.md` |+| Verifier (L2) | `opencode run "Verify labels are allowlisted" --agent verifier --file <issue-list>` |++## Pairing with Daily Triage++Issue Triage runs more frequently (2h–1d) and produces a clean queue. Daily Triage (1d) reads `issue-triage-state.md` and merges the top items into `STATE.md` High Priority.++```bash+opencode run "Run loop-triage. Read STATE.md and issue-triage-state.md. Merge top issue-triage items into High Priority. Report only."+```++## Safety++- L1: propose only — never auto-label, auto-close, or auto-comment.+- P0/P1 on auth, payments, security, or public API: always escalate to a human.+- L2 auto-labels limited to a curated allowlist; verifier gate required.++## References++- [patterns/issue-triage.md](../../patterns/issue-triage.md)+- [docs/primitives-matrix.md](../../docs/primitives-matrix.md)+- [examples/github-actions/issue-triage.yml](../github-actions/issue-triage.yml)+- [stories/daily-triage-report-only.md](../../stories/daily-triage-report-only.md)diff --git a/examples/opencode/post-merge-cleanup.md b/examples/opencode/post-merge-cleanup.mdnew file mode 100644index 0000000..551cc45--- /dev/null+++ b/examples/opencode/post-merge-cleanup.md@@ -0,0 +1,68 @@+# Post-Merge Cleanup — Opencode++Follow-up tech debt after merges land on main. Low-risk L1 loop — ideal companion after Daily Triage stabilises.++## Prerequisites++```bash+mkdir -p skills/post-merge-scan+cp templates/SKILL.md.loop-triage skills/post-merge-scan/SKILL.md # adapt to scan merges+cp starters/minimal-loop-opencode/opencode.json.example opencode.json+cp starters/post-merge-cleanup-opencode/post-merge-state.md.example post-merge-state.md+```++## Report-Only (Week 1)++Run off-peak (evening or overnight) to avoid colliding with active work:++```bash+opencode run \+ "Run skills/post-merge-scan/SKILL.md. Read post-merge-state.md first. Scan merges to main in the last 48h. Propose small doc/lint/comment fixes only — ticket anything architectural or multi-file. Update post-merge-state.md. Do not edit source code." \+ --title "Post-merge cleanup"+```++Cadence (cron — run once daily after hours):++```cron+0 2 * * * cd /repo && opencode run "Run post-merge-scan on recent merges. Propose only small fixes. Ticket architecture debt. Update state."+```++## With Small Auto-Fixes (Week 2+)++After 7 report-only runs, enable minimal auto-fixes in a worktree:++```bash+FIX_ID="$(date +%Y%m%d%H%M%S)"+WORKTREE="../wt-cleanup-$FIX_ID"+git worktree add "$WORKTREE" -b "loop/cleanup-$FIX_ID"+opencode run \+ "Run post-merge-scan. For the highest-priority single-file cleanup from the last 48h of merges: implement the fix in this worktree, run tests, and write a diff summary. Escalate to a human for anything on denylist paths." \+ --agent implementer \+ --dir "$WORKTREE"+DIFF_FILE="$(mktemp /tmp/cleanup.XXXXXX.patch)"+git -C "$WORKTREE" diff > "$DIFF_FILE"+opencode run "Review this cleanup diff against project rules and tests. APPROVE or REJECT only." \+ --agent verifier \+ --file "$DIFF_FILE"+```++## Verification Split++| Role | Opencode shape |+|------|----------------|+| Scan | `skills/post-merge-scan/SKILL.md` named in the `opencode run` message |+| Implementer | `opencode run "..." --agent implementer --dir <worktree>` |+| Verifier | `opencode run "Verify diff" --agent verifier --file <diff.patch>` |++## Safety++- Run off-peak (evening) to avoid collision with active branches.+- Never auto-fix architectural debt — file a ticket and move on.+- Denylist paths (`docs/safety.md`) always go to a human.+- Max 2 fix attempts per run; escalate after that.++## References++- [patterns/post-merge-cleanup.md](../../patterns/post-merge-cleanup.md)+- [docs/safety.md](../../docs/safety.md)+- [stories/post-merge-cleanup-honest-win.md](../../stories/post-merge-cleanup-honest-win.md)diff --git a/patterns/README.md b/patterns/README.mdindex a12ac01..8882bda 100644--- a/patterns/README.md+++ b/patterns/README.md@@ -8,7 +8,7 @@ Each pattern answers:- Required skills / state shape- Verification approach- Human hand-off strategy-- Tool-specific notes (Grok, Claude Code, Codex, GitHub Actions)+- Tool-specific notes (Grok, Claude Code, Codex, OpenClaw, Opencode, GitHub Actions)## Pattern Registry@@ -27,7 +27,7 @@ Machine-readable index: [registry.yaml](./registry.yaml)## How to Use a Pattern1. Pick a pattern: [pattern-picker.md](../docs/pattern-picker.md)-2. Scaffold with `npx @cobusgreyling/loop-init . --pattern <name> --tool grok` or copy from `starters/`+2. Scaffold with `npx @cobusgreyling/loop-init . --pattern <name> --tool grok` (or `--tool opencode` / `--tool claude`) or copy from `starters/`3. Copy skills from `templates/` if customizing beyond the starter4. Set up scheduling (`/loop`, `scheduler_create`, GitHub Action, Codex Automation)5. Run week one in **L1 report-only** mode before enabling fixesdiff --git a/patterns/registry.schema.json b/patterns/registry.schema.jsonindex 0e215dc..c30ea9c 100644--- a/patterns/registry.schema.json+++ b/patterns/registry.schema.json@@ -49,7 +49,7 @@"minItems": 1,"items": {"type": "string",- "enum": ["grok", "claude-code", "codex", "github-actions", "cursor", "windsurf", "aider"]+ "enum": ["grok", "claude-code", "codex", "openclaw", "opencode", "github-actions", "cursor", "windsurf", "aider"]}},"skills": {diff --git a/patterns/registry.yaml b/patterns/registry.yamlindex 89f7aa4..edb05c3 100644--- a/patterns/registry.yaml+++ b/patterns/registry.yaml@@ -8,7 +8,7 @@ patterns:goal: Shepherd PRs through review, CI, rebase, and mergecadence: 5m-15mrisk: medium- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [pr-review-triage, minimal-fix, rebase-and-clean]state: pr-babysitter-state.mdphases: [discover, triage, fix, verify, notify]@@ -29,7 +29,7 @@ patterns:goal: Prioritized morning scan of CI, issues, commits, and chatcadence: 1d-2hrisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [loop-triage, minimal-fix]state: STATE.mdphases: [report, act-small-wins, escalate]@@ -50,7 +50,7 @@ patterns:goal: React to failing CI with minimal fixes and escalationcadence: 5m-15mrisk: medium- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [ci-triage, minimal-fix]state: ci-sweeper-state.mdphases: [detect, classify, fix, verify, escalate]@@ -71,7 +71,7 @@ patterns:goal: Follow-up tech debt and cleanup after merges to maincadence: 1d-6hrisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [post-merge-scan, minimal-fix]state: post-merge-state.mdphases: [scan-merges, prioritize, fix-small, ticket-large]@@ -92,7 +92,7 @@ patterns:goal: Discover, safely apply, and verify dependency + vulnerability updates with human gates on risky changescadence: 6h-1drisk: medium- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [dependency-triage, minimal-fix, loop-verifier]state: dependency-sweeper-state.mdphases: [scan, triage-risk, patch-safe, verify-worktree, escalate-risky]@@ -113,7 +113,7 @@ patterns:goal: Scan merged PRs and commits, draft categorized high-quality release notes or CHANGELOG entries for human reviewcadence: 1drisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [changelog-scan, draft-release-notes, loop-verifier]state: changelog-drafter-state.mdphases: [scan-merges, categorize, draft, review, publish]@@ -134,7 +134,7 @@ patterns:goal: Discover, deduplicate, prioritize and label incoming issues/discussions so the team always has a clean actionable queue. Excellent low-risk companion to Daily Triage.cadence: 2h-1drisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [issue-triage, loop-verifier]state: issue-triage-state.mdphases: [discover, dedupe, score, propose-labels, human-review]diff --git a/scripts/validate-registry.mjs b/scripts/validate-registry.mjsindex 0bac3a6..7ef7fec 100644--- a/scripts/validate-registry.mjs+++ b/scripts/validate-registry.mjs@@ -14,7 +14,7 @@ const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');const CADENCE_RE = /^[0-9]+[mhd](-[0-9]+[mhd])?$/;const ID_RE = /^[a-z][a-z0-9-]*$/;const FILE_RE = /^[A-Za-z0-9-]+\.md$/;-const VALID_TOOLS = new Set(['grok', 'claude-code', 'codex', 'github-actions', 'cursor', 'windsurf', 'aider']);+const VALID_TOOLS = new Set(['grok', 'claude-code', 'codex', 'openclaw', 'opencode', 'github-actions', 'cursor', 'windsurf', 'aider']);const VALID_RISK = new Set(['low', 'medium', 'high']);const VALID_MODES = new Set(['L1', 'L2', 'L3']);const VALID_COST = new Set(['low', 'medium', 'high', 'very-high']);diff --git a/starters/README.md b/starters/README.mdindex a51897c..bf6cc54 100644--- a/starters/README.md+++ b/starters/README.md@@ -21,11 +21,17 @@ npx @cobusgreyling/loop-init . -p pr-babysitter -t claude| Starter | Pattern | Tools | Readiness ||---------|---------|-------|-----------|| [pr-babysitter](./pr-babysitter/) | PR Babysitter | Grok, Claude, Codex | L2 assisted |+| [pr-babysitter-opencode](./pr-babysitter-opencode/) | PR Babysitter | Opencode | L1 → L2 || [ci-sweeper](./ci-sweeper/) | CI Sweeper | Grok, Claude, Codex | L2 assisted |+| [ci-sweeper-opencode](./ci-sweeper-opencode/) | CI Sweeper | Opencode | L2 cautious || [dependency-sweeper](./dependency-sweeper/) | Dependency Sweeper | Grok, Claude, Codex | L2 patch-only |+| [dependency-sweeper-opencode](./dependency-sweeper-opencode/) | Dependency Sweeper | Opencode | L2 patch-only || [post-merge-cleanup](./post-merge-cleanup/) | Post-Merge Cleanup | Grok, Claude, Codex | L1 → L2 |+| [post-merge-cleanup-opencode](./post-merge-cleanup-opencode/) | Post-Merge Cleanup | Opencode | L1 → L2 || [changelog-drafter](./changelog-drafter/) | Changelog Drafter | Grok, Claude, Codex | L1 draft → L2 |+| [changelog-drafter-opencode](./changelog-drafter-opencode/) | Changelog Drafter | Opencode | L1 draft → L2 || [issue-triage](./issue-triage/) | Issue Triage | Grok, Claude, Codex | L1 propose-only |+| [issue-triage-opencode](./issue-triage-opencode/) | Issue Triage | Opencode | L1 propose-only |After copying:diff --git a/starters/changelog-drafter-opencode/AGENTS.md b/starters/changelog-drafter-opencode/AGENTS.mdnew file mode 100644index 0000000..eca5475--- /dev/null+++ b/starters/changelog-drafter-opencode/AGENTS.md@@ -0,0 +1,15 @@+# AGENTS.md — Changelog Drafter (Opencode)++## Loop Mode+- L1 report + draft for the first 1-2 weeks.+- Read `changelog-drafter-state.md` before every run.+- Human approves every draft before any publish or PR.++## Safety+- Never create tags, GitHub releases, or update CHANGELOG.md without explicit human approval.+- Breaking changes and security items must be surfaced explicitly.+- Draft PRs only when L2 is enabled — never auto-merge.++## Verification+- Verifier checks draft completeness: categories, date range, links.+- Record draft status and human feedback in state.diff --git a/starters/changelog-drafter-opencode/LOOP.md b/starters/changelog-drafter-opencode/LOOP.mdnew file mode 100644index 0000000..12443c6--- /dev/null+++ b/starters/changelog-drafter-opencode/LOOP.md@@ -0,0 +1,26 @@+# Loop Configuration — Changelog Drafter (Opencode)++## Active Loops++| Pattern | Cadence | Status | Command |+|---------|---------|--------|---------|+| Changelog Drafter | 1d or on release prep | L1 draft-only | `opencode run "Run changelog-scan"` via cron (after merges settle) |++## Human Gates+- Breaking changes always human review.+- Security notes / CVEs human must approve wording.+- No tags, no PRs, no publishes without explicit approval.+- First 3 releases: human approves full draft.++## Budget+- Max sub-agent spawns per run: 2 (scanner + drafter).+- Prefer running after merges settle (evening).++## Output Convention+- Draft: `RELEASE_NOTES_DRAFT.md` at repo root.+- State: `changelog-drafter-state.md`.++## Links+- Pattern: [changelog-drafter](../../patterns/changelog-drafter.md)+- Example: [examples/opencode/changelog-drafter.md](../../examples/opencode/changelog-drafter.md)+- Safety: [docs/safety.md](../../docs/safety.md)diff --git a/starters/changelog-drafter-opencode/README.md b/starters/changelog-drafter-opencode/README.mdnew file mode 100644index 0000000..27315d0--- /dev/null+++ b/starters/changelog-drafter-opencode/README.md@@ -0,0 +1,44 @@+# Changelog Drafter — Opencode Starter++Clone-and-run scaffold for the **Changelog Drafter** pattern with opencode. Scan merged PRs and commits, produce categorized release notes.++## Quick Start++```bash+npx @cobusgreyling/loop-init . --pattern changelog-drafter --tool opencode+```++Or copy manually:++```bash+cp -r starters/changelog-drafter-opencode/skills .+cp starters/changelog-drafter-opencode/AGENTS.md .+cp starters/changelog-drafter-opencode/LOOP.md .+cp starters/changelog-drafter-opencode/changelog-drafter-state.md.example changelog-drafter-state.md+cp starters/changelog-drafter-opencode/opencode.json.example opencode.json+```++Start (L1 report + draft, week 1):++```bash+opencode run \+ "Run skills/changelog-scan/SKILL.md. Scan merges since last tag (or last 7 days). Produce categorized draft in RELEASE_NOTES_DRAFT.md. Update state. Do not publish or create PRs." \+ --title "Changelog drafter"+```++## What's Included++| File | Purpose |+|------|---------|+| `changelog-drafter-state.md.example` | State spine (last release, draft status) |+| `skills/changelog-scan/SKILL.md` | Merge scan and categorization skill |+| `AGENTS.md` | Always-on safety rules |+| `LOOP.md` | Cadence, gates, budget |+| `opencode.json.example` | Named agent definitions |++## Next Steps++- [patterns/changelog-drafter.md](../../patterns/changelog-drafter.md)+- [examples/opencode/changelog-drafter.md](../../examples/opencode/changelog-drafter.md)+- [docs/loop-design-checklist.md](../../docs/loop-design-checklist.md)+- [stories/changelog-drafter-week-one.md](../../stories/changelog-drafter-week-one.md)diff --git a/starters/changelog-drafter-opencode/changelog-drafter-state.md.example b/starters/changelog-drafter-opencode/changelog-drafter-state.md.examplenew file mode 100644index 0000000..cee738a--- /dev/null+++ b/starters/changelog-drafter-opencode/changelog-drafter-state.md.example@@ -0,0 +1,10 @@+# Changelog Drafter State+Last run: 2026-06-20 09:00 UTC+Last tag scanned: v0.0.0+Draft status: none+Human feedback: pending++## Scan Window+- From: <!-- last tag or date -->+- To: <!-- current -->+- Merges found: 0diff --git a/starters/changelog-drafter-opencode/opencode.json.example b/starters/changelog-drafter-opencode/opencode.json.examplenew file mode 100644index 0000000..d2de72b--- /dev/null+++ b/starters/changelog-drafter-opencode/opencode.json.example@@ -0,0 +1,35 @@+{+ "$schema": "https://opencode.ai/config.json",+ "agent": {+ "changelog-scan": {+ "name": "changelog-scan",+ "description": "Changelog drafting loop. Reads changelog-drafter-state.md, scans merges, and produces categorized release notes.",+ "mode": "primary",+ "prompt": "Read AGENTS.md, LOOP.md, changelog-drafter-state.md, and skills/changelog-scan/SKILL.md. Scan merges since last tag. Produce categorized draft in RELEASE_NOTES_DRAFT.md. Never publish or tag without human approval.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "implementer": {+ "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.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "verifier": {+ "name": "verifier",+ "description": "Checker agent for draft release notes. APPROVE or REJECT only.",+ "mode": "subagent",+ "prompt": "Review the draft notes for completeness, categorization, and correct date range. Flag missing sections. Do not edit. APPROVE or REJECT.",+ "permission": {+ "bash": "ask",+ "edit": "deny"+ }+ }+ }+}diff --git a/starters/changelog-drafter-opencode/skills/changelog-scan/SKILL.md b/starters/changelog-drafter-opencode/skills/changelog-scan/SKILL.mdnew file mode 100644index 0000000..7474048--- /dev/null+++ b/starters/changelog-drafter-opencode/skills/changelog-scan/SKILL.md@@ -0,0 +1,38 @@+---+name: changelog-scan+description: >+ Scan merged PRs and commits since a given reference, extract+ titles, labels, types, and signals. Produces structured input+ for release notes drafting.+user_invocable: true+---++# Changelog Scan Skill++You are a changelog drafting agent. Scan merges and produce release notes.++## Scan Sources++- `git log --merges --oneline <last-tag>..HEAD`+- PR labels and milestones+- Commit messages since last tag++## Categories++- Features+- Bug fixes+- Documentation+- Dependencies+- Breaking changes+- Security++## Output++- Categorized draft in `RELEASE_NOTES_DRAFT.md`+- Update `changelog-drafter-state.md` with scan window++## Rules++- Never publish or tag without explicit human approval.+- Surface breaking changes and security items explicitly.+- L1: draft only — no PRs, no tags.diff --git a/starters/ci-sweeper-opencode/AGENTS.md b/starters/ci-sweeper-opencode/AGENTS.mdnew file mode 100644index 0000000..8f7872f--- /dev/null+++ b/starters/ci-sweeper-opencode/AGENTS.md@@ -0,0 +1,17 @@+# AGENTS.md — CI Sweeper (Opencode)++## Loop Mode+- CI sweeper is L2 from week one (action-oriented — CIs are urgent).+- Read `ci-sweeper-state.md` before every run.+- Classify failures before attempting any fix.++## Safety+- Always dispatch into a git worktree per attempt.+- Infra / security / payments test failures: do not auto-fix; flag and stop.+- Max 3 fix attempts per item; escalate after.+- Enforce budget cap from `LOOP.md`.++## Verification+- Verifier must run tests after implementer.+- Record attempt count in `ci-sweeper-state.md`.+- No auto-merge without verifier approval.diff --git a/starters/ci-sweeper-opencode/LOOP.md b/starters/ci-sweeper-opencode/LOOP.mdnew file mode 100644index 0000000..9b84fba--- /dev/null+++ b/starters/ci-sweeper-opencode/LOOP.md@@ -0,0 +1,26 @@+# Loop Configuration — CI Sweeper (Opencode)++## Active Loops++| Pattern | Cadence | Status | Command |+|---------|---------|--------|---------|+| CI Sweeper | 5-15m | L2 cautious | `opencode run "Run ci-triage" --agent loop-triage` via cron/systemd |++## Human Gates+- Infra / security / payments test failures: do not auto-fix.+- Max 3 fix attempts per item; escalate after.+- No auto-merge without verifier pass.++## Worktrees+- Always dispatch into a git worktree per attempt.+- One worktree per fix; discard after REJECT.++## Budget+- Max sub-agent spawns per run: 3.+- Max auto-PRs per day: 5.+- Early exit if no failures found.++## Links+- Pattern: [ci-sweeper](../../patterns/ci-sweeper.md)+- Example: [examples/opencode/ci-sweeper.md](../../examples/opencode/ci-sweeper.md)+- Safety: [docs/safety.md](../../docs/safety.md)diff --git a/starters/ci-sweeper-opencode/README.md b/starters/ci-sweeper-opencode/README.mdnew file mode 100644index 0000000..9fa8829--- /dev/null+++ b/starters/ci-sweeper-opencode/README.md@@ -0,0 +1,43 @@+# CI Sweeper — Opencode Starter++Clone-and-run scaffold for the **CI Sweeper** pattern with opencode. React to failing CI with minimal fixes at short cadences.++## Quick Start++```bash+npx @cobusgreyling/loop-init . --pattern ci-sweeper --tool opencode+```++Or copy manually:++```bash+cp -r starters/ci-sweeper-opencode/skills .+cp starters/ci-sweeper-opencode/AGENTS.md .+cp starters/ci-sweeper-opencode/LOOP.md .+cp starters/ci-sweeper-opencode/ci-sweeper-state.md.example ci-sweeper-state.md+cp starters/ci-sweeper-opencode/opencode.json.example opencode.json+```++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." \+ --title "CI sweeper"+```++## What's Included++| File | Purpose |+|------|---------|+| `ci-sweeper-state.md.example` | State spine (in-flight CI failures) |+| `skills/ci-triage/SKILL.md` | CI-focused triage skill |+| `AGENTS.md` | Always-on safety rules |+| `LOOP.md` | Cadence, gates, budget |+| `opencode.json.example` | Named agent definitions |++## Next Steps++- [patterns/ci-sweeper.md](../../patterns/ci-sweeper.md)+- [examples/opencode/ci-sweeper.md](../../examples/opencode/ci-sweeper.md)+- [docs/loop-design-checklist.md](../../docs/loop-design-checklist.md)diff --git a/starters/ci-sweeper-opencode/ci-sweeper-state.md.example b/starters/ci-sweeper-opencode/ci-sweeper-state.md.examplenew file mode 100644index 0000000..d6fae10--- /dev/null+++ b/starters/ci-sweeper-opencode/ci-sweeper-state.md.example@@ -0,0 +1,10 @@+# CI Sweeper State+Last run: 2026-06-20 09:00 UTC+Active failures: 0+Attempt counts: {}++## Failures+- <!-- Add failing checks here -->++## Escalated+- <!-- Infra/security failures escalated to human -->diff --git a/starters/ci-sweeper-opencode/opencode.json.example b/starters/ci-sweeper-opencode/opencode.json.examplenew file mode 100644index 0000000..4ae3ea2--- /dev/null+++ b/starters/ci-sweeper-opencode/opencode.json.example@@ -0,0 +1,35 @@+{+ "$schema": "https://opencode.ai/config.json",+ "agent": {+ "ci-triage": {+ "name": "ci-triage",+ "description": "CI-focused triage and fix loop. Reads ci-sweeper-state.md, classifies CI failures, and applies minimal fixes in worktrees with verifier.",+ "mode": "primary",+ "prompt": "Read AGENTS.md, LOOP.md, ci-sweeper-state.md, and skills/ci-triage/SKILL.md. Classify each failing check. For clear regressions: worktree + implementer + verifier. Escalate infra and security failures.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "implementer": {+ "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.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "verifier": {+ "name": "verifier",+ "description": "Checker agent for CI fix diffs. APPROVE or REJECT only.",+ "mode": "subagent",+ "prompt": "Review the supplied CI-fix diff. Verify tests pass. Do not edit files. APPROVE or REJECT with evidence.",+ "permission": {+ "bash": "ask",+ "edit": "deny"+ }+ }+ }+}diff --git a/starters/ci-sweeper-opencode/skills/ci-triage/SKILL.md b/starters/ci-sweeper-opencode/skills/ci-triage/SKILL.mdnew file mode 100644index 0000000..b6679fd--- /dev/null+++ b/starters/ci-sweeper-opencode/skills/ci-triage/SKILL.md@@ -0,0 +1,32 @@+---+name: ci-triage+description: >+ Classify CI failures — distinguish clear regressions from infra flakes+ and security-test failures. Produces structured failure reports.+user_invocable: true+---++# CI Triage Skill++You are a CI triage agent. Classify each failing check and decide the next action.++## Classification++- **Clear regression**: single-file, obvious root cause (candidate for auto-fix)+- **Infra flake**: network timeout, runner issue, dependency unavailable+- **Security test failure**: never auto-fix; escalate to human+- **Non-deterministic**: retry once before classifying++## Output++Update `ci-sweeper-state.md` with:++- List of failures by category+- Suggested next action per item+- Attempt count per item++## Rules++- Infra and security failures always escalate.+- Max 3 fix attempts per item.+- Worktree isolation required for any code change.diff --git a/starters/dependency-sweeper-opencode/AGENTS.md b/starters/dependency-sweeper-opencode/AGENTS.mdnew file mode 100644index 0000000..2b10553--- /dev/null+++ b/starters/dependency-sweeper-opencode/AGENTS.md@@ -0,0 +1,15 @@+# AGENTS.md — Dependency Sweeper (Opencode)++## Loop Mode+- L2 assisted from week one (patch-only with strong verifier gates).+- Read `dependency-sweeper-state.md` before every run.++## Safety+- Patch-only by default. Majors and breaking changes escalate to human.+- Maintain denylist in state file — never touch those packages.+- One worktree per update attempt.+- Max 3 fix attempts per run; max 5 auto-PRs per day.++## Verification+- Verifier must run `npm ci && npm test` (or equivalent).+- Record attempt count and test evidence in state.diff --git a/starters/dependency-sweeper-opencode/LOOP.md b/starters/dependency-sweeper-opencode/LOOP.mdnew file mode 100644index 0000000..7236f28--- /dev/null+++ b/starters/dependency-sweeper-opencode/LOOP.md@@ -0,0 +1,27 @@+# Loop Configuration — Dependency Sweeper (Opencode)++## Active Loops++| Pattern | Cadence | Status | Command |+|---------|---------|--------|---------|+| Dependency Sweeper | 6h | L2 patch-only | `opencode run "Run dependency-triage" --agent loop-triage` via cron |++## Human Gates+- Major version bumps always human.+- High-severity CVE requiring breaking change: human.+- Denylist packages (edit in state) never auto-touched.+- No auto-merge without verifier pass.++## Worktrees+- One worktree per package update attempt.+- Discard on REJECT or human escalation.++## Budget+- Max sub-agent spawns per run: 3.+- Max auto-PRs per day: 5.+- Pause if token budget exceeded.++## Links+- Pattern: [dependency-sweeper](../../patterns/dependency-sweeper.md)+- Example: [examples/opencode/dependency-sweeper.md](../../examples/opencode/dependency-sweeper.md)+- Safety: [docs/safety.md](../../docs/safety.md)diff --git a/starters/dependency-sweeper-opencode/README.md b/starters/dependency-sweeper-opencode/README.mdnew file mode 100644index 0000000..7335df3--- /dev/null+++ b/starters/dependency-sweeper-opencode/README.md@@ -0,0 +1,44 @@+# Dependency Sweeper — Opencode Starter++Clone-and-run scaffold for the **Dependency Sweeper** pattern with opencode. Discover, safely apply, and verify dependency updates.++## Quick Start++```bash+npx @cobusgreyling/loop-init . --pattern dependency-sweeper --tool opencode+```++Or copy manually:++```bash+cp -r starters/dependency-sweeper-opencode/skills .+cp starters/dependency-sweeper-opencode/AGENTS.md .+cp starters/dependency-sweeper-opencode/LOOP.md .+cp starters/dependency-sweeper-opencode/dependency-sweeper-state.md.example dependency-sweeper-state.md+cp starters/dependency-sweeper-opencode/opencode.json.example opencode.json+```++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." \+ --title "Dependency sweeper"+```++## What's Included++| File | Purpose |+|------|---------|+| `dependency-sweeper-state.md.example` | State spine (in-flight updates, denylist) |+| `skills/dependency-triage/SKILL.md` | Dependency-focused triage skill |+| `AGENTS.md` | Always-on safety rules |+| `LOOP.md` | Cadence, gates, budget |+| `opencode.json.example` | Named agent definitions |++## Next Steps++- [patterns/dependency-sweeper.md](../../patterns/dependency-sweeper.md)+- [examples/opencode/dependency-sweeper.md](../../examples/opencode/dependency-sweeper.md)+- [docs/loop-design-checklist.md](../../docs/loop-design-checklist.md)+- [stories/dependency-sweeper-week-one.md](../../stories/dependency-sweeper-week-one.md)diff --git a/starters/dependency-sweeper-opencode/dependency-sweeper-state.md.example b/starters/dependency-sweeper-opencode/dependency-sweeper-state.md.examplenew file mode 100644index 0000000..768e069--- /dev/null+++ b/starters/dependency-sweeper-opencode/dependency-sweeper-state.md.example@@ -0,0 +1,11 @@+# Dependency Sweeper State+Last run: 2026-06-20 09:00 UTC+Outdated packages: 0+Attempt counts: {}+Auto-PRs today: 0++## Denylist (never touch)+- <!-- Add packages the loop must never update -->++## Escalated to Human+- <!-- Major bumps and high-sev CVEs -->diff --git a/starters/dependency-sweeper-opencode/opencode.json.example b/starters/dependency-sweeper-opencode/opencode.json.examplenew file mode 100644index 0000000..8579fd5--- /dev/null+++ b/starters/dependency-sweeper-opencode/opencode.json.example@@ -0,0 +1,35 @@+{+ "$schema": "https://opencode.ai/config.json",+ "agent": {+ "dependency-triage": {+ "name": "dependency-triage",+ "description": "Dependency-focused triage loop. Reads dependency-sweeper-state.md, scans manifests, and applies patch-only upgrades with verifier.",+ "mode": "primary",+ "prompt": "Read AGENTS.md, LOOP.md, dependency-sweeper-state.md, and skills/dependency-triage/SKILL.md. Scan manifests for outdated and vulnerable deps. Patch-only auto-fix in worktree. Escalate majors and denylisted packages.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "implementer": {+ "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.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "verifier": {+ "name": "verifier",+ "description": "Checker agent for dependency upgrade diffs. APPROVE or REJECT only.",+ "mode": "subagent",+ "prompt": "Verify the dependency patch passes tests and touches no denylisted packages. Do not edit files. APPROVE or REJECT with evidence.",+ "permission": {+ "bash": "ask",+ "edit": "deny"+ }+ }+ }+}diff --git a/starters/dependency-sweeper-opencode/skills/dependency-triage/SKILL.md b/starters/dependency-sweeper-opencode/skills/dependency-triage/SKILL.mdnew file mode 100644index 0000000..e493bb5--- /dev/null+++ b/starters/dependency-sweeper-opencode/skills/dependency-triage/SKILL.md@@ -0,0 +1,35 @@+---+name: dependency-triage+description: >+ Scan package manifests and lockfiles for outdated and vulnerable+ dependencies. Classify by severity and update type.+user_invocable: true+---++# Dependency Triage Skill++You are a dependency sweeper agent. Scan for outdated and vulnerable packages.++## Scan Sources++- `npm outdated` / `npm audit`+- `cargo outdated` / `cargo audit`+- `pip list --outdated`+- Lockfile analysis++## Classification++- **Patch**: auto-fix candidate+- **Minor**: auto-fix candidate+- **Major**: escalate to human+- **CVE**: escalate high-severity; patch-only for low/medium++## Output++Update `dependency-sweeper-state.md` with prioritized update list.++## Rules++- Patch-only by default in week one.+- Honour denylist in state file.+- Run `npm ci && npm test` (or equivalent) before approving.diff --git a/starters/issue-triage-opencode/AGENTS.md b/starters/issue-triage-opencode/AGENTS.mdnew file mode 100644index 0000000..2a44a7b--- /dev/null+++ b/starters/issue-triage-opencode/AGENTS.md@@ -0,0 +1,16 @@+# AGENTS.md — Issue Triage (Opencode)++## Loop Mode+- Start in L1 propose-only mode.+- Read `issue-triage-state.md` before every run.+- Never auto-label, auto-close, or auto-comment in week one.++## Safety+- P0/P1 on auth, payments, security, or public API: always escalate.+- L2 auto-labels limited to curated allowlist.+- Verifier gate required before applying any label.++## Verification+- L1: human reviews proposed labels before application.+- L2: verifier confirms labels are in the allowlist.+- Duplicates: propose as "possible duplicate of #NNN" — never auto-close.diff --git a/starters/issue-triage-opencode/LOOP.md b/starters/issue-triage-opencode/LOOP.mdnew file mode 100644index 0000000..e6d6f65--- /dev/null+++ b/starters/issue-triage-opencode/LOOP.md@@ -0,0 +1,21 @@+# Loop Configuration — Issue Triage (Opencode)++## Active Loops++| Pattern | Cadence | Status | Command |+|---------|---------|--------|---------|+| Issue Triage | 2h-1d | L1 propose-only | `opencode run "Run issue-triage" --agent loop-triage` via cron |++## Human Gates+- P0/P1 on auth, payments, security, public API: always human.+- Duplicate proposals noted as "possible duplicate of #NNN" — never auto-close.+- L2 auto-labels limited to allowlist.++## Budget+- Max sub-agent spawns per run: 0 (L1), 1 (L2).+- Early exit if no new issues since last run.++## Links+- Pattern: [issue-triage](../../patterns/issue-triage.md)+- Example: [examples/opencode/issue-triage.md](../../examples/opencode/issue-triage.md)+- Safety: [docs/safety.md](../../docs/safety.md)diff --git a/starters/issue-triage-opencode/README.md b/starters/issue-triage-opencode/README.mdnew file mode 100644index 0000000..0eb8528--- /dev/null+++ b/starters/issue-triage-opencode/README.md@@ -0,0 +1,43 @@+# Issue Triage — Opencode Starter++Clone-and-run scaffold for the **Issue Triage** pattern with opencode. Keep the issue queue legible so morning triage always knows the top five.++## Quick Start++```bash+npx @cobusgreyling/loop-init . --pattern issue-triage --tool opencode+```++Or copy manually:++```bash+cp -r starters/issue-triage-opencode/skills .+cp starters/issue-triage-opencode/AGENTS.md .+cp starters/issue-triage-opencode/LOOP.md .+cp starters/issue-triage-opencode/issue-triage-state.md.example issue-triage-state.md+cp starters/issue-triage-opencode/opencode.json.example opencode.json+```++Start (L1 propose-only, week 1):++```bash+opencode run \+ "Run skills/issue-triage/SKILL.md. Scan open issues since last run. Update issue-triage-state.md with top 5, proposed labels, and needs-human bucket. Propose only — do not apply labels or close issues." \+ --title "Issue triage"+```++## What's Included++| File | Purpose |+|------|---------|+| `issue-triage-state.md.example` | State spine (issue queue health) |+| `skills/issue-triage/SKILL.md` | Issue-focused triage skill |+| `AGENTS.md` | Always-on safety rules |+| `LOOP.md` | Cadence, gates, budget |+| `opencode.json.example` | Named agent definitions |++## Next Steps++- [patterns/issue-triage.md](../../patterns/issue-triage.md)+- [examples/opencode/issue-triage.md](../../examples/opencode/issue-triage.md)+- [docs/loop-design-checklist.md](../../docs/loop-design-checklist.md)diff --git a/starters/issue-triage-opencode/issue-triage-state.md.example b/starters/issue-triage-opencode/issue-triage-state.md.examplenew file mode 100644index 0000000..9fe11fd--- /dev/null+++ b/starters/issue-triage-opencode/issue-triage-state.md.example@@ -0,0 +1,11 @@+# Issue Triage State+Last run: 2026-06-20 09:00 UTC+Open actionable: 0+New since last run: 0+Needs human: 0++## Top 5 (by loop score)+- <!-- #NNN (type, priority) — summary — proposed labels -->++## Proposed Labels (not applied — L1)+- <!-- #NNN: label1, label2 -->diff --git a/starters/issue-triage-opencode/opencode.json.example b/starters/issue-triage-opencode/opencode.json.examplenew file mode 100644index 0000000..51cd78d--- /dev/null+++ b/starters/issue-triage-opencode/opencode.json.example@@ -0,0 +1,35 @@+{+ "$schema": "https://opencode.ai/config.json",+ "agent": {+ "issue-triage": {+ "name": "issue-triage",+ "description": "Issue triage loop. Reads issue-triage-state.md, scans open issues, and proposes labels and priorities. Propose-only in L1 mode.",+ "mode": "primary",+ "prompt": "Read AGENTS.md, LOOP.md, issue-triage-state.md, and skills/issue-triage/SKILL.md. Scan open issues since last run. Update state with top 5, proposed labels, and needs-human bucket. Propose only — do not apply labels or close issues.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "implementer": {+ "name": "implementer",+ "description": "L2 implementer for auto-labeling allowlisted labels.",+ "mode": "subagent",+ "prompt": "Apply only allowlisted labels (area:*, needs-repro, needs-info, duplicate?) after verifier passes. Never auto-apply P0, P1, security, or breaking-change labels. Never close or comment without human approval.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "verifier": {+ "name": "verifier",+ "description": "Checker agent for issue label proposals. APPROVE or REJECT only.",+ "mode": "subagent",+ "prompt": "Verify proposed labels are in the allowlist. Confirm no P0/P1/security labels are being auto-applied. Do not edit. APPROVE or REJECT.",+ "permission": {+ "bash": "ask",+ "edit": "deny"+ }+ }+ }+}diff --git a/starters/issue-triage-opencode/skills/issue-triage/SKILL.md b/starters/issue-triage-opencode/skills/issue-triage/SKILL.mdnew file mode 100644index 0000000..7147843--- /dev/null+++ b/starters/issue-triage-opencode/skills/issue-triage/SKILL.md@@ -0,0 +1,33 @@+---+name: issue-triage+description: >+ Scan open issues and discussions, deduplicate, prioritize,+ and propose labels. Provides a clean actionable queue.+user_invocable: true+---++# Issue Triage Skill++You are an issue triage agent. Keep the issue queue legible.++## Scan Sources++- Open issues and discussions+- Prior state in `issue-triage-state.md`+- Labels, milestones, linked PRs++## Output++Update `issue-triage-state.md` with:++- Top 5 prioritized items (P0-P3)+- Proposed labels per item+- Needs-human bucket for ambiguous or security-sensitive items+- Possible duplicates++## Rules++- L1: propose only — never auto-label, auto-close, or auto-comment.+- P0/P1 on auth, payments, security, public API: always escalate.+- Duplicates: note as "possible duplicate of #NNN" — never auto-close.+- L2 auto-labels limited to curated allowlist.diff --git a/starters/post-merge-cleanup-opencode/AGENTS.md b/starters/post-merge-cleanup-opencode/AGENTS.mdnew file mode 100644index 0000000..7682ffe--- /dev/null+++ b/starters/post-merge-cleanup-opencode/AGENTS.md@@ -0,0 +1,15 @@+# AGENTS.md — Post-Merge Cleanup (Opencode)++## Loop Mode+- Start in L1 report-only mode.+- Read `post-merge-state.md` before any scan.+- Run off-peak (evening) to avoid colliding with active branches.++## Safety+- Never auto-fix architectural debt — file a ticket.+- Denylist paths always go to a human.+- Max 2 fix attempts per run.++## Verification+- For L2+ changes, verifier confirms fix scope and tests.+- Record attempt evidence in state.diff --git a/starters/post-merge-cleanup-opencode/LOOP.md b/starters/post-merge-cleanup-opencode/LOOP.mdnew file mode 100644index 0000000..2d67b3d--- /dev/null+++ b/starters/post-merge-cleanup-opencode/LOOP.md@@ -0,0 +1,26 @@+# Loop Configuration — Post-Merge Cleanup (Opencode)++## Active Loops++| Pattern | Cadence | Status | Command |+|---------|---------|--------|---------|+| Post-Merge Cleanup | 1d | L1 report-only | `opencode run "Run post-merge-scan"` via cron (off-peak) |++## Human Gates+- Architectural debt is ticketed, never auto-fixed.+- Denylist paths always human.+- Max 2 fix attempts per run.++## Worktrees+- Use `git worktree` for any code-change attempt (L2+).+- One worktree per fix; discard after REJECT.++## Budget+- Max sub-agent spawns per run: 0 (L1), 2 (L2).+- Run off-peak (evening) to avoid collision.+- Pause if token budget exceeded.++## Links+- Pattern: [post-merge-cleanup](../../patterns/post-merge-cleanup.md)+- Example: [examples/opencode/post-merge-cleanup.md](../../examples/opencode/post-merge-cleanup.md)+- Safety: [docs/safety.md](../../docs/safety.md)diff --git a/starters/post-merge-cleanup-opencode/README.md b/starters/post-merge-cleanup-opencode/README.mdnew file mode 100644index 0000000..a80e3fa--- /dev/null+++ b/starters/post-merge-cleanup-opencode/README.md@@ -0,0 +1,44 @@+# Post-Merge Cleanup — Opencode Starter++Clone-and-run scaffold for the **Post-Merge Cleanup** pattern with opencode. Follow-up tech debt after merges land on main.++## Quick Start++```bash+npx @cobusgreyling/loop-init . --pattern post-merge-cleanup --tool opencode+```++Or copy manually:++```bash+cp -r starters/post-merge-cleanup-opencode/skills .+cp starters/post-merge-cleanup-opencode/AGENTS.md .+cp starters/post-merge-cleanup-opencode/LOOP.md .+cp starters/post-merge-cleanup-opencode/post-merge-state.md.example post-merge-state.md+cp starters/post-merge-cleanup-opencode/opencode.json.example opencode.json+```++Start (report-only, week 1):++```bash+opencode run \+ "Run skills/post-merge-scan/SKILL.md. Scan merges to main in the last 48h. Propose small doc/lint/comment fixes only — ticket anything architectural. Update post-merge-state.md. Do not edit source code." \+ --title "Post-merge cleanup"+```++## What's Included++| File | Purpose |+|------|---------|+| `post-merge-state.md.example` | State spine template |+| `skills/post-merge-scan/SKILL.md` | Merge-focused scan skill |+| `AGENTS.md` | Always-on safety rules |+| `LOOP.md` | Cadence, gates, budget |+| `opencode.json.example` | Named agent definitions |++## Next Steps++- [patterns/post-merge-cleanup.md](../../patterns/post-merge-cleanup.md)+- [examples/opencode/post-merge-cleanup.md](../../examples/opencode/post-merge-cleanup.md)+- [docs/loop-design-checklist.md](../../docs/loop-design-checklist.md)+- [stories/post-merge-cleanup-honest-win.md](../../stories/post-merge-cleanup-honest-win.md)diff --git a/starters/post-merge-cleanup-opencode/opencode.json.example b/starters/post-merge-cleanup-opencode/opencode.json.examplenew file mode 100644index 0000000..22f730d--- /dev/null+++ b/starters/post-merge-cleanup-opencode/opencode.json.example@@ -0,0 +1,35 @@+{+ "$schema": "https://opencode.ai/config.json",+ "agent": {+ "post-merge-scan": {+ "name": "post-merge-scan",+ "description": "Post-merge scan loop. Reads post-merge-state.md, scans recent merges, and proposes small cleanup fixes.",+ "mode": "primary",+ "prompt": "Read AGENTS.md, LOOP.md, post-merge-state.md, and skills/post-merge-scan/SKILL.md. Scan merges to main in the last 48h. Propose small doc/lint/comment fixes. Ticket architectural debt. Do not edit code in L1 mode.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "implementer": {+ "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.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "verifier": {+ "name": "verifier",+ "description": "Checker agent for cleanup diffs. APPROVE or REJECT only.",+ "mode": "subagent",+ "prompt": "Review the cleanup diff against project rules. Verify scope is small and doesn't touch denylisted paths. Do not edit files. APPROVE or REJECT.",+ "permission": {+ "bash": "ask",+ "edit": "deny"+ }+ }+ }+}diff --git a/starters/post-merge-cleanup-opencode/post-merge-state.md.example b/starters/post-merge-cleanup-opencode/post-merge-state.md.examplenew file mode 100644index 0000000..336fd32--- /dev/null+++ b/starters/post-merge-cleanup-opencode/post-merge-state.md.example@@ -0,0 +1,10 @@+# Post-Merge State+Last run: 2026-06-20 09:00 UTC+Recent merges scanned: 0+Cleanup items: 0++## Proposed Fixes+- <!-- Small fixes proposed by the loop -->++## Ticketed Debt+- <!-- Architectural debt items ticketed for human triage -->diff --git a/starters/post-merge-cleanup-opencode/skills/post-merge-scan/SKILL.md b/starters/post-merge-cleanup-opencode/skills/post-merge-scan/SKILL.mdnew file mode 100644index 0000000..e9c0bd1--- /dev/null+++ b/starters/post-merge-cleanup-opencode/skills/post-merge-scan/SKILL.md@@ -0,0 +1,34 @@+---+name: post-merge-scan+description: >+ Scan recent merges to main for tech debt, TODOs, debug code, and+ small cleanup opportunities. Produces a prioritized fix list.+user_invocable: true+---++# Post-Merge Scan Skill++You are a post-merge cleanup agent. Scan recent merges for follow-up work.++## Scan Sources++- Recent commits and PRs merged to main+- `git diff HEAD~10` for left-behind debug code+- TODO/FIXME/HACK comments in changed files+- Lint warnings introduced by recent changes++## Classification++- **Small fix**: doc/comment/lint/debug — auto-fix candidate+- **Architectural debt**: ticket for human+- **Denylist path**: escalate to human++## Output++Update `post-merge-state.md` with prioritized cleanup list.++## Rules++- Run off-peak (evening).+- Never auto-fix architectural debt.+- Max 2 fix attempts per run.diff --git a/starters/pr-babysitter-opencode/AGENTS.md b/starters/pr-babysitter-opencode/AGENTS.mdnew file mode 100644index 0000000..d8915a0--- /dev/null+++ b/starters/pr-babysitter-opencode/AGENTS.md@@ -0,0 +1,18 @@+# AGENTS.md — PR Babysitter (Opencode)++## Loop Mode+- Start in L1 report-only mode.+- Read `pr-babysitter-state.md` before any triage.+- Do not edit source code until the human explicitly enables L2.++## Safety+- Never force-push without explicit human opt-in.+- Draft PRs by default; humans mark ready for review.+- Do not resolve review threads without approval.+- Security, auth, payments, infra, or public API changes always escalate.+- Max 3 fix attempts per PR before handoff.++## Verification+- For L2+ changes, dispatch verifier sub-agent after implementation.+- Run the project's documented tests before proposing a fix.+- Check for existing PR on the same intent before pushing.diff --git a/starters/pr-babysitter-opencode/LOOP.md b/starters/pr-babysitter-opencode/LOOP.mdnew file mode 100644index 0000000..f0185a6--- /dev/null+++ b/starters/pr-babysitter-opencode/LOOP.md@@ -0,0 +1,27 @@+# Loop Configuration — PR Babysitter (Opencode)++## Active Loops++| Pattern | Cadence | Status | Command |+|---------|---------|--------|---------|+| PR Babysitter | 10-15m | L1 report-only | `opencode run "Run PR babysitter triage" --agent loop-triage` via cron/systemd |++## Human Gates+- No auto-fix until L2 checklist complete.+- Draft PRs by default; humans mark ready for review.+- Do not resolve review threads without approval.+- Security, auth, payments, infra changes: always human.++## Worktrees+- One worktree per fix attempt; discard after verifier REJECT.+- Run implementer with `--dir <worktree>`.++## Budget+- Max sub-agent spawns per run: 0 (L1).+- Max 3 fix attempts per PR before handoff.+- Pause if token budget exceeded.++## Links+- Pattern: [pr-babysitter](../../patterns/pr-babysitter.md)+- Example: [examples/opencode/pr-babysitter.md](../../examples/opencode/pr-babysitter.md)+- Safety: [docs/safety.md](../../docs/safety.md)diff --git a/starters/pr-babysitter-opencode/README.md b/starters/pr-babysitter-opencode/README.mdnew file mode 100644index 0000000..6402f8d--- /dev/null+++ b/starters/pr-babysitter-opencode/README.md@@ -0,0 +1,44 @@+# PR Babysitter — Opencode Starter++Clone-and-run scaffold for the **PR Babysitter** pattern with opencode. Watch open PRs, surface blockers, and act only on safe obvious maintenance tasks.++## Quick Start++```bash+npx @cobusgreyling/loop-init . --pattern pr-babysitter --tool opencode+```++Or copy manually:++```bash+cp -r starters/pr-babysitter-opencode/skills .+cp starters/pr-babysitter-opencode/AGENTS.md .+cp starters/pr-babysitter-opencode/LOOP.md .+cp starters/pr-babysitter-opencode/pr-babysitter-state.md.example pr-babysitter-state.md+cp starters/pr-babysitter-opencode/opencode.json.example opencode.json+```++Start (report-only, week 1):++```bash+opencode run \+ "Run PR babysitter triage. Read pr-babysitter-state.md first. List PRs with red CI, stale review, merge conflicts, or unanswered review comments. Do not edit code. Update pr-babysitter-state.md." \+ --title "PR babysitter"+```++## What's Included++| File | Purpose |+|------|---------|+| `pr-babysitter-state.md.example` | State spine template |+| `skills/pr-review-triage/SKILL.md` | PR-focused triage skill |+| `AGENTS.md` | Always-on safety rules |+| `LOOP.md` | Cadence, gates, budget |+| `opencode.json.example` | Named agent definitions |++## Next Steps++- [patterns/pr-babysitter.md](../../patterns/pr-babysitter.md)+- [examples/opencode/pr-babysitter.md](../../examples/opencode/pr-babysitter.md)+- [docs/loop-design-checklist.md](../../docs/loop-design-checklist.md)+- [stories/pr-babysitter-week-one.md](../../stories/pr-babysitter-week-one.md)diff --git a/starters/pr-babysitter-opencode/opencode.json.example b/starters/pr-babysitter-opencode/opencode.json.examplenew file mode 100644index 0000000..2446188--- /dev/null+++ b/starters/pr-babysitter-opencode/opencode.json.example@@ -0,0 +1,35 @@+{+ "$schema": "https://opencode.ai/config.json",+ "agent": {+ "pr-babysitter": {+ "name": "pr-babysitter",+ "description": "PR-focused triage loop. Reads pr-babysitter-state.md, watches open PRs, and reports blockers without editing code.",+ "mode": "primary",+ "prompt": "Read AGENTS.md, LOOP.md, pr-babysitter-state.md, and skills/pr-review-triage/SKILL.md. Watch open PRs, check CI status, review staleness, and surface blockers. Do not edit source code unless L2 is explicitly enabled.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "implementer": {+ "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.",+ "permission": {+ "bash": "ask",+ "edit": "ask"+ }+ },+ "verifier": {+ "name": "verifier",+ "description": "Checker agent for PR fix diffs. APPROVE or REJECT only.",+ "mode": "subagent",+ "prompt": "Review the supplied diff against project rules, tests, and docs/safety.md. Do not edit files. Respond with APPROVE or REJECT and concise evidence.",+ "permission": {+ "bash": "ask",+ "edit": "deny"+ }+ }+ }+}diff --git a/starters/pr-babysitter-opencode/pr-babysitter-state.md.example b/starters/pr-babysitter-opencode/pr-babysitter-state.md.examplenew file mode 100644index 0000000..9492f41--- /dev/null+++ b/starters/pr-babysitter-opencode/pr-babysitter-state.md.example@@ -0,0 +1,10 @@+# PR Babysitter State+Last run: 2026-06-20 09:00 UTC+Open PRs tracked: 0+Attempt counts: {}++## Watch List+- <!-- Add open PRs here -->++## Fix History (L2+)+- <!-- Record attempt count and outcome per PR -->diff --git a/starters/pr-babysitter-opencode/skills/pr-review-triage/SKILL.md b/starters/pr-babysitter-opencode/skills/pr-review-triage/SKILL.mdnew file mode 100644index 0000000..d8f15b5--- /dev/null+++ b/starters/pr-babysitter-opencode/skills/pr-review-triage/SKILL.md@@ -0,0 +1,33 @@+---+name: pr-review-triage+description: >+ Watch open PRs, check CI status, review staleness, merge conflicts,+ and unanswered review comments. Produces a prioritized watchlist.+user_invocable: true+---++# PR Review Triage Skill++You are a PR babysitter agent. Your job is to track open PRs and surface blockers.++## Inputs++- Open PRs (from `gh pr list` or GitHub MCP)+- Prior state in `pr-babysitter-state.md`+- CI status for each PR++## Output++Update `pr-babysitter-state.md` with:++- PRs with red CI+- PRs with merge conflicts+- PRs waiting >48h for review+- PRs with unanswered review comments+- Top 3 actions for a human++## Rules++- Do not edit code in L1 mode.+- Always check for existing PR on the same intent before pushing.+- Security/auth/payments changes: flag for human.diff --git a/tools/loop-init/dist/cli.js b/tools/loop-init/dist/cli.jsindex 91041e0..7bbfe52 100644--- a/tools/loop-init/dist/cli.js+++ b/tools/loop-init/dist/cli.js@@ -361,7 +361,7 @@ Examples:const targetDir = path.resolve(target);const baseStarter = PATTERN_STARTERS[pattern];const suffix = TOOL_SUFFIX[tool];- const starterName = pattern === 'daily-triage' ? `minimal-loop${suffix}` : baseStarter;+ const starterName = `${baseStarter}${suffix}`;const startersRoot = await resolveBundledOrMonorepo('starters');const templatesRoot = await resolveBundledOrMonorepo('templates');const starterRoot = path.join(startersRoot, starterName);diff --git a/tools/loop-init/package.json b/tools/loop-init/package.jsonindex 27ae3a7..4bbe0c3 100644--- a/tools/loop-init/package.json+++ b/tools/loop-init/package.json@@ -1,6 +1,6 @@{"name": "@cobusgreyling/loop-init",- "version": "1.3.1",+ "version": "1.3.2","description": "Scaffold loop engineering patterns and starters into any project. Supports Grok, Claude Code, Codex, Opencode and more. npx @cobusgreyling/loop-init . --pattern daily-triage --tool opencode","type": "module","bin": {diff --git a/tools/loop-init/registry.yaml b/tools/loop-init/registry.yamlindex 89f7aa4..edb05c3 100644--- a/tools/loop-init/registry.yaml+++ b/tools/loop-init/registry.yaml@@ -8,7 +8,7 @@ patterns:goal: Shepherd PRs through review, CI, rebase, and mergecadence: 5m-15mrisk: medium- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [pr-review-triage, minimal-fix, rebase-and-clean]state: pr-babysitter-state.mdphases: [discover, triage, fix, verify, notify]@@ -29,7 +29,7 @@ patterns:goal: Prioritized morning scan of CI, issues, commits, and chatcadence: 1d-2hrisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [loop-triage, minimal-fix]state: STATE.mdphases: [report, act-small-wins, escalate]@@ -50,7 +50,7 @@ patterns:goal: React to failing CI with minimal fixes and escalationcadence: 5m-15mrisk: medium- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [ci-triage, minimal-fix]state: ci-sweeper-state.mdphases: [detect, classify, fix, verify, escalate]@@ -71,7 +71,7 @@ patterns:goal: Follow-up tech debt and cleanup after merges to maincadence: 1d-6hrisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [post-merge-scan, minimal-fix]state: post-merge-state.mdphases: [scan-merges, prioritize, fix-small, ticket-large]@@ -92,7 +92,7 @@ patterns:goal: Discover, safely apply, and verify dependency + vulnerability updates with human gates on risky changescadence: 6h-1drisk: medium- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [dependency-triage, minimal-fix, loop-verifier]state: dependency-sweeper-state.mdphases: [scan, triage-risk, patch-safe, verify-worktree, escalate-risky]@@ -113,7 +113,7 @@ patterns:goal: Scan merged PRs and commits, draft categorized high-quality release notes or CHANGELOG entries for human reviewcadence: 1drisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [changelog-scan, draft-release-notes, loop-verifier]state: changelog-drafter-state.mdphases: [scan-merges, categorize, draft, review, publish]@@ -134,7 +134,7 @@ patterns:goal: Discover, deduplicate, prioritize and label incoming issues/discussions so the team always has a clean actionable queue. Excellent low-risk companion to Daily Triage.cadence: 2h-1drisk: low- tools: [grok, claude-code, codex, github-actions]+ tools: [grok, claude-code, codex, openclaw, opencode, github-actions]skills: [issue-triage, loop-verifier]state: issue-triage-state.mdphases: [discover, dedupe, score, propose-labels, human-review]diff --git a/tools/loop-init/src/cli.ts b/tools/loop-init/src/cli.tsindex 58d3c3e..d0c6cc1 100644--- a/tools/loop-init/src/cli.ts+++ b/tools/loop-init/src/cli.ts@@ -427,7 +427,7 @@ Examples:const targetDir = path.resolve(target);const baseStarter = PATTERN_STARTERS[pattern];const suffix = TOOL_SUFFIX[tool];- const starterName = pattern === 'daily-triage' ? `minimal-loop${suffix}` : baseStarter;+ const starterName = `${baseStarter}${suffix}`;const startersRoot = await resolveBundledOrMonorepo('starters');const templatesRoot = await resolveBundledOrMonorepo('templates');const starterRoot = path.join(startersRoot, starterName);