From emasoft-orchestrator-agent
Use when replacing agents. Trigger with agent replacement or handoff requests.
npx claudepluginhub emasoft/emasoft-plugins --plugin emasoft-orchestrator-agentThis skill uses the workspace's default tool permissions.
Handle agent replacement scenarios triggered by ECOS (Emergency Context-loss Operations System). When an agent fails, becomes unresponsive, or experiences context loss, compile all task context and generate handoff documents for the replacement agent.
README.mdreferences/confirmation-protocol.mdreferences/context-compilation-workflow.mdreferences/design-document-protocol.mdreferences/ecos-notification-handling.mdreferences/edge-case-protocols.mdreferences/emergency-procedures.mdreferences/examples.mdreferences/handoff-delivery-protocol.mdreferences/handoff-document-format.mdreferences/handoff-protocols.mdreferences/kanban-reassignment-protocol.mdreferences/op-compile-task-context.mdreferences/op-confirm-reassignment.mdreferences/op-generate-handoff-document.mdreferences/op-reassign-kanban-tasks.mdreferences/op-receive-ecos-notification.mdreferences/op-send-handoff.mdreferences/task-completion-checklist.mdreferences/troubleshooting.mdHandles agent replacement in AI Maestro by compiling task context from GitHub issues, kanban cards, and message history, generating handoff documents, reassigning tasks, and confirming with AMCOS.
Implements PACT agent teams protocol for task claiming, teachback verification, inter-agent messaging with SendMessage, blocker reporting, and work handoffs.
Use when dispatching subagents, composing prompts for teammates, structuring handoff reports, or managing context boundaries between agents. Covers both subagent prompts and team-level messaging.
Share bugs, ideas, or general feedback.
Handle agent replacement scenarios triggered by ECOS (Emergency Context-loss Operations System). When an agent fails, becomes unresponsive, or experiences context loss, compile all task context and generate handoff documents for the replacement agent.
| Output Type | Location | Format |
|---|---|---|
| Handoff Document | GitHub issue comment | Markdown with task context, progress, next steps |
| State File Update | Orchestrator state YAML | Updated agent assignment with replacement metadata |
| ECOS Confirmation | AI Maestro message | JSON confirmation with replacement status |
| Kanban Reassignment | GitHub Project board | Updated assignee on all task cards |
agent-messaging skill and request acknowledgmentUse this skill when: ECOS notifies you of agent failure, context loss, unresponsive behavior, or manual replacement is needed.
Copy this checklist and track your progress:
agent-messaging skill| Section | Reference |
|---|---|
| Step 1: Receive ECOS Notification | ecos-notification-handling.md |
| Step 2: Compile Task Context | context-compilation-workflow.md |
| Step 3: Generate Handoff Document | handoff-document-format.md |
| Step 4: Reassign Kanban Tasks | kanban-reassignment-protocol.md |
| Step 5: Send Handoff to New Agent | handoff-delivery-protocol.md |
| Step 6: Confirm Reassignment | confirmation-protocol.md |
| Handoff Protocols | handoff-protocols.md |
| Design Document Protocol | design-document-protocol.md |
| Edge Case Protocols | edge-case-protocols.md |
| Task Completion Checklist | task-completion-checklist.md |
ECOS → EOA: Agent X failed, replacement is Agent Y
↓
EOA: Compile all task context for Agent X
↓
EOA: Generate comprehensive handoff document
↓
EOA: Update GitHub Project kanban (reassign tasks)
↓
EOA: Send handoff to replacement agent
↓
EOA: Confirm reassignment complete
CRITICAL: Before any replacement action: SAVE all state, DOCUMENT progress, PRESERVE communication history, NEVER assume new agent has any context.
Acknowledge ECOS notification, pause new assignments, begin context compilation.
See: ecos-notification-handling.md - 1.1 Notification Types, 1.2 Urgency Levels, 1.3 Acknowledgment Protocol, 1.4 Error Handling
Gather ALL information: task assignments, requirements, current progress, blockers, file changes, communication history, GitHub issues.
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/eoa_compile_replacement_context.py" \
--failed-agent "implementer-1" --output "replacement-context.md"
See: context-compilation-workflow.md - 2.1 Information Sources, 2.2 State File Extraction, 2.3 GitHub Issue Collection, 2.4 Communication History, 2.5 Git Branch Analysis
Create comprehensive handoff with: metadata, task context, user requirements, progress, technical context, communication history, next steps, verification requirements.
/eoa-generate-replacement-handoff --failed-agent implementer-1 --new-agent implementer-2 --include-tasks --include-context
See: handoff-document-format.md - 3.1 Required Sections, 3.2 Task Detail Format, 3.3 Progress Documentation, 3.4 Communication History Format, 3.5 Next Steps Clarity
Find all cards assigned to failed agent, update assignee, add reassignment comment, preserve labels/status, log for audit.
/eoa-reassign-kanban-tasks --from-agent implementer-1 --to-agent implementer-2 --project-id PROJECT_ID
See: kanban-reassignment-protocol.md - 4.1 Finding Assigned Cards, 4.2 Updating Assignee, 4.3 Audit Comments, 4.4 Preserving State, 4.5 Handling Partial Work
Upload handoff to GitHub issue, send AI Maestro message using the agent-messaging skill with URL, include urgency level, request ACK within timeout.
See: handoff-delivery-protocol.md - 5.1 Document Upload, 5.2 AI Maestro Notification, 5.3 ACK Requirements, 5.4 Timeout Handling
Verify: new agent ACKed, requirements understood, GitHub cards updated, state file updated, ECOS notified, failed agent removed from roster.
See: confirmation-protocol.md - 6.1 ACK Verification, 6.2 State File Updates, 6.3 ECOS Notification, 6.4 Audit Logging
| Script | Purpose |
|---|---|
eoa_compile_replacement_context.py | Gather all context about failed agent's work |
eoa_generate_replacement_handoff.py | Generate handoff document from compiled context |
eoa_reassign_kanban_tasks.py | Reassign GitHub Project cards |
eoa_confirm_replacement.py | Verify replacement completion and notify ECOS |
| Error | Cause | Solution |
|---|---|---|
| ECOS notification not received | AI Maestro communication failure | Check AI Maestro service status |
| Context compilation failed | State file missing or git unavailable | See troubleshooting.md section 7.2 |
| Handoff generation failed | Template or incomplete data error | See troubleshooting.md section 7.3 |
| GitHub API rate limit | Too many API calls | Wait or use batch operations |
| New agent ACK timeout | Agent unresponsive | Retry or alert user |
See: troubleshooting.md for detailed troubleshooting procedures.
See: emergency-procedures.md for critical failure scenarios.
See: examples.md - Standard replacement flow, emergency replacement with partial context
| Reference | Description |
|---|---|
| ecos-notification-handling.md | ECOS message handling + Agent Recovery decision tree and response template |
| context-compilation-workflow.md | Gathering task context |
| handoff-document-format.md | Handoff document structure |
| kanban-reassignment-protocol.md | GitHub Project updates |
| handoff-delivery-protocol.md | Delivering to new agent + Handoff delivery method decision tree and ACK template |
| confirmation-protocol.md | Confirming replacement + Confirmation outcome decision tree and ECOS notification template |
| handoff-protocols.md | Handoff protocol procedures |
| design-document-protocol.md | Design document protocol |
| edge-case-protocols.md | Edge case protocols |
| task-completion-checklist.md | Task completion checklist |
| troubleshooting.md | Common issues and solutions |
| emergency-procedures.md | Emergency procedures |
| examples.md | Usage examples |
eoa-remote-agent-coordinator - Agent registration and assignmenteoa-remote-agent-coordinator - Remote agent communicationeoa-orchestration-patterns - General orchestration patternseoa-agent-replacement - Shared handoff protocolsVersion: 1.0.0 | Last Updated: 2026-02-03