feat: resilient multi-channel messaging

plugins/genie/agents/engineer.md

@@ -51,7 +51,13 @@ After the implementation works:
 Run the validation command from the wish. Record output. Confirm each acceptance criterion is met.
 
 ## 7. Report Completion
-After completing all deliverables and validation, call `genie done <slug>#<group>` to report completion. The slug and group are in your initial prompt. This signals the orchestrator that your work is finished so it can advance to the next wave.
+After completing all deliverables and validation:
+1. Run validation commands from the wish
+2. Commit and push your work
+3. Call: `genie done <slug>#<group>` — marks the group complete in state (source of truth)
+4. Call: `genie send 'Group <N> complete. <summary>' --to team-lead` — sends durable notification
+
+The slug and group are in your initial prompt. Both commands are mandatory — state is how the orchestrator tracks progress, the message is how team-lead gets notified.
 </process>
 
 <success_criteria>

plugins/genie/agents/engineer/AGENTS.md

@@ -51,7 +51,13 @@ After the implementation works:
 Run the validation command from the wish. Record output. Confirm each acceptance criterion is met.
 
 ## 7. Report Completion
-After completing all deliverables and validation, call `genie done <slug>#<group>` to report completion. The slug and group are in your initial prompt. This signals the orchestrator that your work is finished so it can advance to the next wave.
+After completing all deliverables and validation:
+1. Run validation commands from the wish
+2. Commit and push your work
+3. Call: `genie done <slug>#<group>` — marks the group complete in state (source of truth)
+4. Call: `genie send 'Group <N> complete. <summary>' --to team-lead` — sends durable notification
+
+The slug and group are in your initial prompt. Both commands are mandatory — state is how the orchestrator tracks progress, the message is how team-lead gets notified.
 </process>
 
 <success_criteria>

plugins/genie/agents/fix.md

@@ -67,6 +67,13 @@ Report when complete:
 - Anything remaining or needing attention
 </done_report>
 
+<completion_reporting>
+On completion, report to team-lead via durable message:
+- Call: `genie send 'Fix applied — <summary>' --to team-lead`
+
+This is mandatory. The message is how team-lead gets notified that the fix is done.
+</completion_reporting>
+
 <constraints>
 - Minimal change surface — only affected files
 - Intermediate worker — execute the task and report back. The orchestrator makes the ship/no-ship decision.

plugins/genie/agents/fix/AGENTS.md

@@ -67,6 +67,13 @@ Report when complete:
 - Anything remaining or needing attention
 </done_report>
 
+<completion_reporting>
+On completion, report to team-lead via durable message:
+- Call: `genie send 'Fix applied — <summary>' --to team-lead`
+
+This is mandatory. The message is how team-lead gets notified that the fix is done.
+</completion_reporting>
+
 <constraints>
 - Minimal change surface — only affected files
 - Intermediate worker — execute the task and report back. The orchestrator makes the ship/no-ship decision.

plugins/genie/agents/qa.md

@@ -101,6 +101,13 @@ New Tests Written: [N] ([list files])
 ```
 </output_format>
 
+<completion_reporting>
+On completion, report your result to team-lead via durable message:
+- Call: `genie send '<PASS|FAIL> — <summary>' --to team-lead`
+
+This is mandatory. The message is how team-lead gets notified of your QA result.
+</completion_reporting>
+
 <constraints>
 - Evidence required for every verdict — no "it looks fine"
 - Never skip running tests

plugins/genie/agents/qa/AGENTS.md

@@ -101,6 +101,13 @@ New Tests Written: [N] ([list files])
 ```
 </output_format>
 
+<completion_reporting>
+On completion, report your result to team-lead via durable message:
+- Call: `genie send '<PASS|FAIL> — <summary>' --to team-lead`
+
+This is mandatory. The message is how team-lead gets notified of your QA result.
+</completion_reporting>
+
 <constraints>
 - Evidence required for every verdict — no "it looks fine"
 - Never skip running tests

plugins/genie/agents/reviewer.md

