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: housekeeping STATE after docs batch 2026-07-23 (#363)
Cobus Greylingfd90e4d9d1c8
diff --git a/STATE.md b/STATE.mdindex 5266f65..13b8f4b 100644--- a/STATE.md+++ b/STATE.md@@ -1,22 +1,37 @@# Loop State — loop-engineering reference-Last run: 2026-07-23T08:48:16Z (automated daily-triage workflow)+Last run: 2026-07-23T10:05:00Z (PR housekeeping)## 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).-+- Review open tooling PRs (human gate — touch `tools/loop-audit` / MCP):+ - [#362](https://github.com/cobusgreyling/loop-engineering/pull/362) — CI temp-file isolation (low risk; CI green)+ - [#358](https://github.com/cobusgreyling/loop-engineering/pull/358) — `loop-audit --auto-fix`+ - [#359](https://github.com/cobusgreyling/loop-engineering/pull/359) — memory-engineering bridge (overlaps #358; 14 files)+ - [#360](https://github.com/cobusgreyling/loop-engineering/pull/360) — expose loop-audit + circuit breaker over MCP## Watch List- Expand contributor failure stories (dependency sweeper, multi-loop).- Collect a production story for Post-Merge Cleanup.- Validate `loop-init` scaffolds on fresh projects across all patterns.+- Remaining docs GFIs: #224 (Cursor Issue Triage), #195 (Roo Code appendix), #173/#119/#118 (stories), #120 (adopters).++## Housekeeping (2026-07-23)++- Merged docs batch (CI green, no review threads):+ - [#355](https://github.com/cobusgreyling/loop-engineering/pull/355) — Cline appendix → closes GFI #147 when issue closed by maintainer+ - [#356](https://github.com/cobusgreyling/loop-engineering/pull/356) — Cursor CI Sweeper example → GFI #220+ - [#357](https://github.com/cobusgreyling/loop-engineering/pull/357) — Cursor Changelog Drafter example → GFI #223+- Cleared stale pr-babysit watch entries (#344 closed, #348 closed, #350 merged).+- Left tooling PRs for human review (denylist: `tools/loop-audit/src/`, large surface on #359).+- **Did not auto-close** linked GFI issues #147 / #220 / #223 — close after you confirm the landed docs.## Recent Noise (ignored this run)-—+- StackMap #300, Pluribus #262, loop.js #246 (external / non-blocking).----Run log: Updated by `.github/workflows/daily-triage.yml`. See `LOOP.md` for cadence and gates.+Run log: Updated by `.github/workflows/daily-triage.yml` and manual PR housekeeping. See `LOOP.md` for cadence and gates.diff --git a/loop-run-log.md b/loop-run-log.mdindex ba0085f..3963508 100644--- a/loop-run-log.md+++ b/loop-run-log.md@@ -49,3 +49,4 @@ Append one entry per run. Prune entries older than 30 days.{"run_id":"2026-07-22T12:48:31Z","pattern":"scheduled-maintenance","duration_s":900,"items_found":4,"actions_taken":4,"escalations":1,"tokens_estimate":40000,"readiness_score":100,"outcome":"acting","note":"bump loop-cost 1.2.0 + loop-context 1.5.0; refresh RELEASE_NOTES checklist; rewrite STATE after #350/#351; supersede #348; tags after merge"}{"run_id":"2026-07-22T12:52:20Z","pattern":"scheduled-maintenance","duration_s":300,"items_found":1,"actions_taken":2,"escalations":0,"tokens_estimate":15000,"readiness_score":100,"outcome":"report-only","note":"confirmed npm loop-cost 1.2.0 + loop-context 1.5.0; STATE open-PR queue empty; #348 closed"}{"run_id":"2026-07-23T08:48:16Z","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":"29992416287"}+{"run_id":"2026-07-23T10:05:00Z","pattern":"pr-housekeeping","duration_s":420,"items_found":7,"actions_taken":3,"escalations":0,"tokens_estimate":80000,"readiness_score":100,"outcome":"fix-proposed","merged":[355,356,357],"open_remaining":[362,360,359,358],"notes":"docs batch merged; tooling left for human review"}