@@ -177,6 +177,41 @@ This project uses Beads (bd) for issue tracking. See the MCP resource `beads://q
177177- ` in_progress ` → Actively working on task (SET THIS WHEN YOU START!)
178178- ` closed ` → Task complete, tested, and merged
179179
180+ ### Human Review Required Label
181+
182+ ** IMPORTANT: Beads labeled ` needs-human-review ` require human approval before AI work begins.**
183+
184+ ** AI Behavior:**
185+ - Before starting work on any bead, check for the ` needs-human-review ` label
186+ - If present, ** DO NOT start work** on the bead
187+ - Instead, ask the human to review the bead description and approach
188+ - Once human reviews and approves, they will remove the ` needs-human-review ` label
189+ - Only after label is removed may AI proceed with implementation
190+
191+ ** Example workflow:**
192+ ```
193+ AI: "I see bead mcp-xyz is ready to work on, but it has the 'needs-human-review' label.
194+ Please review the bead description and let me know if the approach looks good.
195+ Once approved, remove the label and I'll proceed with implementation."
196+ ```
197+
198+ ### Human Review Label Workflow
199+
200+ ** When a human reviews a bead with the ` needs-human-review ` label:**
201+
202+ 1 . ** Review the bead description** - Evaluate the proposed approach, implementation details, and any concerns
203+ 2 . ** Update the bead** - If changes are needed based on review, update the bead description with the approved approach
204+ 3 . ** Update labels:**
205+ ``` bash
206+ bd label remove < bead-id> needs-human-review
207+ bd label add < bead-id> human-reviewed
208+ ```
209+ 4 . ** Proceed to next bead** - Continue reviewing remaining beads with ` needs-human-review ` label
210+
211+ ** Label meanings:**
212+ - ` needs-human-review ` - Bead requires human approval before AI can start work
213+ - ` human-reviewed ` - Bead has been reviewed and approved by human, AI may proceed when ready
214+
180215### AI Model Labeling
181216
182217** When a bead is worked on by an AI system, label it to track which model performed the work:**
0 commit comments