@@ -84,6 +84,13 @@ Validation: <PASS|FAIL with output>
 ```
 </output_format>
 
+<completion_reporting>
+On completion, report your verdict to team-lead via durable message:
+- Call: `genie send '<SHIP|FIX-FIRST|BLOCKED> — <summary>' --to team-lead`
+
+This is mandatory. The message is how team-lead gets notified of your verdict.
+</completion_reporting>
+
 <constraints>
 - Binary verdict only — no "partial pass"
 - Evidence required — don't assume, verify

plugins/genie/agents/reviewer/AGENTS.md

@@ -84,6 +84,13 @@ Validation: <PASS|FAIL with output>
 ```
 </output_format>
 
+<completion_reporting>
+On completion, report your verdict to team-lead via durable message:
+- Call: `genie send '<SHIP|FIX-FIRST|BLOCKED> — <summary>' --to team-lead`
+
+This is mandatory. The message is how team-lead gets notified of your verdict.
+</completion_reporting>
+
 <constraints>
 - Binary verdict only — no "partial pass"
 - Evidence required — don't assume, verify

plugins/genie/agents/team-lead.md

@@ -51,6 +51,17 @@ genie team done <team>
 ```
 </process>
 
+<monitoring>
+**State file is source of truth. Messages are notifications.**
+
+When checking progress (after Phase 2 completes or if you need to diagnose):
+1. **Primary:** `genie status <slug>` — reads the state file directly. Deterministic, instant, always accurate.
+2. **Secondary:** `genie inbox` — durable messages from workers. May lag behind state.
+3. **Bonus:** SendMessage from workers arrives between tool calls — use it but don't depend on it.
+
+Never rely on messages alone to determine completion. Always check `genie status` first.
+</monitoring>
+
 <constraints>
 - NEVER write code. `genie work` dispatches engineers.
 - NEVER use `sleep`.

plugins/genie/agents/team-lead/AGENTS.md

@@ -51,6 +51,17 @@ genie team done <team>
 ```
 </process>
 
+<monitoring>
+**State file is source of truth. Messages are notifications.**
+
+When checking progress (after Phase 2 completes or if you need to diagnose):
+1. **Primary:** `genie status <slug>` — reads the state file directly. Deterministic, instant, always accurate.
+2. **Secondary:** `genie inbox` — durable messages from workers. May lag behind state.
+3. **Bonus:** SendMessage from workers arrives between tool calls — use it but don't depend on it.
+
+Never rely on messages alone to determine completion. Always check `genie status` first.
+</monitoring>
+
 <constraints>
 - NEVER write code. `genie work` dispatches engineers.
 - NEVER use `sleep`.

src/term-commands/dispatch.ts

@@ -543,7 +543,7 @@ export async function workDispatchCommand(agentName: string, ref: string): Promi
     team: process.env.GENIE_TEAM ?? 'genie',
     role: `${agentName}-${group}`,
     extraArgs: ['--append-system-prompt-file', contextFile],
-    initialPrompt: `Execute Group ${group} of wish "${slug}". Your full context is in the system prompt. Read the wish at ${wishPath} if needed. Implement all deliverables, run validation, and report completion. When done, run: genie done ${slug}#${group}`,
+    initialPrompt: `Execute Group ${group} of wish "${slug}". Your full context is in the system prompt. Read the wish at ${wishPath} if needed. Implement all deliverables, run validation, and report completion.\n\nWhen done:\n1. Run: genie done ${slug}#${group}\n2. Run: genie send 'Group ${group} complete. <summary>' --to team-lead`,
   });
 }
 
@@ -598,7 +598,7 @@ export async function reviewCommand(agentName: string, ref: string): Promise<voi
     provider: 'claude',
     team: process.env.GENIE_TEAM ?? 'genie',
     extraArgs: ['--append-system-prompt-file', contextFile],
-    initialPrompt: `Review "${ref}". Your context and diff are in the system prompt. Evaluate against acceptance criteria and return SHIP, FIX-FIRST, or BLOCKED with severity-tagged findings.`,
+    initialPrompt: `Review "${ref}". Your context and diff are in the system prompt. Evaluate against acceptance criteria and return SHIP, FIX-FIRST, or BLOCKED with severity-tagged findings.\n\nWhen done, report your verdict:\nRun: genie send '<SHIP|FIX-FIRST|BLOCKED> — <summary>' --to team-lead`,
   });
 }