General fixes mainly around git integration into task lifecycle

docs/rag/troubleshooting/blocked-tools.md

@@ -44,13 +44,14 @@
 
 See: `roboco_kb_search("task planning workflow")`
 
-## WAITING_FOR_BRANCH
+## Parent Branch Required
 
-**Symptom:** Can't start git task, state is WAITING_FOR_BRANCH
+**Symptom:** Can't claim subtask, error "Parent task must be claimed first"
 
-**Cause:** PM hasn't created the branch yet
+**Cause:** Parent task hasn't been claimed yet, so it has no branch
 
 **Solution:**
-1. Message PM to create branch
-2. Or escalate: `roboco_task_escalate(task_id, "Need branch")`
-3. Wait for branch_name to be set on task
+1. Parent task must be claimed first (branch auto-creates on claim)
+2. Then subtask can be claimed (its branch forks from parent's)
+
+Note: Branches are auto-created hierarchically. No manual creation needed.

docs/rag/troubleshooting/task-errors.md

@@ -27,14 +27,14 @@
 
 **Causes**:
 1. Task not claimed by you
-2. For git tasks: branch not created yet
-3. Task in wrong status
+2. Task in wrong status
 
 **Solutions**:
 - Claim first: `roboco_task_claim(task_id)`
-- Wait for PM to create branch (git tasks)
 - Check current status
 
+Note: Git branches are auto-created on claim, no waiting needed.
+
 ## Cannot Submit for QA
 
 **Error**: "Invalid transition from current status"
@@ -74,16 +74,15 @@ parent_id = task.parent_task_id
 roboco_task_escalate_to_ceo(parent_id, notes="...")
 ```
 
-## Git Task: No Branch
+## Git Task: Parent Branch Required
 
-**Error**: "Branch name required for git tasks"
+**Error**: "Parent task must be claimed first to create its branch"
 
-**Cause**: PM hasn't created branch yet
+**Cause**: Trying to claim a subtask when parent task hasn't been claimed yet
 
-**Solution**: Wait for PM or ask PM to create branch:
-```python
-roboco_git_create_branch(project_slug, task_id, "feature")
-```
+**Solution**: Parent task must be claimed first. Branches are auto-created hierarchically:
+1. Parent is claimed → parent branch created
+2. Then subtask can be claimed → subtask branch created (forked from parent)
 
 ## Task Has Incomplete Subtasks