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
docs(examples): add Hermes PR Babysitter example (#247)
lorenzobosio02cc9f3b8126
diff --git a/examples/README.md b/examples/README.mdindex 135d425..fa4b6ab 100644--- a/examples/README.md+++ b/examples/README.md@@ -24,7 +24,7 @@ Start with [primitives-matrix.md](../docs/primitives-matrix.md) to map capabilit| Pattern | Grok | Claude | Codex | OpenClaw | Cursor | Windsurf | Opencode | Hermes | 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) | [cursor/daily-triage.md](./cursor/daily-triage.md) | [windsurf/daily-triage.md](./windsurf/daily-triage.md) | [opencode/daily-triage.md](./opencode/daily-triage.md) | [hermes/daily-triage.md](./hermes/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) | [openclaw/pr-babysitter.md](./openclaw/pr-babysitter.md) | [cursor/pr-babysitter.md](./cursor/pr-babysitter.md) | [windsurf/pr-babysitter.md](./windsurf/pr-babysitter.md) | [opencode/pr-babysitter.md](./opencode/pr-babysitter.md) | — | [github-actions/pr-babysitter.yml](./github-actions/pr-babysitter.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) | [cursor/pr-babysitter.md](./cursor/pr-babysitter.md) | [windsurf/pr-babysitter.md](./windsurf/pr-babysitter.md) | [opencode/pr-babysitter.md](./opencode/pr-babysitter.md) | [hermes/pr-babysitter.md](./hermes/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) | [cursor/dependency-sweeper.md](./cursor/dependency-sweeper.md) | — | [opencode/dependency-sweeper.md](./opencode/dependency-sweeper.md) | — | [github-actions/dependency-sweeper.yml](./github-actions/dependency-sweeper.yml) |@@ -41,5 +41,5 @@ L2 patterns ship multi-tool skills inside one starter folder — see `starters/<| 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) |-| Hermes | [hermes/daily-triage.md](./hermes/daily-triage.md) (manual) | — | — | — | — | — | — |+| Hermes | [hermes/daily-triage.md](./hermes/daily-triage.md) (manual) | [hermes/pr-babysitter.md](./hermes/pr-babysitter.md) (manual) | — | — | — | — | — || 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/hermes/README.md b/examples/hermes/README.mdindex dd55947..7e31bdc 100644--- a/examples/hermes/README.md+++ b/examples/hermes/README.md@@ -5,6 +5,7 @@| Example | Pattern ||---------|---------|| [daily-triage.md](./daily-triage.md) | Daily Triage (L1 report → L2 assisted) |+| [pr-babysitter.md](./pr-babysitter.md) | PR Babysitter (L1 report → L2 worktree + verifier) |Optional **channel delivery** (Telegram, Slack, Discord, WhatsApp, SMS, Feishu) is Hermes's differentiator — the same cron job can post its summary into any connected home channel.diff --git a/examples/hermes/pr-babysitter.md b/examples/hermes/pr-babysitter.mdnew file mode 100644index 0000000..ea6d0b0--- /dev/null+++ b/examples/hermes/pr-babysitter.md@@ -0,0 +1,112 @@+# PR Babysitter — Hermes Agent (`hermes cron`)++This is a practical, copy-pasteable example of a PR babysitter loop using Hermes.++Hermes ships a native scheduler on its **gateway** — map the loop to `hermes cron`+instead of a TUI `/loop`. Optional **channel delivery** (Feishu, Slack, Telegram,+Discord, WhatsApp, SMS) can ping blockers into the channel the team already watches+once you trust the output; week one stays on `--deliver local`.++## Cron job (week one — report only)++Isolated session each tick: reads GitHub state, updates `pr-babysitter-state.md`,+no code edits, **no merges**.++```bash+hermes cron create "*/15 * * * *" \+ --name "PR babysitter" \+ --deliver local \+ --skill pr-review-triage \+ --workdir "$PWD" \+ "Run the pr-review-triage skill on all open PRs. Read pr-babysitter-state.md first, then update it with current CI status, review state, merge conflicts, and unanswered comments. Do not merge or push fixes in week one — report only. Flag anything ambiguous or high-risk for human review in pr-babysitter-state.md. End with the top 3 human actions."+```++- `--deliver local` writes output to `~/.hermes/cron/output/` only — nothing lands+ in the human's chat history until you trust the output. Swap for `--deliver origin`+ (current chat), a home channel name (e.g. `slack`, `feishu`), or+ `platform:chat_id:thread_id` for a specific thread.+- `--workdir "$PWD"` injects `AGENTS.md` / `CLAUDE.md` / `.cursorrules` from the+ project into the system prompt and pins the terminal cwd to the repo.+- Repeat `--skill` to attach multiple skills (e.g. `--skill pr-review-triage+ --skill github-workflow` if PR reads go through a GitHub skill instead of `gh`).+- Operations: `hermes cron run <job-id>` for a one-off test tick, then+ `pause` / `resume` / `edit` / `remove` as needed.++## Progression++- **Week one — report only.** Fresh isolated session each tick appends to+ `pr-babysitter-state.md`. Read it yourself before acting on any suggestion.+ Human gates all merges.+- **Week two — minimal fixes in worktrees.** Extend the prompt to propose fixes+ in an isolated worktree for allowlisted low-risk PRs only — one worktree per+ fix attempt via [`loop-worktree`](../../docs/QUICKSTART.md#l2-isolated-fix-attempts-loop-worktree)+ so retries never collide on the same branch. Draft PRs only; never force-push.+- **Week two — verifier split.** A separate verifier approves before any fix is+ committed: a second `delegate_task` call with a review-only prompt, or a chained+ cron job via `hermes cron edit <fixer-id> --context-from <triage-id>` (the+ upstream job's stdout is injected into the downstream prompt). Never let the+ implementer mark its own work done. Escalate after 3 attempts per PR.+- **Add channel delivery.** Swap `--deliver local` for a home channel once the+ output has earned trust; set channel `allowFrom` / mention rules first.++Week-two worktree lifecycle (see the+[loop-worktree subsection of the QUICKSTART](../../docs/QUICKSTART.md#l2-isolated-fix-attempts-loop-worktree)):++```bash+npx @cobusgreyling/loop-worktree create --run-id pr-217-fix-1 --pattern pr-babysitter+# fix + verifier run inside the printed worktree path+npx @cobusgreyling/loop-worktree mark --run-id pr-217-fix-1 --status rejected # verifier said no+npx @cobusgreyling/loop-worktree cleanup --older-than 24h+```++## Requirements++- [Hermes Agent](https://hermes-agent.nousresearch.com/docs) installed and+ configured (`hermes setup`)+- `pr-babysitter-state.md` in the repo root (from `starters/pr-babysitter/`)+- The `pr-review-triage` skill in `~/.hermes/skills/pr-review-triage/SKILL.md`+ (user-scoped) or `.hermes/skills/` (project-scoped) — the `SKILL.md` format is+ shared across tools, so the starter copy works unchanged++```bash+cp starters/pr-babysitter/pr-babysitter-state.md.example pr-babysitter-state.md++mkdir -p ~/.hermes/skills/pr-review-triage+cp starters/pr-babysitter/.claude/skills/pr-review-triage/SKILL.md ~/.hermes/skills/pr-review-triage/SKILL.md++hermes skills list | grep pr-review-triage+```++## Example pr-babysitter-state.md++```markdown+# PR Babysitter State+Last run: 2026-07-05 09:00 UTC++## Open PRs++### #1234 — fix: correct login redirect+- CI: green+- Reviews: 1 approval, 1 blocking comment+- Loop action: report only (week one). Needs human triage.+- Attempts: 1 / 3+```++## Notes++- Never force-push; draft PRs by default; do not resolve review threads without+ approval. Security, auth, payments, infra, or public API changes always+ escalate — see [docs/safety.md](../../docs/safety.md)+- Sign loop comments on PRs: `🤖 Loop Engineering — PR Babysitter`+- Webhooks (`POST /hooks/agent`) can fire a check the moment CI finishes instead+ of waiting for the next tick — keep hook endpoints on loopback or a trusted tailnet+- `hermes config set approvals.mode smart` so low-risk reads don't stall the loop+ on manual gateway approvals+- Most runs should no-op on an empty watchlist. Cost check:+ `npx @cobusgreyling/loop-cost --pattern pr-babysitter --cadence 15m --level L1 --conservative`;+ audit readiness: `npx @cobusgreyling/loop-audit . --suggest`+- See [patterns/pr-babysitter.md](../../patterns/pr-babysitter.md) and+ [starters/pr-babysitter](../../starters/pr-babysitter/) for the full pattern spec++See the [primitives matrix](../../docs/primitives-matrix.md) for how Hermes maps+to the same six-part loop shape.