Many fixes to Mentor, Query RAG, etc

agents/prompts/roles/cell_pm.md

@@ -30,7 +30,31 @@ Claim → read full description → plan breakdown → start → journal decisio
 Create session for YOUR task with `roboco_session_create_for_tasks()`. Subtasks inherit it automatically.
 
 ### 4. SUBTASKS
-Create with `roboco_task_create()`. MUST have `parent_task_id` and `assigned_to` YOUR cell's dev (be-dev-1, be-dev-2, etc.).
+
+**CRITICAL: Always set `parent_task_id` to YOUR task ID.** Without this, you create orphan tasks, not subtasks.
+
+```python
+# Get YOUR task ID first
+my_task = roboco_task_get(task_id)
+
+# Create SUBTASK with parent_task_id
+roboco_task_create(
+    title="Implement user auth endpoint",
+    parent_task_id=my_task["id"],  # REQUIRED - links to your task
+    assigned_to="be-dev-1",  # USE SLUG
+    ...
+)
+```
+
+**Your cell's agent slugs:**
+- Backend: `be-dev-1`, `be-dev-2`, `be-qa`, `be-doc`
+- Frontend: `fe-dev-1`, `fe-dev-2`, `fe-qa`, `fe-doc`
+- UX/UI: `ux-dev-1`, `ux-dev-2`, `ux-qa`, `ux-doc`
+
+**Without `parent_task_id`:**
+- Task becomes a sibling (wrong!)
+- Completion tracking breaks
+- Your task can't complete
 
 ### 5. CREATE BRANCH (Git Tasks)
 **For tasks with `requires_git=True`:**

agents/prompts/roles/main_pm.md

@@ -41,7 +41,31 @@ roboco_git_create_branch(project_slug, task_id, branch_type, "main")
 Use `roboco_group_create()` in each relevant cell channel. Cell PMs need groups to create sessions.
 
 ### 5. CREATE CELL TASKS
-Use `roboco_task_create()` with `parent_task_id`, `team`, and `assigned_to` Cell PM (be-pm, fe-pm, ux-pm).
+
+**CRITICAL: Always set `parent_task_id` to YOUR task ID.** Without this, you create orphan tasks, not subtasks.
+
+```python
+# Get YOUR task ID first
+my_task = roboco_task_get(task_id)
+
+# Create SUBTASK with parent_task_id
+roboco_task_create(
+    title="Backend: Implement feature X",
+    parent_task_id=my_task["id"],  # REQUIRED - links to your task
+    team="backend",
+    assigned_to="be-pm",  # USE SLUG
+    ...
+)
+```
+
+**Agent slugs:**
+- `be-pm`, `fe-pm`, `ux-pm` - Cell PMs
+
+**Without `parent_task_id`:**
+- Task becomes a sibling (wrong!)
+- Completion tracking breaks
+- Your task can't complete
+
 - Set `project_id` and `branch_name` for git tasks
 - Cell PMs will create subtask branches from your parent branch