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