Shared References
Overview
This skill provides shared reference documents that are used across multiple Integrator Agent skills. It contains common patterns, protocols, and utilities that enable consistent behavior across the skill set.
Prerequisites
None required. This is a reference skill with no external dependencies.
Instructions
- Identify the shared protocol or pattern needed for the current task
- Review the relevant reference document from the list below
- Apply the protocol or pattern to the agent workflow
- Validate the implementation against the documented schema
- Document any handoff or session state according to the standard format
Checklist
Copy this checklist and track your progress:
- Identify the shared protocol or pattern needed
- Review the relevant reference document
- Apply the protocol or pattern to the workflow
- Validate implementation against documented schema
- Document handoff or session state in standard format
- Verify all required fields are present in handoff payload
- Ensure datetime fields use ISO 8601 format
Output
| Output Type | Format | Description |
|---|---|---|
| Handoff Payload | JSON | Structured agent handoff with context and state |
| Session State | JSON | Current session state snapshot for continuity |
| Coordination Protocol | JSON | Multi-agent workflow coordination structure |
Reference Documents
Handoff Protocols (references/handoff-protocols.md)
Standard protocols for handing off work between agents:
- When you need to transfer context between agents → Handoff Format
- If you need to document session state → Session State Schema
- When coordinating multi-agent workflows → Coordination Patterns
Examples
Example 1: Agent Handoff Format
{
"handoff_type": "task_delegation",
"from_agent": "orchestrator",
"to_agent": "code-reviewer",
"context": {
"pr_number": 123,
"repository": "owner/repo",
"task": "Review code changes"
},
"session_state": {
"files_reviewed": [],
"comments_made": []
}
}
Example 2: Session State Schema
{
"session_id": "sess_abc123",
"started_at": "2025-01-30T10:00:00Z",
"current_phase": "review",
"completed_tasks": ["fetch_pr", "analyze_diff"],
"pending_tasks": ["post_review"]
}
Error Handling
Issue: Handoff context incomplete
Cause: Required fields missing from handoff payload.
Solution: Validate handoff against schema before sending. Required fields: handoff_type, from_agent, to_agent, context.
Issue: Session state deserialization fails
Cause: Invalid JSON or schema mismatch.
Solution: Validate JSON structure and ensure all datetime fields use ISO 8601 format.
Resources
- references/handoff-protocols.md - Complete handoff protocol reference
- references/ai-maestro-message-templates.md - AI Maestro curl command templates for inter-agent messaging
- references/sub-agent-role-boundaries-template.md - Worker agent role boundary template for task delegation
- references/routing-checklist.md - Task routing checklist for agent coordination
- references/record-keeping.md - Session record-keeping formats and state management
- references/phase-procedures.md - Integration phase procedures and workflow steps
Converted and distributed by TomeVault — claim your Tome and manage your conversions.