1 line
2.5 KiB
JSON
1 line
2.5 KiB
JSON
{"content": "---\nname: human-approval-loop\ndescription: Runs the task, then pauses and sends you approve / revise / skip before anything ships — human review as a first-class queue where the stop condition is your approval.\ncategory: evaluation\ninterval: on-demand\nstop-condition: You approve the result (it ships) or skip/redirect it — nothing ships without explicit human approval.\ncomponents: [hook:quality-gates/plan-gate, hook:automation/telegram-notifications, command:git-workflow/create-pr]\ntags: [human-in-the-loop, approval, safety, loop]\n---\n\n# Human-in-the-Loop Approval Loop\n\n> **Loop Engineering** — same loop shape as the autonomous ones, but the stop condition is *your approval* instead of a passing test. The agent does the work, then waits at a gate: approve, revise, or skip.\n\n## 🎯 Goal\nRun the task, then **pause** and route the result to you for a decision before anything ships — treating human review as its own queue with clear actions.\n\n## ⏱️ Schedule\nTrigger: `on-demand` (each item pauses for your call before shipping).\n\n## ▶️ Run it\n```\n/loop run the next task, then pause and send me approve / revise / skip before anything ships. On approve, continue and ship. On revise, take my note and redo. On skip, move to the next item. Never ship without my approval.\n```\n\n## 🔁 Iteration steps\n1. **Act** — complete the task up to the point of shipping.\n2. **Gate** — the `plan-gate` hook halts before any irreversible/ship step.\n3. **Ask** — send approve / revise / skip via `telegram-notifications`.\n4. **Branch** — approve → ship (e.g. `/create-pr`); revise → apply note and redo; skip → next item.\n5. **Observe** — record the decision; nothing ships unattended.\n\n## 🛑 Stopping condition\nYou approve (ship) or skip/redirect — the loop never ships without an explicit human decision.\n\n## 💰 Budget & guardrails\nThe gate is the safety: irreversible actions wait for a human. Add a reminder/deadline so pending items don't pile up silently, and a budget for the work done before each gate.\n\n## 🧩 Referenced components\n- `hook:quality-gates/plan-gate` — halts before irreversible/ship steps.\n- `hook:automation/telegram-notifications` — sends the approve/revise/skip prompt.\n- `command:git-workflow/create-pr` — the ship action on approval.\n\n## 💡 Example\nThe agent drafts a refund-policy change, pauses, and pings you on Telegram. You hit \"revise\" with a note; it redoes the draft and pings again — and only ships after you approve.\n"} |