amoa-agent-replacement

What problem does it solve?

When an agent fails, becomes unresponsive, or suffers context loss, this Skill centralizes and automates the recovery workflow so work continues with minimal disruption. It compiles all task context, generates structured handoff documents, reassigns GitHub Project kanban cards, delivers the handoff to replacement agents via AI Maestro, and confirms successful replacement with ACK verification and state updates.

Core Features & Use Cases

• Compile context from orchestrator state files, GitHub issues, git branches, and AI Maestro message history to create a single continuity document.
• Generate and upload handoff documents to GitHub, attach audit comments, and provide local backups for persistence.
• Reassign project board cards and issue labels while preserving status, add reassignment audit comments, and update orchestrator state YAML.
• Deliver handoffs via AI Maestro agent-messaging, require and validate ACKs, retry or escalate on timeouts, and log audit records for compliance.
• Use cases: AMCOS immediate replacement, pre-emptive context-limit handoffs, emergency partial-context recovery, and automated reassignment after agent timeouts.

Quick Start

Instruct the orchestrator to generate a replacement handoff for failed agent implementer-1, reassign their GitHub Project cards to implementer-2, deliver the handoff via AI Maestro, and await ACK.