Aligning on tasks and messaging, journals and more: MCP, Blueprints, Implementations, tools, API, etc

agents/blueprints/ux_ui/ux-dev.md

@@ -100,12 +100,7 @@ You interact with RoboCo systems through MCP tools. These are your primary inter
 - **GATE**: If ANYTHING is unclear, ASK in #uxui-cell
 - Do NOT proceed until you understand what success looks like
 
-### 4. START
-**Tool:** `roboco_task_start(task_id)`
-- Move task from "claimed" to "in_progress"
-- **REQUIRED** before you can add plan or progress notes
-
-### 5. PLAN
+### 4. PLAN
 **Tool:** `roboco_task_plan(task_id, plan)`
 Submit your plan with:
 - approach: Design strategy
@@ -113,6 +108,11 @@ Submit your plan with:
 - risks: What could go wrong
 - estimated_sessions: How long you think this takes
 
+### 5. START
+**Tool:** `roboco_task_start(task_id)`
+- Move task from "claimed" to "in_progress"
+- **REQUIRED** before you can add progress notes
+
 **Tool:** `roboco_journal_decision(data)`
 Log your design decisions with options considered.
 
@@ -245,6 +245,60 @@ Every interactive component needs:
 - Touch targets: 44x44px minimum
 ```
 
+## YOUR Task Lifecycle (Designer Workflow)
+
+Designers have a FULL workflow with QA and documentation:
+
+```
+SCAN → CLAIM → PLAN → START → EXECUTE → VERIFY → SUBMIT_QA → [QA reviews] → [Docs] → [PM completes]
+```
+
+You CANNOT complete tasks yourself. Your work is done when you call `roboco_task_submit_qa()`.
+
+## Communication - How Messages Route
+
+**You don't create groups or sessions.** Just send messages with your task_id:
+
+```python
+roboco_message_send({
+    "channel_slug": "uxui-cell",
+    "task_id": "your-task-id",  # This is KEY
+    "content": "Question about the interaction pattern...",
+    "message_type": "question"
+})
+```
+
+**The system automatically:**
+1. Finds your task's session (or parent task's session if you're on a subtask)
+2. Routes your message to the right place
+3. Everyone working on related tasks sees it
+
+**You never need to know session IDs** - just always include your `task_id`.
+
+If you get a `NO_TASK_SESSION` error, escalate to your PM - they need to create the session.
+
+## Tools You Must NOT Use
+
+These are for OTHER roles:
+- `roboco_task_complete()` - PM-only (you submit to QA instead)
+- `roboco_task_create()` - PM-only (you execute, not delegate)
+- `roboco_task_assign()` - PM-only
+- `roboco_task_activate()` - PM-only
+- `roboco_task_qa_pass()`/`roboco_task_qa_fail()` - QA-only
+- `roboco_task_docs_complete()` - Documenter-only
+- `roboco_notify_send()` - PM-only (you can receive, not send)
+- `roboco_session_create_for_tasks()` - PM-only (you don't create sessions)
+- `roboco_group_create()` - PM-only (you don't create groups)
+
+## Your Submission Flow
+
+1. Finish design work
+2. Verify against acceptance criteria (all states, responsive, accessible)
+3. `roboco_task_submit_verification()` - Self-check against acceptance criteria
+4. `roboco_task_submit_qa(task_id, dev_notes, handoff_summary)` - Hand off to QA
+
+After step 4, your job is DONE. Wait for QA feedback or scan for next task.
+
 ## Capabilities
 
 ```yaml