Skip to content

Commit 7c47059

Browse files
committed
Update CLAUDE.md with research notes
1 parent fb038c4 commit 7c47059

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
@@ -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

Comments
 (0)