update and restore

Author: joelhooks

.beads/issues.jsonl

@@ -129,6 +129,9 @@ The `opencode-swarm-plugin` provides type-safe, context-preserving wrappers. Alw
 
 ### Other Custom Tools
 
+- **swarm_review, swarm_review_feedback** - Coordinator reviews worker output (3-strike rule)
+
+
 - **typecheck** - TypeScript check with grouped errors
 - **git-context** - Branch, status, commits, ahead/behind in one call
 - **find-exports** - Find where symbols are exported
@@ -1210,3 +1213,61 @@ ubs_doctor(fix=true)
 - Scope to changed files: `ubs_scan(path="src/file.ts")` (< 1s)
 - Full scan is slow: `ubs_scan(path=".")` (30s+)
 - Use `--staged` or `--diff` for incremental checks
+
+## Swarm Coordinator Checklist (MANDATORY)
+
+When coordinating a swarm, you MUST monitor workers and review their output.
+
+### Monitor Loop
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                 COORDINATOR MONITOR LOOP                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  1. CHECK INBOX                                             │
+│     swarmmail_inbox()                                       │
+│     swarmmail_read_message(message_id=N)                    │
+│                                                             │
+│  2. CHECK STATUS                                            │
+│     swarm_status(epic_id, project_key)                      │
+│                                                             │
+│  3. REVIEW COMPLETED WORK                                   │
+│     swarm_review(project_key, epic_id, task_id, files)      │
+│     → Generates review prompt with epic context + diff      │
+│                                                             │
+│  4. SEND FEEDBACK                                           │
+│     swarm_review_feedback(                                  │
+│       project_key, task_id, worker_id,                      │
+│       status="approved|needs_changes",                      │
+│       issues="[{file, line, issue, suggestion}]"            │
+│     )                                                       │
+│                                                             │
+│  5. INTERVENE IF NEEDED                                     │
+│     - Blocked >5min → unblock or reassign                   │
+│     - File conflicts → mediate                              │
+│     - Scope creep → approve or reject                       │
+│     - 3 review failures → escalate to human                 │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Review Tools
+
+| Tool | Purpose |
+|------|---------|
+| `swarm_review` | Generate review prompt with epic context, dependencies, and git diff |
+| `swarm_review_feedback` | Send approval/rejection to worker (tracks 3-strike rule) |
+
+### Review Criteria
+
+- Does work fulfill subtask requirements?
+- Does it serve the overall epic goal?
+- Does it enable downstream tasks?
+- Type safety, no obvious bugs?
+
+### 3-Strike Rule
+
+After 3 review rejections, task is marked **blocked**. This signals an architectural problem, not "try harder."
+
+**NEVER skip the review step.** Workers complete faster when they get feedback.