Skill

amoa-agent-replacement

Handles 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.

Python

Github

automation

git-workflow

npx claudepluginhub emasoft/ai-maestro-orchestrator-agent

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Handle agent replacement triggered by AMCOS. When an agent fails or loses context, compile task context and generate handoff documents for the replacement.

Supporting Assets

SKILL.md

Similar Skills

amoa-task-distribution

Distributes GitHub tasks to AI agents by priority, dependencies, availability, skills, and load using labels and AI Maestro messaging. For task assignment requests.

14 files

ai-maestro-orchestrator-agent

agent-messaging

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.

godmode

pact-agent-teams

Implements PACT agent teams protocol for task claiming, teachback verification, inter-agent messaging with SendMessage, blocker reporting, and work handoffs.

1 file

PACT

Stats

Stars10

Forks0

Last CommitApr 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Agent Replacement Skill

Overview

Handle agent replacement triggered by AMCOS. When an agent fails or loses context, compile task context and generate handoff documents for the replacement.

Prerequisites

Python 3.8+, PyYAML, GitHub CLI (gh) authenticated, AI Maestro running, AMCOS operational.

Output

Handoff document (GitHub issue comment), state file update, AMCOS confirmation, kanban reassignment.

Instructions

On AMCOS notification, compile task context from the failed agent's GitHub issues, kanban cards, and AI Maestro message history.
Generate a handoff document and deliver it to the replacement agent via AI Maestro agent-messaging skill.
Wait for ACK, confirm reassignment, and notify AMCOS of successful replacement.

See: replacement-workflow-steps.md for detailed steps.

Checklist

Copy this checklist and track your progress:

Receive and acknowledge AMCOS replacement notification
Compile all task context from failed agent
Generate comprehensive handoff document
Reassign GitHub Project kanban tasks
Send handoff to new agent via AI Maestro agent-messaging skill
Confirm ACK receipt and requirements understanding
Update orchestrator state file
Notify AMCOS of successful replacement

Examples

Input: AMCOS notification {"type": "agent-failed", "agent": "libs-svg-svgbbox", "reason": "context-loss"} Output: Handoff document posted to GitHub issue + kanban tasks reassigned + AMCOS confirmation sent

See: examples.md for full examples.

Error Handling

See: error-handling-reference.md for errors and solutions.

Resources

replacement-workflow-steps.md - 6-step workflow
- 1. Replacement Protocol Flow
- 1. Step 1: Receive AMCOS Notification
- 1. Step 2: Compile Task Context
- 1. Step 3: Generate Handoff Document
- 1. Step 4: Reassign Kanban Tasks
- ...
error-handling-reference.md - Errors
- 1. Common Errors and Solutions
- 1. Troubleshooting References
- 1. Emergency Procedures
handoff-document-format.md - Handoff format
- 3.1 Required Sections
  - Mandatory Sections
  - Section Order
- Template
- Handoff Metadata
- ...
examples.md - Examples
- Example 1: Standard Replacement Flow
- Example 2: Emergency Replacement with Partial Context
emergency-procedures.md - Emergencies
- Replacement Agent Also Fails
- Handoff Document Corrupted
- GitHub Project Access Issues
context-compilation-workflow.md - Context gathering
- 2.1 Information Sources
  - Primary Sources (MUST check)
  - Secondary Sources (SHOULD check)
  - Tertiary Sources (MAY check)
- 2.2 State File Extraction
- ...

Agent Replacement Skill

Overview

Handle agent replacement triggered by AMCOS. When an agent fails or loses context, compile task context and generate handoff documents for the replacement.

Prerequisites

Python 3.8+, PyYAML, GitHub CLI (gh) authenticated, AI Maestro running, AMCOS operational.

Output

Handoff document (GitHub issue comment), state file update, AMCOS confirmation, kanban reassignment.

Instructions

On AMCOS notification, compile task context from the failed agent's GitHub issues, kanban cards, and AI Maestro message history.

Generate a handoff document and deliver it to the replacement agent via AI Maestro agent-messaging skill.

Wait for ACK, confirm reassignment, and notify AMCOS of successful replacement.

Checklist

Copy this checklist and track your progress:

Receive and acknowledge AMCOS replacement notification

Compile all task context from failed agent

Generate comprehensive handoff document

Reassign GitHub Project kanban tasks

Send handoff to new agent via AI Maestro agent-messaging skill

Confirm ACK receipt and requirements understanding

Update orchestrator state file

Notify AMCOS of successful replacement

Examples

See: examples.md for full examples.

Error Handling

Resources

replacement-workflow-steps.md - 6-step workflow

1. Replacement Protocol Flow
1. Step 1: Receive AMCOS Notification
1. Step 2: Compile Task Context
1. Step 3: Generate Handoff Document
1. Step 4: Reassign Kanban Tasks
...

error-handling-reference.md - Errors

1. Common Errors and Solutions
1. Troubleshooting References
1. Emergency Procedures

handoff-document-format.md - Handoff format

3.1 Required Sections
- Mandatory Sections
- Section Order
Template
Handoff Metadata
...

examples.md - Examples

Example 1: Standard Replacement Flow
Example 2: Emergency Replacement with Partial Context

emergency-procedures.md - Emergencies

Replacement Agent Also Fails
Handoff Document Corrupted
GitHub Project Access Issues

context-compilation-workflow.md - Context gathering

2.1 Information Sources
- Primary Sources (MUST check)
- Secondary Sources (SHOULD check)
- Tertiary Sources (MAY check)
2.2 State File Extraction
...