handoff-contract

Standardize agent handoff reports with four required sections for orchestrator integration.

10|1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/maystudios/maxsimcli --skill handoff-contract
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff-contract
Source: https://github.com/maystudios/maxsimcli/tree/main/templates/skills/handoff-contract
Command: npx skills add https://github.com/maystudios/maxsimcli --skill handoff-contract

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes agent output format with four sections: Key Decisions, Artifacts, Status, and Deferred Items, ensuring consistent reporting to the orchestrator and preventing pipeline breakage.

Core Features & Use Cases

  • Enforces a four-section handoff structure for every completed task.
  • Guides downstream processing by making decisions, artifacts, status, and deferred items explicit.
  • Improves traceability and auditability of agent work within the orchestration pipeline.

Quick Start

After a task finishes, wrap the output with the required four sections and submit to the orchestrator.

Frequently Asked Questions about handoff-contract

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize agent task handoffs to an orchestrator pipeline?

Standardize agent task handoffs by wrapping completed task outputs with four required sections: Key Decisions, Artifacts, Status, and Deferred Items. This structured contract format ensures consistent reporting to the orchestrator and prevents pipeline breakage.

What is the standard format for reporting agent output to an orchestrator?

The standard format for agent output requires four sections: Key Decisions, Artifacts, Status, and Deferred Items, plus frontmatter name and description for discovery. This structure ensures traceability and auditability of agent work within the orchestration pipeline.

How do I capture deferred items and key decisions when an agent task concludes?

Capture deferred items and key decisions by structuring the final agent output into the mandated four-section contract format. This explicitly guides downstream processing by separating decisions, artifacts, status, and deferred items into distinct reporting sections.

Does the agent handoff contract require frontmatter for orchestrator discovery?

Yes, the agent handoff contract requires frontmatter name and description for orchestrator discovery. Alongside the four required content sections, this frontmetadata ensures the task report integrates properly into the orchestrator pipeline.

Why does my orchestrator pipeline break when agent outputs are unstructured?

Orchestrator pipelines break when agent outputs lack standardized structure because downstream processing cannot locate decisions, artifacts, status, or deferred items. Enforcing a four-section handoff contract prevents this by making all required task results explicit and traceable.