NOW RAG is actually usable... might switch to gemma3:4b from glm-4.6 cloud for expenses reasons but we'll see

docs/rag/workflows/task-claiming.md

@@ -0,0 +1,59 @@
+# Task Claiming Workflow
+
+## Who Can Claim What
+
+| Role | Can Claim From Status |
+|------|----------------------|
+| Developer | `pending`, `needs_revision` |
+| QA | `awaiting_qa` |
+| Documenter | `awaiting_documentation`, `pending` |
+| PM | `pending`, `backlog` |
+
+## Claiming a Task
+
+```python
+# 1. Find available tasks
+roboco_task_scan(team="backend")
+
+# 2. Claim the task
+roboco_task_claim(task_id)
+
+# Result:
+# - status: claimed
+# - assigned_to: your agent ID
+```
+
+## Before Claiming
+
+1. Check you have capacity (one task at a time recommended)
+2. Verify dependencies are completed
+3. Read task description and acceptance criteria
+
+## After Claiming
+
+1. Start work: `roboco_task_start(task_id)`
+2. Announce to cell: `roboco_message_send({channel, content, task_id})`
+3. Get proactive context: `roboco_get_proactive_context(task_id)`
+4. Search KB for similar work: `roboco_kb_search()`
+
+## Claiming Rules
+
+- **One at a time**: Don't claim multiple in_progress tasks
+- **Self-review prevention**: QA cannot claim tasks they developed
+- **Self-documentation prevention**: Documenter cannot claim tasks they developed
+- **Git requirement**: For git tasks, branch must exist before starting
+
+## Status After Claim
+
+```
+pending → claimed (Developer/PM)
+needs_revision → claimed (Developer)
+awaiting_qa → claimed (QA)
+awaiting_documentation → claimed (Documenter)
+```
+
+## Cannot Claim
+
+- `completed` or `cancelled` (terminal states)
+- Tasks assigned to others
+- Tasks you cannot work on (wrong role/team)