Skip to content

Commit cb49709

Browse files
committed
Update CLAUDE.md with research notes
1 parent 04f1bcf commit cb49709

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

CLAUDE.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)