What problem does it solve? Unstructured, free-text handoffs between AI agents cause context loss, state corruption, and cascading errors in multi-agent systems. This Skill turns inter-agent handoffs into versioned, schema-validated API contracts so control, context, and responsibility transfer reliably between agents. ## Core Features & Use Cases - Handoff contract design: Emits a JSON Schema (draft 2020-12) with six required fields — taskId, intent, state, confidence, provenance, schemaVersion — plus additionalProperties: false and no free-text fields. - Topology decision record: Applies a four-step gate (workflow vs single agent vs multi-agent squad) defaulting to orchestrator-worker, with a documented rationale. - Binary write-ownership mapping: Assigns exactly one writer per shared-state element with explicit ownership-transfer points, plus autonomy levels calibrated to task reversibility. - Use Case: When defining the payload between a planner agent and a coder agent, use this Skill to produce the handoff design doc, the topology decision record, and a validated JSON Schema with correlation IDs for cross-agent tracing. ## Quick Start Ask the agent to design a handoff contract between your planner and coder agents, including the JSON Schema payload and a topology decision record.
