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
chore: scheduled maintenance — Jul 16 housekeeping (#293)
Cobus Greyling8fb67f1b2118
diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.mdindex f984af5..850cbab 100644--- a/CONTRIBUTORS.md+++ b/CONTRIBUTORS.md@@ -2,18 +2,27 @@Thank you to everyone who shipped docs, stories, examples, and tool fixes.-*Generated 2026-07-07 via `node scripts/generate-contributors.mjs` — re-run after merges.*+*Generated 2026-07-16 via `node scripts/generate-contributors.mjs` — re-run after merges.*| Contributor | Highlights ||-------------|------------|-| [@KhaiTrang1995](https://github.com/KhaiTrang1995) | #190 feat(loop-worktree): manage isolated git worktrees per fix attempt<br>#165 feat(loop-guard): size the token budget from loop-cost per pattern |-| [@k-anushka14](https://github.com/k-anushka14) | #185 Docs/add aider to examples index<br>#183 Docs/opencode constraints example |+| [@KhaiTrang1995](https://github.com/KhaiTrang1995) | #274 feat(loop-worktree): add advisory path locking to prevent multi-loop collisions<br>#273 feat(loop-context): track daily token spend across runs, add --on-exceed hook |+| [@k-anushka14](https://github.com/k-anushka14) | #249 Add Codeium (Windsurf) appendix to primitives matrix (#228)<br>#248 Add loop-init validation checklist (#231) |+| [@Mahizhan-S](https://github.com/Mahizhan-S) | #251 docs: added Cursor Dependency Sweeper example #222<br>#217 docs: add npx quickstart for MCP server (#201) || [@50thycal](https://github.com/50thycal) | story: `quant-loop-out-of-time.md`<br>story: `quant-loop-the-verifier-problem.md` |+| [@AIMindCrafter](https://github.com/AIMindCrafter) | #268 feat: add post-merge cleanup example for Cursor and update documentat…<br>#257 docs: add dependency-vs-ci-sweeper-collision failure story #230 |+| [@roian6](https://github.com/roian6) | #208 docs: add Windsurf PR Babysitter example<br>#127 docs: expand Aider primitives appendix || [@neerajdad123-byte](https://github.com/neerajdad123-byte) | 3 commits || [@sololys](https://github.com/sololys) | story: `ky-cut-surface-generation-vs-consequence.md` || [@ulises-jeremias](https://github.com/ulises-jeremias) | #98 docs(examples): add opencode tool coverage |+| [@a-yeyang](https://github.com/a-yeyang) | #263 docs: add loop-sync subsection to QUICKSTART |+| [@Angriff36](https://github.com/Angriff36) | #267 fix: remove markdown cruft from changelog-drafter.yml example |+| [@cevheri](https://github.com/cevheri) | #252 docs: cross-link Open-Spek as a related, differently-scoped project |+| [@CooperSheroy](https://github.com/CooperSheroy) | #259 docs: sync loop-init version references |+| [@DavidReque](https://github.com/DavidReque) | #234 docs(stories): add CI Sweeper failure story || [@jiaobotao](https://github.com/jiaobotao) | #141 Add Hermes Agent example (daily-triage) + primitives matrix column |-| [@roian6](https://github.com/roian6) | #127 docs: expand Aider primitives appendix |+| [@KevinGuo1007](https://github.com/KevinGuo1007) | #206 docs: add Zed appendix to primitives matrix |+| [@lorenzobosio](https://github.com/lorenzobosio) | #247 docs(examples): add Hermes PR Babysitter example || [@Zhang-986](https://github.com/Zhang-986) | #138 fix(loop-sync): honor json output flag |## Your first PRdiff --git a/LOOP.md b/LOOP.mdindex f80050a..b84a086 100644--- a/LOOP.md+++ b/LOOP.md@@ -9,7 +9,7 @@ The goal of this repo is to be the canonical, copyable, high-signal collection o### Daily Triage (L1 — automated + report)- Cadence: 1d weekdays (`/.github/workflows/daily-triage.yml`)- Skill: `loop-triage` (from `skills/` and `starters/minimal-loop`)-- State: `STATE.md` (updated by workflow; human reviews weekly issue)+- State: STATE.md (updated by workflow; human reviews weekly issue)- Phase: Report-only. Human reviews and decides actions.- Handoff: Design decisions, large refactors, new pattern acceptance.diff --git a/STATE.md b/STATE.mdindex 0ffd96e..a01bd2f 100644--- a/STATE.md+++ b/STATE.md@@ -5,7 +5,7 @@ Last run: 2026-07-15T09:44:51Z (automated daily-triage workflow)## High Priority (loop is acting or waiting on human)- Maintain loop readiness score ≥ 58 (current: **100**, level **L3**).-- Keep npm packages current after tool changes (tag `loop-audit-v*`, `loop-init-v*`, `loop-cost-v*` — see docs/RELEASE.md).+- Keep npm packages current after tool changes (tag `loop-audit-v*`, `loop-init-v*`, `loop-cost-v*`, `loop-context-v*`, `loop-worktree-v*` — see docs/RELEASE.md). **Pending publish:** `loop-context` 1.2.0, `loop-worktree` 1.1.0 (merged #273, #274).## Watch Listdiff --git a/loop-run-log.md b/loop-run-log.mdindex 5cd25c3..f4e349a 100644--- a/loop-run-log.md+++ b/loop-run-log.md@@ -21,7 +21,6 @@ Append one entry per run. Prune entries older than 30 days.<!-- Loop appends below this line -->-{"run_id":"2026-06-15T13:42:57Z","pattern":"daily-triage","duration_s":5,"items_found":1,"actions_taken":1,"escalations":0,"tokens_estimate":52000,"readiness_score":100,"outcome":"report-only","workflow_run":"27550503677"}{"run_id":"2026-06-16T12:43:13Z","pattern":"daily-triage","duration_s":10,"items_found":1,"actions_taken":1,"escalations":0,"tokens_estimate":52000,"readiness_score":100,"outcome":"report-only","workflow_run":"27618341632"}{"run_id":"2026-06-17T12:08:32Z","pattern":"daily-triage","duration_s":12,"items_found":1,"actions_taken":1,"escalations":0,"tokens_estimate":52000,"readiness_score":100,"outcome":"report-only","workflow_run":"27687793882"}{"run_id":"2026-06-18T11:41:06Z","pattern":"daily-triage","duration_s":8,"items_found":2,"actions_taken":1,"escalations":1,"tokens_estimate":52000,"readiness_score":100,"outcome":"escalated","workflow_run":"27756924361"}