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

# Analysis Map — KAR-77 Skill multi-agent-handoffs

## Ziel des Tasks (1 Satz)

Skill der strukturierte Sub-Agent-Handoffs (Validation-Contracts + Handoff-Schema + 3-Rollen-Pattern) als Markdown-Templates und Konvention bereitstellt, sodass Aria-Sub-Agents bei nicht-trivialen Tasks deterministische Übergaben statt freiform-Output produzieren.

## Files die berührt werden

| Pfad | Symbol(e) | Lese/Schreibe | Risiko |
|------|-----------|---------------|--------|
| `/root/.claude/skills/multi-agent-handoffs/SKILL.md` | - | Create | low |
| `/root/.claude/skills/multi-agent-handoffs/templates/handoff-schema.md` | - | Create | low |
| `/root/.claude/skills/multi-agent-handoffs/templates/validation-contract.md` | - | Create | low |
| `/root/.claude/skills/multi-agent-handoffs/templates/orchestrator-role.md` | - | Create | low |
| `/root/.claude/skills/multi-agent-handoffs/README.md` | - | Create | low |
| `/root/.claude/skills/durable-agents/` | bestehender Skill | Read (Merge-Bewertung) | medium |
| `/root/aria/brain/01-Projekte/kar-77-multi-agent-handoffs/implementation-diary.md` | live updates | Write (live) | low |

## Standing Orders / LRNs die greifen

- Memory `feedback_subagent_spawn_filter` — kein Spawn ohne 3-Fragen-Filter
- LRN-20260510-001 — BIG/SMALL-Klassifikation (KAR-77 ist BIG → strikter Plan)

## Cross-References

- [[2026-05-12-aidotengineer-the-multi-agent-architecture-that-actual]] — Quelle, conf 0.82
- KAR-77 (das Linear-Issue)
- KAR-76 (doc-manager-pattern, dessen Skill wir hier pilotieren)
- `durable-agents` bestehender Skill (Merge-Kandidat — vergleichen)

## Risiken / Unbekanntes

- **Merge mit durable-agents**: kann sein dass durable-agents bereits 60% deckt — dann nicht neuen Skill, sondern Update. Zuerst durable-agents lesen.
- **Validation-Contract-Format**: muss generisch genug für Aria-Sub-Agents UND für KADi-Agents sein. Risiko: zu spezifisch oder zu vage.
- **3-Rollen-Pattern**: gibt es bereits in `feature-dev:*` (code-architect, code-explorer, code-reviewer). Risiko Duplikation.

## Out of Scope

- KEIN neues Sub-Agent-Runtime/Tooling (nur Markdown-Konvention + Schema)
- KEINE Tool-Definitionen über das hinaus was Claude Code schon hat
- KEIN dedicated CLI (analog doc-manager-pattern: erst Pattern, dann ggf. CLI)