amoa-agent-replacement

Category: Tools & Productivity | Uploader: Emasoft | Downloads: 0 | Version: v1.0（Latest）

Use when replacing agents. Trigger with agent replacement or handoff requests.

Changelog: Source: GitHub https://github.com/Emasoft/ai-maestro-orchestrator-agent

Directory Structure

Current level: skills/amoa-agent-replacement/

📁 references/
- 📄 amcos-notification-handling.md 9.3 KB
- 📄 confirmation-protocol.md 13.3 KB
- 📄 context-compilation-workflow.md 8.7 KB
- 📄 design-document-protocol.md 11.1 KB
- 📄 edge-case-protocols.md 14.2 KB
- 📄 emergency-procedures.md 1.3 KB
- 📄 error-handling-reference.md 1.1 KB
- 📄 examples.md 1.3 KB
- 📄 handoff-delivery-protocol.md 10.3 KB
- 📄 handoff-document-format.md 9.7 KB
- 📄 handoff-protocols.md 5.6 KB
- 📄 kanban-reassignment-protocol.md 8.6 KB
- 📄 op-compile-task-context.md 6.0 KB
- 📄 op-confirm-reassignment.md 7.4 KB
- 📄 op-generate-handoff-document.md 8.7 KB
- 📄 op-reassign-kanban-tasks.md 5.6 KB
- 📄 op-receive-ecos-notification.md 4.7 KB
- 📄 op-send-handoff.md 6.4 KB
- 📄 replacement-workflow-steps.md 3.7 KB
- 📄 task-completion-checklist.md 4.7 KB
- 📄 troubleshooting.md 11.1 KB
📄 README.md 1.6 KB
📄 SKILL.md 3.8 KB

SKILL.md

---
name: amoa-agent-replacement
description: "Use when replacing agents. Trigger with agent replacement or handoff requests."
license: Apache-2.0
compatibility: "Python 3.8+, PyYAML, GitHub CLI, AI Maestro, AMCOS."
metadata:
  author: Emasoft
  version: 1.0.0
user-invocable: false
context: fork
agent: amoa-main
---

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

**Use this skill when**: AMCOS notifies of agent failure, context loss, or manual replacement is needed.

## Prerequisites

- Python 3.8+ with PyYAML
- GitHub CLI (gh) authenticated
- AI Maestro running
- AMCOS system operational

## Output

| Output Type | Location | Format |
|-------------|----------|--------|
| Handoff Document | GitHub issue comment | Markdown with context and next steps |
| State File | Orchestrator state YAML | Updated agent assignment |
| AMCOS Confirmation | AI Maestro message | JSON replacement status |
| Kanban Update | GitHub Project board | Reassigned task cards |

---

## Instructions

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

See: [replacement-workflow-steps.md](references/replacement-workflow-steps.md) for detailed steps.
<!-- TOC: Python Scripts | Replacement Protocol Flow -->

---

## 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](references/examples.md) for full examples.
<!-- TOC: Example 1: Standard Replacement Flow | Example 2: Emergency Replacement with Partial Context -->

---

## Error Handling

See: [error-handling-reference.md](references/error-handling-reference.md) for errors and solutions.
<!-- TOC: Emergency Procedures | Common Errors and Solutions -->

---

## Resources

- [replacement-workflow-steps.md](references/replacement-workflow-steps.md) - 6-step workflow
  <!-- TOC: Python Scripts | Replacement Protocol Flow -->
- [error-handling-reference.md](references/error-handling-reference.md) - Errors
  <!-- TOC: Emergency Procedures | Common Errors and Solutions -->
- [handoff-document-format.md](references/handoff-document-format.md) - Handoff format
  <!-- TOC: Required Sections | Task Detail Format -->
- [examples.md](references/examples.md) - Examples
  <!-- TOC: Example 1: Standard Replacement Flow | Example 2: Emergency Replacement with Partial Context -->
- [emergency-procedures.md](references/emergency-procedures.md) - Emergencies
  <!-- TOC: Replacement Agent Also Fails | Handoff Document Corrupted -->
- [context-compilation-workflow.md](references/context-compilation-workflow.md) - Context gathering
  <!-- TOC: Information Sources | State File Extraction -->

---

## Related Skills

- `amoa-remote-agent-coordinator` - Agent registration and remote agent communication
- `amoa-orchestration-patterns` - General orchestration patterns

---

**Version**: 1.0.0 | **Last Updated**: 2026-02-03

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

amoa-agent-replacement

Directory Structure

SKILL.md

Report

Notice