wehub-resource-sync
1 line
2.5 KiB
JSON
1 line
2.5 KiB
JSON
{"content": "---\nname: five-minute-maintainer-loop\ndescription: Every few minutes while you work, makes one small verified repository improvement — a flaky test, a stale comment, a missing type — one change, one commit.\ncategory: engineering\ninterval: 5m\nstop-condition: You end the session, or there is no safe low-risk improvement left to make this pass.\ncomponents: [agent:development-team/test-runner, command:git-workflow/commit, hook:quality-gates/scope-guard]\ntags: [maintenance, hygiene, automation, loop]\n---\n\n# Five-Minute Maintainer Loop\n\n> **Loop Engineering** — the `/loop` verb repeats a task *while you are present*. This one does continuous, low-risk upkeep on a tight timer while you focus on the real work. Inspired by Peter Steinberger's five-minute maintainer.\n\n## 🎯 Goal\nEvery few minutes, make exactly **one** small, verified improvement to the repo — and let the agent decide *what* to clean. That judgment is the whole point; nothing is hardcoded.\n\n## ⏱️ Schedule\nSuggested interval: `5m` (runs while your session is open).\n\n## ▶️ Run it\n```\n/loop 5m \"Make one small, verified repository improvement: a flaky test, a stale comment, a missing type, a dead import. One change, one commit, tests green. Never touch anything risky or architectural. If nothing safe remains, say so and wait.\"\n```\n\n## 🔁 Iteration steps\n1. **Perceive** — scan for a small, low-risk improvement opportunity.\n2. **Reason** — confirm it is safe; the `scope-guard` hook blocks risky/out-of-scope edits.\n3. **Act** — make the single change.\n4. **Verify** — run the suite with `test-runner`; only proceed if green.\n5. **Observe** — commit with `/commit`; one change, one commit. Wait for the next tick.\n\n## 🛑 Stopping condition\nYou end the session, or there is no safe improvement left this pass (the loop idles rather than inventing risky work).\n\n## 💰 Budget & guardrails\nOne change per tick; never refactors or touches production-critical paths. Set a per-session token budget before walking away.\n\n## 🧩 Referenced components\n- `agent:development-team/test-runner` — verifies each change is green.\n- `command:git-workflow/commit` — one clean commit per improvement.\n- `hook:quality-gates/scope-guard` — blocks risky / out-of-scope edits.\n\n## 💡 Example\nWhile you build a feature, the loop quietly fixes a flaky timer test, removes a dead import, and adds a missing return type — three tiny green commits — without ever touching the feature you're working on.\n"} |