@cobusgreyling/loop-init 1.2.3 → 1.3.2

package/README.md

@@ -8,6 +8,7 @@ Scaffold loop engineering starters into your project by pattern and tool.
 
 ```bash
 npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
+npx @cobusgreyling/loop-init . --pattern daily-triage --tool opencode
 npx @cobusgreyling/loop-init . -p pr-babysitter -t claude
 npx @cobusgreyling/loop-init . -p dependency-sweeper --dry-run
 ```
@@ -41,6 +42,7 @@ Every scaffold also creates:
 - `grok` (default)
 - `claude`
 - `codex`
+- `opencode` — daily-triage ships `minimal-loop-opencode` (`skills/`, `AGENTS.md`, `opencode.json`)
 
 Falls back to Grok starter paths when a per-tool variant is not yet available.
 

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { spawn } from 'node:child_process';
 import { cp, mkdir, readFile, writeFile, access } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -19,6 +20,7 @@ const TOOL_SUFFIX = {
     grok: '',
     claude: '-claude',
     codex: '-codex',
+    opencode: '-opencode',
 };
 const L2_PATTERNS = new Set(['ci-sweeper', 'dependency-sweeper']);
 const PATTERNS_NEEDING_FIX = new Set([
@@ -99,6 +101,7 @@ async function copyTemplateSkill(templatesRoot, templateFile, targetDir, tool, s
         grok: path.join(targetDir, '.grok', 'skills', skillName, 'SKILL.md'),
         claude: path.join(targetDir, '.claude', 'skills', skillName, 'SKILL.md'),
         codex: path.join(targetDir, '.codex', 'skills', skillName, 'SKILL.md'),
+        opencode: path.join(targetDir, 'skills', skillName, 'SKILL.md'),
     };
     const dest = destByTool[tool];
     if (await exists(dest))
@@ -110,6 +113,7 @@ async function copyTemplateVerifier(templatesRoot, targetDir, tool, dryRun) {
         grok: path.join(targetDir, '.grok', 'skills', 'loop-verifier', 'SKILL.md'),
         claude: path.join(targetDir, '.claude', 'agents', 'loop-verifier.md'),
         codex: path.join(targetDir, '.codex', 'agents', 'verifier.toml'),
+        opencode: path.join(targetDir, 'skills', 'loop-verifier', 'SKILL.md'),
     };
     const dest = verifierPaths[tool];
     if (await exists(dest))
@@ -214,53 +218,112 @@ async function copyFile(src, dest, dryRun) {
     console.log(`  copied: ${src} → ${dest}`);
     return true;
 }
+const OPENCODE_RUN = 'opencode run';
 function firstLoopCommand(pattern, tool) {
     const cmds = {
         'daily-triage': {
             grok: '/loop 1d Run loop-triage. Update STATE.md. No auto-fix in week one.',
             claude: '/loop 1d $loop-triage — update STATE.md. Report-only week one.',
             codex: 'Automation daily: $loop-triage → update STATE.md. Report-only.',
+            opencode: `${OPENCODE_RUN} "Run loop-triage. Read STATE.md first. Update High Priority and Watch List. No auto-fix in week one." --agent loop-triage`,
         },
         'pr-babysitter': {
             grok: '/loop 10m Run pr-review-triage. Update pr-babysitter-state.md. Worktree + minimal-fix + verifier for allowlisted PRs only. Escalate after 3 attempts.',
             claude: '/loop 10m $pr-review-triage — update pr-babysitter-state.md. No auto-merge.',
             codex: 'Automation 10m: pr-review-triage → pr-babysitter-state.md. No auto-merge.',
+            opencode: `${OPENCODE_RUN} "Run PR babysitter triage. Read pr-babysitter-state.md first. Report only — no code edits." --title "PR babysitter"`,
         },
         'ci-sweeper': {
             grok: '/loop 15m Run ci-triage on failing CI. Update ci-sweeper-state.md. Fix only regressions in worktree. Max 3 attempts.',
             claude: '/loop 15m $ci-triage — update ci-sweeper-state.md. Max 3 fix attempts.',
             codex: 'Automation 15m: ci-triage on CI failures. Max 3 attempts.',
+            opencode: `${OPENCODE_RUN} "Run ci-triage on failing CI. Update ci-sweeper-state.md. Report only in week one."`,
         },
         'dependency-sweeper': {
             grok: '/loop 6h Run dependency-triage. Patch-only auto-fix in worktree + verifier. Escalate majors and denylist.',
             claude: '/loop 6h $dependency-triage — patch-only with verifier. Escalate risky bumps.',
             codex: 'Automation 6h: dependency-triage. Patch-only with verifier.',
+            opencode: `${OPENCODE_RUN} "Run dependency-triage. Update dependency-sweeper-state.md. Report only — escalate majors."`,
         },
         'post-merge-cleanup': {
             grok: '/loop 1d Run post-merge-scan on recent merges. Update post-merge-state.md. Small fixes only in worktree.',
             claude: '/loop 1d $post-merge-scan — update post-merge-state.md. Small fixes only.',
             codex: 'Automation daily: post-merge-scan → post-merge-state.md.',
+            opencode: `${OPENCODE_RUN} "Run post-merge-scan. Update post-merge-state.md. Report only in week one."`,
         },
         'changelog-drafter': {
             grok: '/loop 1d Run changelog-scan on merges since last tag. Produce categorized draft in RELEASE_NOTES_DRAFT.md using draft-release-notes. Update changelog-drafter-state.md. Human review only.',
             claude: '/loop 1d $changelog-scan + draft-release-notes — write RELEASE_NOTES_DRAFT.md and update state. Human approves before publish.',
             codex: 'Automation daily: changelog-scan + draft-release-notes → RELEASE_NOTES_DRAFT.md. Human review.',
+            opencode: `${OPENCODE_RUN} "Run changelog-scan. Draft RELEASE_NOTES_DRAFT.md. Human review only — no publish."`,
         },
         'issue-triage': {
             grok: '/loop 2h Run issue-triage. Update issue-triage-state.md. Propose labels and priority only. No auto-apply. Human reviews the needs-human slice.',
             claude: '/loop 2h $issue-triage — update issue-triage-state.md. Suggest labels on allowlisted areas only. Report mode week one.',
             codex: 'Automation 2h: issue-triage → issue-triage-state.md. Propose only.',
+            opencode: `${OPENCODE_RUN} "Run issue-triage. Update issue-triage-state.md. Propose labels only — no auto-apply."`,
         },
     };
     return cmds[pattern][tool];
 }
+async function resolveAuditCli() {
+    const monorepo = path.resolve(PACKAGE_ROOT, '../loop-audit/dist/cli.js');
+    if (await exists(monorepo))
+        return monorepo;
+    try {
+        const { createRequire } = await import('node:module');
+        const require = createRequire(import.meta.url);
+        const pkg = require.resolve('@cobusgreyling/loop-audit/package.json');
+        return path.join(path.dirname(pkg), 'dist/cli.js');
+    }
+    catch {
+        return null;
+    }
+}
+async function runAuditJson(cli, targetDir) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('node', [cli, targetDir, '--json'], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.on('error', reject);
+        child.on('close', () => {
+            if (stdout.trim())
+                resolve(stdout);
+            else
+                reject(new Error('loop-audit produced no output'));
+        });
+    });
+}
+async function runAuditSummary(targetDir) {
+    const cli = await resolveAuditCli();
+    if (!cli)
+        return null;
+    try {
+        const stdout = await runAuditJson(cli, targetDir);
+        return JSON.parse(stdout);
+    }
+    catch {
+        return null;
+    }
+}
+function formatScoreBar(score, width = 20) {
+    const filled = Math.max(0, Math.min(width, Math.round((score / 100) * width)));
+    return `${'█'.repeat(filled)}${'░'.repeat(width - filled)}  ${score}/100`;
+}
+function auditTargetArg(target, targetDir) {
+    return target === '.' ? '.' : targetDir;
+}
 async function main() {
     const args = parseArgs(process.argv.slice(2));
     if (args.help) {
         console.log(`loop-init — scaffold loop engineering starters
 
 Usage:
-  loop-init [target-dir] --pattern <name> --tool <grok|claude|codex>
+  loop-init [target-dir] --pattern <name> --tool <grok|claude|codex|opencode>
 
 Patterns:
   daily-triage (default)
@@ -280,6 +343,7 @@ Options:
 Examples:
   npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
   npx @cobusgreyling/loop-init . -p pr-babysitter -t claude
+  npx @cobusgreyling/loop-init . -p daily-triage -t opencode
 `);
         process.exit(0);
     }
@@ -297,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);
@@ -313,33 +377,52 @@ Examples:
         ? starterRoot
         : path.join(startersRoot, baseStarter);
     console.log(`\nloop-init: ${pattern} → ${targetDir} (${tool})${dryRun ? ' [dry-run]' : ''}\n`);
