Many fixes to Mentor, Query RAG, etc

docs/rag/workflows/escalation.md

@@ -73,6 +73,9 @@ Requirements:
 - Task must be in `awaiting_pm_review`
 - PR must exist (for git tasks)
 - Only PMs can do this
+- **PARENT TASKS ONLY** - Subtasks cannot be escalated to CEO
+
+If you need to escalate a subtask, escalate the parent task instead. The CEO reviews the complete feature, not individual components.
 
 ## Good Escalation Format
 

docs/rag/workflows/kb-search.md

@@ -1,12 +1,24 @@
 # Knowledge Base Search
 
+**ALL agents have access to KB/RAG tools.** These are automatically available.
+
+## Recommended: Ask Mentor
+
+For most questions, use `roboco_ask_mentor`:
+
+```python
+roboco_ask_mentor(question="How do I handle authentication?")
+```
+
+It searches ALL knowledge sources and supports follow-up questions.
+
 ## Search Types
 
-| Tool | Purpose |
-|------|---------|
-| `roboco_kb_search` | Semantic search across indexes |
-| `roboco_rag_query` | AI-synthesized answer |
-| `roboco_ask_mentor` | Conversational help |
+| Tool | Purpose | Best For |
+|------|---------|----------|
+| `roboco_ask_mentor` | Conversational help | **Most questions** |
+| `roboco_kb_search` | Semantic search | Browsing, exploration |
+| `roboco_rag_query` | AI-synthesized answer | Quick answers |
 
 ## Semantic Search
 

docs/rag/workflows/qa-review.md

@@ -85,4 +85,9 @@ roboco_journal_reflect({
 
 QA CANNOT review tasks they originally developed.
 
-System tracks `original_developer` in `quick_context`. If QA == original_developer, claim is FORBIDDEN.
+System tracks `original_developer` in `quick_context`. If QA == original_developer:
+- **Claim**: FORBIDDEN
+- **Pass**: FORBIDDEN
+- **Fail**: FORBIDDEN
+
+This applies to ALL QA actions on the task, not just claiming. The system enforces this at both the API and MCP tool level.

docs/rag/workflows/task-states.md

@@ -62,8 +62,17 @@ backlog → pending (via roboco_task_activate)
 | `awaiting_qa → needs_revision` | qa only |
 | `awaiting_documentation → awaiting_pm_review` | documenter only |
 | `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 |
+| `awaiting_ceo_approval → needs_revision` | ceo only |
 | `any → cancelled` | cell_pm, main_pm |
 
+## CEO Approval Notes
+
+- Only **parent tasks** (no `parent_task_id`) can be escalated to CEO
+- Subtasks are completed by their Cell PM, not the CEO
+- The CEO reviews the complete feature via the parent task
+
 ## Checking State
 
 ```python