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: expand Aider primitives appendix
roian6635bd802ec45
diff --git a/docs/primitives-matrix.md b/docs/primitives-matrix.mdindex cdcb521..fd708b6 100644--- a/docs/primitives-matrix.md+++ b/docs/primitives-matrix.md@@ -102,6 +102,36 @@ Transfer recipes map the same loop shape onto each host:| 4. Verification | Create a verifier named agent with `opencode agent`; invoke via `opencode run "Verify diff" --agent verifier --file diff.patch` | `.cursor/agents/loop-verifier.md` from `templates/SKILL.md.verifier` | Add review step at end of workflow; human gate on denylist paths || 5. Connectors | Configure MCP or CLI bridges in `opencode.json` | Enable GitHub MCP read-only for issue/PR discovery | Configure GitHub MCP in Cascade settings |-**Aider** (CLI-only): use `--watch` or scripted sessions; state in `STATE.md`; reviewer = second terminal session.--Transfer recipe: copy the tool-agnostic `SKILL.md` + state schema from this repo; map scheduling to your editor's automation surface.+## Appendix: Aider CLI++Aider is CLI-first rather than a loop host with native schedulers, so map the same primitives from [Choosing a Tool](#choosing-a-tool) onto shell scripts, cron, and git branches.++| Primitive | Aider mapping |+|-----------|---------------|+| Scheduling | Run one-shot scripted sessions from cron/systemd/GitHub Actions with `aider --message` or `aider --message-file`, or use `--watch-files` for comment-triggered work. |+| Skills | Load loop instructions as read-only context with `--read templates/SKILL.md.loop-triage` or a project-specific conventions file. |+| State | Keep `STATE.md` at the repo root and pass it as the editable file for triage loops; use pattern-specific state files such as `pr-babysitter-state.md` for specialized loops. |+| Maker/checker split | Run the implementer in one Aider session/branch, then run a second read-only reviewer session over `git diff` or `diff.patch` before any commit/PR. |+| Connectors | Prefer CLI tools or MCP sidecars called from scripts; keep credentials out of prompts and state files. |++Week-one Daily Triage command (report-only, state updates only):++```bash+aider STATE.md \+ --read templates/SKILL.md.loop-triage \+ --no-auto-commits \+ --no-dirty-commits \+ --message "Run loop-triage. Update STATE.md with High Priority and Watch List only. Do not edit source code in week one."+```++Verifier pass for later L2 work:++```bash+git diff > diff.patch+aider --read diff.patch --read STATE.md \+ --no-auto-commits \+ --no-dirty-commits \+ --message "Act as loop-verifier. Review the diff against STATE.md goals. Report PASS/FAIL and do not edit files."+```++Transfer recipe: copy the tool-agnostic `SKILL.md` + state schema from this repo; map scheduling to cron, systemd, or CI until Aider is wrapped by a richer loop scheduler.