@cobusgreyling/loop-init 1.2.3 → 1.3.2

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

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

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

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

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

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

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

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

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

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