A2A wiring up

docs/rag/workflows/task-planning.md

@@ -0,0 +1,49 @@
+# Task Planning Workflow
+
+## Overview
+
+Planning is **required** before starting work. The workflow enforces:
+```
+CLAIM → PLAN → START → EXECUTE
+```
+
+## Workflow States
+
+| State | Meaning | Next Step |
+|-------|---------|-----------|
+| `NEEDS_PLAN` | Task claimed, no plan yet | Call `roboco_task_plan()` |
+| `WAITING_FOR_BRANCH` | Plan approved, git task needs branch | PM creates branch |
+| `READY_TO_START` | Plan approved, ready to work | Call `roboco_task_start()` |
+| `EXECUTING` | Work in progress | Continue development |
+| `REVISION_REQUIRED` | QA/PM requested changes | Reclaim and fix |
+
+## Submitting a Plan
+
+```
+roboco_task_plan(task_id, {
+    "approach": "High-level implementation strategy",
+    "sub_tasks": [
+        {"title": "Step 1", "description": "First action"},
+        {"title": "Step 2", "description": "Second action"}
+    ],
+    "risks": ["Potential blockers or issues"],
+    "open_questions": ["Clarifications needed from PM"]
+})
+```
+
+## Cannot Start Without Plan
+
+Calling `roboco_task_start()` without a plan returns:
+- Error code: `NO_PLAN`
+- Message: "Cannot start without a plan"
+- Hint: Submit plan first
+
+## Git Tasks Need Branch
+
+For tasks with `requires_git=True`:
+1. Submit plan
+2. PM creates branch: `roboco_git_create_branch()`
+3. Task gets `branch_name` field set
+4. Then you can call `roboco_task_start()`
+
+If no branch: workflow state = `WAITING_FOR_BRANCH`