-    const skillRoots = [
-        path.join(effectiveStarter, '.grok', 'skills'),
-        path.join(effectiveStarter, '.claude', 'skills'),
-        path.join(effectiveStarter, '.codex', 'skills'),
-    ];
-    for (const skillsDir of skillRoots) {
-        if (!(await exists(skillsDir)))
-            continue;
-        const toolPrefix = skillsDir.includes('.grok')
-            ? '.grok/skills'
-            : skillsDir.includes('.claude')
-                ? '.claude/skills'
-                : '.codex/skills';
-        const entries = await readDirNames(skillsDir);
-        for (const entry of entries) {
-            await copyDir(path.join(skillsDir, entry), path.join(targetDir, toolPrefix, entry), dryRun);
+    if (tool === 'opencode') {
+        const skillsDir = path.join(effectiveStarter, 'skills');
+        if (await exists(skillsDir)) {
+            const entries = await readDirNames(skillsDir);
+            for (const entry of entries) {
+                await copyDir(path.join(skillsDir, entry), path.join(targetDir, 'skills', entry), dryRun);
+            }
+        }
+        const agentsMd = path.join(effectiveStarter, 'AGENTS.md');
+        if (await exists(agentsMd)) {
+            await copyFile(agentsMd, path.join(targetDir, 'AGENTS.md'), dryRun);
+        }
+        const opencodeJson = path.join(effectiveStarter, 'opencode.json.example');
+        if (await exists(opencodeJson)) {
+            await copyFile(opencodeJson, path.join(targetDir, 'opencode.json'), dryRun);
         }
     }
-    const agentFiles = [
-        { src: path.join(effectiveStarter, '.claude', 'agents'), dest: path.join(targetDir, '.claude', 'agents') },
-        { src: path.join(effectiveStarter, '.codex', 'agents'), dest: path.join(targetDir, '.codex', 'agents') },
-    ];
-    for (const { src, dest } of agentFiles) {
-        if (await exists(src)) {
-            const entries = await readDirNames(src);
+    else {
+        const skillRoots = [
+            path.join(effectiveStarter, '.grok', 'skills'),
+            path.join(effectiveStarter, '.claude', 'skills'),
+            path.join(effectiveStarter, '.codex', 'skills'),
+        ];
+        for (const skillsDir of skillRoots) {
+            if (!(await exists(skillsDir)))
+                continue;
+            const toolPrefix = skillsDir.includes('.grok')
+                ? '.grok/skills'
+                : skillsDir.includes('.claude')
+                    ? '.claude/skills'
+                    : '.codex/skills';
+            const entries = await readDirNames(skillsDir);
             for (const entry of entries) {
-                await copyFile(path.join(src, entry), path.join(dest, entry), dryRun);
+                await copyDir(path.join(skillsDir, entry), path.join(targetDir, toolPrefix, entry), dryRun);
+            }
+        }
+        const agentFiles = [
+            { src: path.join(effectiveStarter, '.claude', 'agents'), dest: path.join(targetDir, '.claude', 'agents') },
+            { src: path.join(effectiveStarter, '.codex', 'agents'), dest: path.join(targetDir, '.codex', 'agents') },
+        ];
+        for (const { src, dest } of agentFiles) {
+            if (await exists(src)) {
+                const entries = await readDirNames(src);
+                for (const entry of entries) {
+                    await copyFile(path.join(src, entry), path.join(dest, entry), dryRun);
+                }
             }
         }
     }
@@ -361,7 +444,7 @@ Examples:
     await copyL2Templates(pattern, tool, targetDir, templatesRoot, dryRun);
     await scaffoldObservability(pattern, tool, targetDir, templatesRoot, dryRun);
     await scaffoldConstraints(targetDir, templatesRoot, tool, dryRun);
-    if (!dryRun && !(await exists(path.join(targetDir, 'AGENTS.md')))) {
+    if (tool !== 'opencode' && !dryRun && !(await exists(path.join(targetDir, 'AGENTS.md')))) {
         const agentsTemplate = `# AGENTS.md
 
 ## Test commands
@@ -375,10 +458,29 @@ npm run lint
         await writeFile(path.join(targetDir, 'AGENTS.md'), agentsTemplate);
         console.log('  created: AGENTS.md (template)');
     }
-    console.log('\n=== Next steps ===');
-    console.log(`  npx @cobusgreyling/loop-audit ${target === '.' ? '.' : target} --suggest`);
-    console.log(`  npx @cobusgreyling/loop-cost --pattern ${pattern}`);
-    console.log(`  First loop command (${tool}):\n  ${firstLoopCommand(pattern, tool)}\n`);
+    const auditArg = auditTargetArg(target, targetDir);
+    if (!dryRun) {
+        const audit = await runAuditSummary(targetDir);
+        if (audit) {
+            console.log('');
+            console.log(`✓ Loop Ready: ${audit.score}/100 (${audit.level})`);
+            console.log(`  ${formatScoreBar(audit.score)}`);
+            console.log(`  ${audit.assessment}`);
+            console.log('');
+            console.log('Paste badge in README:');
+            console.log(`  npx @cobusgreyling/loop-audit ${auditArg} --badge`);
+        }
+        else {
+            console.log('\n=== Loop Ready score ===');
+            console.log(`  npx @cobusgreyling/loop-audit ${auditArg} --suggest`);
+        }
+    }
+    console.log('');
+    console.log(`First loop (${tool}):`);
+    console.log(`  ${firstLoopCommand(pattern, tool)}`);
+    console.log('');
+    console.log(`Estimate cost: npx @cobusgreyling/loop-cost --pattern ${pattern} --level L1`);
+    console.log('');
 }
 async function readDirNames(dir) {
     const { readdir } = await import('node:fs/promises');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cobusgreyling/loop-init",
-  "version": "1.2.3",
-  "description": "Scaffold loop engineering patterns and starters into any project. Supports Grok, Claude Code, Codex and more. npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok",
+  "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": {
     "loop-init": "./dist/cli.js"
@@ -31,6 +31,7 @@
     "claude-code",
     "grok",
     "codex",
+    "opencode",
     "github-actions",
     "patterns"
   ],
@@ -48,6 +49,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@cobusgreyling/loop-audit": "^1.5.0"
+  },
   "devDependencies": {
     "@types/node": "^26.0.0",
     "typescript": "^6.0.3"

package/starters/README.md

@@ -14,21 +14,28 @@ npx @cobusgreyling/loop-init . -p pr-babysitter -t claude
 | [minimal-loop](./minimal-loop/) | Grok | `.grok/skills/` |
 | [minimal-loop-claude](./minimal-loop-claude/) | Claude Code | `.claude/skills/` + `.claude/agents/` |
 | [minimal-loop-codex](./minimal-loop-codex/) | Codex | `.codex/skills/` + `.codex/agents/` |
+| [minimal-loop-opencode](./minimal-loop-opencode/) | Opencode | `skills/` + `AGENTS.md` |
 
 ## L2 assisted patterns
 
 | 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:
 
 ```bash
 npx @cobusgreyling/loop-audit .
 npx @cobusgreyling/loop-audit . --suggest
-```
+```

package/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.

package/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)

package/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)

package/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: 0

package/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"
+      }
+    }
+  }
+}

package/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.

package/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.

package/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)

package/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)

package/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 -->