Skip to content

Commit 231af38

Browse files
docs: expand Aider primitives appendix (#127)
docs: expand Aider primitives appendix
2 parents f18df04 + 635bd80 commit 231af38

1 file changed

Lines changed: 33 additions & 3 deletions

File tree

docs/primitives-matrix.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,36 @@ Transfer recipes map the same loop shape onto each host:
102102
| 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 |
103103
| 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 |
104104

105-
**Aider** (CLI-only): use `--watch` or scripted sessions; state in `STATE.md`; reviewer = second terminal session.
106-
107-
Transfer recipe: copy the tool-agnostic `SKILL.md` + state schema from this repo; map scheduling to your editor's automation surface.
105+
## Appendix: Aider CLI
106+
107+
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.
108+
109+
| Primitive | Aider mapping |
110+
|-----------|---------------|
111+
| 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. |
112+
| Skills | Load loop instructions as read-only context with `--read templates/SKILL.md.loop-triage` or a project-specific conventions file. |
113+
| 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. |
114+
| 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. |
115+
| Connectors | Prefer CLI tools or MCP sidecars called from scripts; keep credentials out of prompts and state files. |
116+
117+
Week-one Daily Triage command (report-only, state updates only):
118+
119+
```bash
120+
aider STATE.md \
121+
--read templates/SKILL.md.loop-triage \
122+
--no-auto-commits \
123+
--no-dirty-commits \
124+
--message "Run loop-triage. Update STATE.md with High Priority and Watch List only. Do not edit source code in week one."
125+
```
126+
127+
Verifier pass for later L2 work:
128+
129+
```bash
130+
git diff > diff.patch
131+
aider --read diff.patch --read STATE.md \
132+
--no-auto-commits \
133+
--no-dirty-commits \
134+
--message "Act as loop-verifier. Review the diff against STATE.md goals. Report PASS/FAIL and do not edit files."
135+
```
136+
137+
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.

0 commit comments

Comments
 (0)