Skip to content

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

chore: add issue body templates for good-first backlog #147-154 (#155)

Cobus Greylingc6ef02e155f0
diff --git a/scripts/issue-bodies/cline-appendix.md b/scripts/issue-bodies/cline-appendix.md
new file mode 100644
index 0000000..9e5e2e5
--- /dev/null
+++ b/scripts/issue-bodies/cline-appendix.md
@@ -0,0 +1,13 @@
+## Goal
+Document **Cline** (VS Code agent) in the primitives matrix for contributors using Cline as their loop host.
+
+## Files
+- `docs/primitives-matrix.md`
+
+## Acceptance criteria
+- [ ] Add a **Cline appendix** (same style as Aider / editor transfer recipes)
+- [ ] Cover scheduling (manual vs external cron), skills/rules path, `STATE.md`, maker/checker split
+- [ ] Honest note where a primitive is not first-class in Cline yet
+- [ ] One copy-paste week-one Daily Triage command (report-only)
+
+**Estimated time:** ~30 minutes
\ No newline at end of file
diff --git a/scripts/issue-bodies/cursor-pr-babysitter-example.md b/scripts/issue-bodies/cursor-pr-babysitter-example.md
new file mode 100644
index 0000000..9462014
--- /dev/null
+++ b/scripts/issue-bodies/cursor-pr-babysitter-example.md
@@ -0,0 +1,15 @@
+## Goal
+Add a **Cursor PR Babysitter** example doc — the pattern coverage table has a gap for Cursor L2 patterns.
+
+## Files
+- `examples/cursor/pr-babysitter.md` (new)
+- `examples/cursor/README.md` (link it)
+- `examples/README.md` (fill the `—` in PR Babysitter × Cursor cell)
+
+## Acceptance criteria
+- [ ] Report-first week one; human gate on merges
+- [ ] Map primitives: Automations, skills/rules, `pr-babysitter-state.md`, verifier split
+- [ ] Follow tone/structure of `examples/cursor/daily-triage.md`
+- [ ] Honest L1 default — no unattended merges in week one
+
+**Estimated time:** ~45 minutes
\ No newline at end of file
diff --git a/scripts/issue-bodies/dependency-sweeper-story.md b/scripts/issue-bodies/dependency-sweeper-story.md
new file mode 100644
index 0000000..8c3c939
--- /dev/null
+++ b/scripts/issue-bodies/dependency-sweeper-story.md
@@ -0,0 +1,13 @@
+## Goal
+Share an honest **Dependency Sweeper** story — win or failure — to help others calibrate patch-only automation.
+
+## Files
+- New file under `stories/` (use `stories/TEMPLATE.md` if present, or follow existing story format)
+
+## Acceptance criteria
+- [ ] Which tool and pattern you ran
+- [ ] Week-one constraints (patch-only, human gate, etc.)
+- [ ] One surprise (good or bad)
+- [ ] What you would change next time
+
+**Estimated time:** ~15 minutes
\ No newline at end of file
diff --git a/scripts/issue-bodies/examples-aider-link.md b/scripts/issue-bodies/examples-aider-link.md
new file mode 100644
index 0000000..3f7f27a
--- /dev/null
+++ b/scripts/issue-bodies/examples-aider-link.md
@@ -0,0 +1,12 @@
+## Goal
+Link the existing **Aider appendix** from `examples/README.md` so CLI-first users find the transfer recipe.
+
+## Files
+- `examples/README.md`
+
+## Acceptance criteria
+- [ ] Add Aider row to the tool directory table (link to `docs/primitives-matrix.md#aider-cli`)
+- [ ] One-line description: CLI-first loops via cron + `--read` skills
+- [ ] No duplicate appendix content — link only
+
+**Estimated time:** ~10 minutes
\ No newline at end of file
diff --git a/scripts/issue-bodies/hermes-examples-readme.md b/scripts/issue-bodies/hermes-examples-readme.md
new file mode 100644
index 0000000..64af7be
--- /dev/null
+++ b/scripts/issue-bodies/hermes-examples-readme.md
@@ -0,0 +1,12 @@
+## Goal
+Add **Hermes Agent** to the examples index so the new daily-triage bridge is discoverable from `examples/README.md`.
+
+## Files
+- `examples/README.md`
+
+## Acceptance criteria
+- [ ] Add Hermes row to the tool directory table (link `examples/hermes/`)
+- [ ] Add Hermes column to the pattern coverage table (at least Daily Triage — link `examples/hermes/daily-triage.md`)
+- [ ] Keep table formatting consistent with existing columns
+
+**Estimated time:** ~15 minutes
\ No newline at end of file
diff --git a/scripts/issue-bodies/quickstart-loop-context.md b/scripts/issue-bodies/quickstart-loop-context.md
new file mode 100644
index 0000000..594992c
--- /dev/null
+++ b/scripts/issue-bodies/quickstart-loop-context.md
@@ -0,0 +1,13 @@
+## Goal
+Document **`loop-context`** circuit breaker usage in the Quickstart now that `@cobusgreyling/loop-context` is on npm.
+
+## Files
+- `docs/QUICKSTART.md`
+
+## Acceptance criteria
+- [ ] Short subsection after constraints / budget steps
+- [ ] Show `npx @cobusgreyling/loop-context --check --ledger loop-ledger.json`
+- [ ] Explain when to trip (same failure N×, max attempts) in one paragraph
+- [ ] Link to `tools/loop-context/README.md` for full API
+
+**Estimated time:** ~20 minutes
\ No newline at end of file
diff --git a/scripts/issue-bodies/quickstart-mcp-server.md b/scripts/issue-bodies/quickstart-mcp-server.md
new file mode 100644
index 0000000..d6e02c2
--- /dev/null
+++ b/scripts/issue-bodies/quickstart-mcp-server.md
@@ -0,0 +1,13 @@
+## Goal
+Add a short **loop-mcp-server** install snippet to the Quickstart so newcomers can wire MCP without hunting `tools/mcp-server/`.
+
+## Files
+- `docs/QUICKSTART.md`
+
+## Acceptance criteria
+- [ ] New subsection (e.g. "Optional: MCP runtime lookup") after audit/init steps
+- [ ] Show `examples/mcp/loop-engineering.mcp.json` copy path
+- [ ] Show one-liner to run the server from a cloned repo
+- [ ] Note npm publish is pending — do not claim `npx` works yet
+
+**Estimated time:** ~20 minutes
\ No newline at end of file
diff --git a/scripts/issue-bodies/zed-appendix.md b/scripts/issue-bodies/zed-appendix.md
new file mode 100644
index 0000000..2439a54
--- /dev/null
+++ b/scripts/issue-bodies/zed-appendix.md
@@ -0,0 +1,13 @@
+## Goal
+Document **Zed** agent workflows in the primitives matrix.
+
+## Files
+- `docs/primitives-matrix.md`
+
+## Acceptance criteria
+- [ ] Add a **Zed appendix** (same style as Aider appendix)
+- [ ] Cover scheduling, project rules / skills path, `STATE.md`, maker/checker split
+- [ ] Honest note where a primitive is not first-class in Zed yet
+- [ ] Link to Zed docs where helpful
+
+**Estimated time:** ~30 minutes
\ No newline at end of file