# Eia Integration Protocols

> Use when accessing shared utilities and protocols. Trigger with cross-skill reference requests.

- Skill: `tomevault-io/eia-integration-protocols` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/eia-integration-protocols`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/eia-integration-protocols/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/eia-integration-protocols

---


# 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

1. Identify the shared protocol or pattern needed for the current task
2. Review the relevant reference document from the list below
3. Apply the protocol or pattern to the agent workflow
4. Validate the implementation against the documented schema
5. 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](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

```json
{
  "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

```json
{
  "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](references/handoff-protocols.md) - Complete handoff protocol reference
- [references/ai-maestro-message-templates.md](references/ai-maestro-message-templates.md) - AI Maestro curl command templates for inter-agent messaging
- [references/sub-agent-role-boundaries-template.md](references/sub-agent-role-boundaries-template.md) - Worker agent role boundary template for task delegation
- [references/routing-checklist.md](references/routing-checklist.md) - Task routing checklist for agent coordination
- [references/record-keeping.md](references/record-keeping.md) - Session record-keeping formats and state management
- [references/phase-procedures.md](references/phase-procedures.md) - Integration phase procedures and workflow steps

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/emasoft) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->