feat(agent-teams): add plugin for multi-agent team orchestration

New plugin with 7 presets (review, debug, feature, fullstack, research,
security, migration), 4 specialized agents, 7 slash commands, 6 skills
with reference docs, and Context7 MCP integration for research teams.

plugins/agent-teams/skills/team-communication-protocols/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: team-communication-protocols
+description: Structured messaging protocols for agent team communication including message type selection, plan approval, shutdown procedures, and anti-patterns to avoid. Use this skill when establishing team communication norms, handling plan approvals, or managing team shutdown.
+---
+
+# Team Communication Protocols
+
+Protocols for effective communication between agent teammates, including message type selection, plan approval workflows, shutdown procedures, and common anti-patterns to avoid.
+
+## When to Use This Skill
+
+- Establishing communication norms for a new team
+- Choosing between message types (message, broadcast, shutdown_request)
+- Handling plan approval workflows
+- Managing graceful team shutdown
+- Discovering teammate identities and capabilities
+
+## Message Type Selection
+
+### `message` (Direct Message) — Default Choice
+
+Send to a single specific teammate:
+
+```json
+{
+  "type": "message",
+  "recipient": "implementer-1",
+  "content": "Your API endpoint is ready. You can now build the frontend form.",
+  "summary": "API endpoint ready for frontend"
+}
+```
+
+**Use for**: Task updates, coordination, questions, integration notifications.
+
+### `broadcast` — Use Sparingly
+
+Send to ALL teammates simultaneously:
+
+```json
+{
+  "type": "broadcast",
+  "content": "Critical: shared types file has been updated. Pull latest before continuing.",
+  "summary": "Shared types updated"
+}
+```
+
+**Use ONLY for**: Critical blockers affecting everyone, major changes to shared resources.
+
+**Why sparingly?**: Each broadcast sends N separate messages (one per teammate), consuming API resources proportional to team size.
+
+### `shutdown_request` — Graceful Termination
+
+Request a teammate to shut down:
+
+```json
+{
+  "type": "shutdown_request",
+  "recipient": "reviewer-1",
+  "content": "Review complete, shutting down team."
+}
+```
+
+The teammate responds with `shutdown_response` (approve or reject with reason).
+
+## Communication Anti-Patterns
+
+| Anti-Pattern                            | Problem                                  | Better Approach                        |
+| --------------------------------------- | ---------------------------------------- | -------------------------------------- |
+| Broadcasting routine updates            | Wastes resources, noise                  | Direct message to affected teammate    |
+| Sending JSON status messages            | Not designed for structured data         | Use TaskUpdate to update task status   |
+| Not communicating at integration points | Teammates build against stale interfaces | Message when your interface is ready   |
+| Micromanaging via messages              | Overwhelms teammates, slows work         | Check in at milestones, not every step |
+| Using UUIDs instead of names            | Hard to read, error-prone                | Always use teammate names              |
+| Ignoring idle teammates                 | Wasted capacity                          | Assign new work or shut down           |
+
+## Plan Approval Workflow
+
+When a teammate is spawned with `plan_mode_required`:
+
+1. Teammate creates a plan using read-only exploration tools
+2. Teammate calls `ExitPlanMode` which sends a `plan_approval_request` to the lead
+3. Lead reviews the plan
+4. Lead responds with `plan_approval_response`:
+
+**Approve**:
+
+```json
+{
+  "type": "plan_approval_response",
+  "request_id": "abc-123",
+  "recipient": "implementer-1",
+  "approve": true
+}
+```
+
+**Reject with feedback**:
+
+```json
+{
+  "type": "plan_approval_response",
+  "request_id": "abc-123",
+  "recipient": "implementer-1",
+  "approve": false,
+  "content": "Please add error handling for the API calls"
+}
+```
+
+## Shutdown Protocol
+
+### Graceful Shutdown Sequence
+
+1. **Lead sends shutdown_request** to each teammate
+2. **Teammate receives request** as a JSON message with `type: "shutdown_request"`
+3. **Teammate responds** with `shutdown_response`:
+   - `approve: true` — Teammate saves state and exits
+   - `approve: false` + reason — Teammate continues working
+4. **Lead handles rejections** — Wait for teammate to finish, then retry
+5. **After all teammates shut down** — Call `Teammate` cleanup
+
+### Handling Rejections
+
+If a teammate rejects shutdown:
+
+- Check their reason (usually "still working on task")
+- Wait for their current task to complete
+- Retry shutdown request
+- If urgent, user can force shutdown
+
+## Teammate Discovery
+
+Find team members by reading the config file:
+
+**Location**: `~/.claude/teams/{team-name}/config.json`
+
+**Structure**:
+
+```json
+{
+  "members": [
+    {
+      "name": "security-reviewer",
+      "agentId": "uuid-here",
+      "agentType": "team-reviewer"
+    },
+    {
+      "name": "perf-reviewer",
+      "agentId": "uuid-here",
+      "agentType": "team-reviewer"
+    }
+  ]
+}
+```
+
+**Always use `name`** for messaging and task assignment. Never use `agentId` directly.

plugins/agent-teams/skills/team-communication-protocols/references/messaging-patterns.md

@@ -0,0 +1,112 @@
+# Messaging Pattern Templates
+
+Ready-to-use message templates for common team communication scenarios.
+
+## Task Assignment
+
+```
+You've been assigned task #{id}: {subject}.
+
+Owned files:
+- {file1}
+- {file2}
+
+Key requirements:
+- {requirement1}
+- {requirement2}
+
+Interface contract:
+- Import {types} from {shared-file}
+- Export {types} for {other-teammate}
+
+Let me know if you have questions or blockers.
+```
+
+## Integration Point Notification
+
+```
+My side of the {interface-name} interface is complete.
+
+Exported from {file}:
+- {function/type 1}
+- {function/type 2}
+
+You can now import these in your owned files. The contract matches what we agreed on.
+```
+
+## Blocker Report
+
+```
+I'm blocked on task #{id}: {subject}.
+
+Blocker: {description of what's preventing progress}
+Impact: {what can't be completed until this is resolved}
+
+Options:
+1. {option 1}
+2. {option 2}
+
+Waiting for your guidance.
+```
+
+## Task Completion Report
+
+```
+Task #{id} complete: {subject}
+
+Changes made:
+- {file1}: {what changed}
+- {file2}: {what changed}
+
+Integration notes:
+- {any interface changes or considerations for other teammates}
+
+Ready for next assignment.
+```
+
+## Review Finding Summary
+
+```
+Review complete for {target} ({dimension} dimension).
+
+Summary:
+- Critical: {count}
+- High: {count}
+- Medium: {count}
+- Low: {count}
+
+Top finding: {brief description of most important finding}
+
+Full findings attached to task #{id}.
+```
+
+## Investigation Report Summary
+
+```
+Investigation complete for hypothesis: {hypothesis summary}
+
+Verdict: {Confirmed | Falsified | Inconclusive}
+Confidence: {High | Medium | Low}
+
+Key evidence:
+- {file:line}: {what was found}
+- {file:line}: {what was found}
+
+{If confirmed}: Recommended fix: {brief fix description}
+{If falsified}: Contradicting evidence: {brief description}
+
+Full report attached to task #{id}.
+```
+
+## Shutdown Acknowledgment
+
+When you receive a shutdown request, respond with the shutdown_response tool. But you may also want to send a final status message:
+
+```
+Wrapping up. Current status:
+- Task #{id}: {completed/in-progress}
+- Files modified: {list}
+- Pending work: {none or description}
+
+Ready for shutdown.
+```