---
task_slug: kar-77-multi-agent-handoffs
doc_type: implementation-plan
kar_issue: KAR-77
related_brain_notes: [[2026-05-12-aidotengineer-the-multi-agent-architecture-that-actual]]
date: 2026-05-12
status: done
---

# Implementation Plan — KAR-77 Skill multi-agent-handoffs

## Why

Aria spawnt heute Sub-Agents ad-hoc. Wenn wir mehr Multi-Agent-Workflows wollen (Orchestrator → Coder + Reviewer), brauchen wir strukturierte Handoff-Outputs sodass die spawnende Aria-Instanz die Sub-Agent-Resultate deterministisch konsumieren kann. Quelle: Luke Alvoeiro / Factory bei AI Engineer (Brain-Note conf 0.82).

## Acceptance Criteria

- [ ] `SKILL.md` mit Handoff-Schema + Validation-Contract + 3-Rollen-Pattern
- [ ] 3 Templates in `templates/` (handoff-schema, validation-contract, orchestrator-role)
- [ ] Bewertung ob mit `durable-agents` zu mergen — Decision-Record `pilot/decision-merge-durable-agents.md`
- [ ] README mit Quickstart

## Schritte

1. **Vergleich durable-agents** (S, 15 min)
   - Lese `/root/.claude/skills/durable-agents/SKILL.md`
   - Mappe: was deckt durable-agents schon? Wo Gap?

2. **SKILL.md schreiben** (M, 45 min)
   - Handoff-Schema (6 Felder: completed/undone/commands_run/exit_codes/issues_found/procedures_followed)
   - Validation-Contract (pre-implementation Akzeptanzkriterien)
   - 3-Rollen-Pattern (Orchestrator/Worker/Validator)

3. **Templates** (S, 30 min)
   - templates/handoff-schema.md
   - templates/validation-contract.md
   - templates/orchestrator-role.md

4. **README + Cross-Links** (S, 15 min)

5. **Decision-Record** (S, 20 min)
   - Ob mit durable-agents mergen oder separat lassen
   - Datei: `pilot/decision-merge-durable-agents.md`

6. **doc-manager-pattern Pilot-Evaluation** (S, 15 min)
   - Datei: `pilot-result.md` im KAR-76 Skill-Folder
   - Verdict: hilft das 4-Doc-Pattern wirklich? Über-engineered? Schmerzpunkte?

## Verifikation

- Skill triggert in der Aria-Skill-Liste (sichtbar nach next system-reminder)
- 3 Templates lassen sich durch eine echte Aria-Sub-Agent-Spawn-Sequenz fließen
- `durable-agents` entweder verlinkt oder gemerged

## Roll-Back-Plan

Falls Skill duplikat zu durable-agents → SKILL.md löschen, durable-agents updaten. Templates können stehen bleiben.

## Pause-Points

- Nach Schritt 1: hier kann pausiert werden, durable-agents-Vergleich ist isoliert
- Nach Schritt 3: hier kann pausiert werden, Skill+Templates sind nutzbar auch ohne Decision