Added git workflow + fixing some issues

docs/rag/architecture/config-reference.md

@@ -58,7 +58,7 @@ Environment variables for RoboCo (prefix: `ROBOCO_`).
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `ROBOCO_LOCAL_LLM_MODEL` | `glm-4.7:cloud` | Local LLM for RAG |
+| `ROBOCO_LOCAL_LLM_MODEL` | `glm-5.1:cloud` | Local LLM for RAG |
 | `ROBOCO_LOCAL_LLM_BASE_URL` | `http://roboco-ollama:11434/v1` | OpenAI-compat API |
 | `ROBOCO_OLLAMA_BASE_URL` | `http://roboco-ollama:11434` | Native Ollama API |
 

docs/rag/architecture/escalation-chain.md

@@ -62,7 +62,7 @@ roboco_task_escalate_to_ceo(
 
 Requirements:
 - Task in `awaiting_pm_review`
-- PR exists (for git tasks)
+- PR exists
 - Only PMs can call this
 
 ## Cannot Skip Levels

docs/rag/architecture/task-model.md

@@ -27,8 +27,7 @@
 
 | Field | Description |
 |-------|-------------|
-| `requires_git` | Whether git workflow applies |
-| `project_id` | Associated project |
+| `project_id` | Associated project (required) |
 | `branch_name` | Git branch for task |
 | `work_session_id` | Active work session |
 | `pr_number` | PR number |

docs/rag/roles/cell-pm.md

@@ -14,7 +14,7 @@
 3. Assign work to cell members
 4. Complete tasks after full workflow
 5. Handle escalations from cell
-6. Review and merge PRs for git tasks
+6. Review and merge PRs
 
 ## What You CAN Do
 
@@ -58,9 +58,9 @@ roboco_notify_send({
 })
 ```
 
-## Git Tasks
+## Git Workflow
 
-For tasks with `requires_git=True`:
+All tasks follow the git workflow:
 
 **Branches are auto-created when tasks are claimed:**
 - When you claim your task: `feature/team/MAIN_PM_ID/YOUR_ID`
@@ -138,7 +138,7 @@ Create tasks with project selection:
 roboco_task_create(
     title="Backend task",
     team="backend",
-    project_slug="roboco"  # Required for git tasks
+    project_slug="roboco"  # Required
 )
 ```
 

docs/rag/roles/main-pm.md

@@ -132,7 +132,7 @@ Create tasks with project:
 roboco_task_create(
     title="Backend task",
     team="backend",
-    project_slug="roboco"  # Required for git tasks
+    project_slug="roboco"  # Required
 )
 ```
 

docs/rag/tools/project-tools.md

@@ -99,14 +99,13 @@ Lists all agent workspaces for a project. Cell PM sees own cell only.
 
 ## Task Creation with Project
 
-When creating git-enabled tasks:
+When creating tasks:
 
 ```python
 roboco_task_create(
     title="Add rate limiting",
     team="backend",
-    project_slug="roboco",    # Required for git tasks
-    requires_git=True         # Default: True
+    project_slug="roboco",    # Required - all tasks follow git workflow
 )
 ```
 

docs/rag/tools/task-tools.md

@@ -7,6 +7,7 @@
 | `roboco_task_get` | Get task details |
 | `roboco_task_scan` | Find available tasks |
 | `roboco_task_claim` | Take ownership |
+| `roboco_task_unclaim` | Release claimed task |
 | `roboco_task_start` | Begin work |
 
 ## Task Retrieval
@@ -28,6 +29,10 @@ tasks = roboco_task_scan(
 # Claim task
 roboco_task_claim(task_id)
 
+# Release if you shouldn't work on it
+roboco_task_unclaim(task_id)
+roboco_task_unclaim(task_id, hand_off_to="be-dev-2")
+
 # Start work (also resumes paused tasks)
 roboco_task_start(task_id)
 

docs/rag/troubleshooting/common-issues.md

@@ -28,7 +28,7 @@
 3. Invalid transition attempted
 
 **Check**:
-- For git tasks: branch exists?
+- Branch exists?
 - For `awaiting_pm_review`: both `docs_complete` AND `pr_created`?
 - Is transition valid from current status?
 

docs/rag/workflows/escalation.md

@@ -71,7 +71,7 @@ roboco_task_escalate_to_ceo(
 
 Requirements:
 - Task must be in `awaiting_pm_review`
-- PR must exist (for git tasks)
+- PR must exist
 - Only PMs can do this
 - **PARENT TASKS ONLY** - Subtasks cannot be escalated to CEO
 

docs/rag/workflows/task-claiming.md

@@ -41,7 +41,35 @@ roboco_task_claim(task_id)
 - **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
+- **Branch requirement**: Branch auto-created on claim
+
+## Releasing a Claimed Task
+
+If you claimed a task but realize you shouldn't work on it, use `unclaim`:
+
+```python
+# Release back to pool
+roboco_task_unclaim(task_id)
+
+# Hand off to specific agent
+roboco_task_unclaim(task_id, hand_off_to="be-dev-2")
+
+# Result:
+# - status: pending
+# - assigned_to: None (or hand_off_to agent)
+# - You can now claim new work
+```
+
+**When to use unclaim:**
+- Task is out of your team's scope
+- Task requires a different role
+- You need to prioritize other work
+- Better suited for another agent
+
+**Restrictions:**
+- Only works on `claimed` status (not yet started)
+- You must be the agent who claimed it
+- If task is `in_progress`, use `roboco_task_substitute` instead
 
 ## Status After Claim
 

docs/rag/workflows/task-planning.md

@@ -37,9 +37,9 @@ Calling `roboco_task_start()` without a plan returns:
 - Message: "Cannot start without a plan"
 - Hint: Submit plan first
 
-## Git Tasks
+## Git Workflow
 
-For tasks with `requires_git=True`:
+All tasks follow the git workflow:
 - **Branches are auto-created when you claim the task**
 - Root tasks: branch created from default branch (main/master)
 - Subtasks: branch forked from parent's branch

docs/rag/workflows/task-states.md

@@ -31,8 +31,8 @@
 ### Developer Flow
 ```
 pending → claimed → in_progress → verifying → awaiting_qa
-                         ↑                         ↓
-                         └── needs_revision ←──────┘
+     ↑        ↓           ↑                         ↓
+     └─ unclaim           └── needs_revision ←──────┘
 ```
 
 ### QA Flow
@@ -58,9 +58,10 @@ backlog → pending (via roboco_task_activate)
 | Transition | Allowed Roles |
 |------------|---------------|
 | `backlog → pending` | cell_pm, main_pm |
+| `claimed → pending` (unclaim) | assignee or PM |
 | `awaiting_qa → awaiting_documentation` | qa only |
 | `awaiting_qa → needs_revision` | qa only |
-| `awaiting_documentation → awaiting_pm_review` | documenter only |
+| `awaiting_documentation → awaiting_pm_review` | documenter, developer (parallel) |
 | `awaiting_pm_review → completed` | cell_pm, main_pm |
 | `awaiting_pm_review → awaiting_ceo_approval` | cell_pm, main_pm (parent tasks only) |
 | `awaiting_ceo_approval → completed` | ceo only |