Eoa Messaging Templates

EOA Shared Communication Templates

Overview

This skill provides shared AI Maestro message templates and communication protocols used across all emasoft plugins for agent coordination, task assignment, status reporting, and escalation.

Prerequisites

1. AI Maestro messaging system (AMP) running
2. Understanding of emasoft agent roles (EOA, ECOS, EIA, EAMA)
3. Access to AI Maestro API for sending/receiving messages
4. Read eoa-label-taxonomy for GitHub label usage
5. Understanding of communication hierarchy and authority rules

Instructions

1. Identify the communication scenario (task assignment, status report, approval request, etc.)
2. Select the appropriate message template from section 2
3. Fill in the template with task-specific details
4. Send the message via AI Maestro using the agent-messaging skill
5. Wait for response according to the message type and priority
6. Log the message exchange in the appropriate delegation/coordination log

Checklist

Copy this checklist and track your progress:

Message Sending Workflow:

• Identify the communication scenario (task assignment, status report, approval, escalation, etc.)
• Select the appropriate message template from section 2
• Fill in all required template fields (from, to, subject, priority, content)
• Verify AI Maestro messaging system (AMP) is running
• Send the message via AI Maestro using the agent-messaging skill
• Wait for response according to message type and priority
• Log the message exchange in the appropriate delegation/coordination log
• If no response, follow escalation order from section 3.6

Table of Contents

• 1. AI Maestro Message Format
• 2. Message Templates by Scenario
• 3. Cross-Plugin Protocol Reference
• 4. Record-Keeping Standards

1. AI Maestro Message Format

Standard Message Structure

All AI Maestro messages use this format:

Note: Use the agent-messaging skill to send messages. The JSON structure below shows the message content.

{
  "from": "<sender-agent-name>",
  "to": "<recipient-agent-name>",
  "subject": "<short-subject-line>",
  "priority": "high|normal|low",
  "content": {
    "type": "request|response|notification|acknowledgment",
    "message": "<human-readable-message>",
    "data": {
      "task_id": "<optional-task-identifier>",
      "pr_number": "<optional-pr-number>",
      "issue_number": "<optional-issue-number>",
      "status": "<optional-status>"
    }
  }
}

Sending Messages

Send messages using the agent-messaging skill. Provide the JSON payload with recipient, subject, priority, and content fields as described above.

Checking Inbox

Check your inbox using the agent-messaging skill. Retrieve all unread messages for your session and process the content of each message.

Verify: confirm all messages are delivered or received as expected.

2. Message Templates by Scenario

For complete JSON templates with all fields, see references/message-templates.md:

• 2.1 Task Assignment (EOA → Remote Agent) - Assigning implementation task to remote agent
• 2.2 Task Completion Report (Agent → EOA) - Agent reporting task completion
• 2.3 Status Request (EOA → Agent) - Orchestrator polling agent for status
• 2.4 Status Response (Agent → EOA) - Agent responding to status request
• 2.5 Approval Request (ECOS → EAMA) - Chief of Staff requesting approval
• 2.6 Approval Response (EAMA → ECOS) - Assistant Manager responding to approval
• 2.7 Escalation (Any Agent → ECOS/EAMA) - Agent encountering blocker requiring escalation
• 2.8 Acknowledgment (Any Agent) - Acknowledging receipt of message
• 2.9 Design Handoff (EAA → EOA) - Architect handing off design to Orchestrator
• 2.10 Integration Request (EOA → EIA) - Orchestrator requesting code integration/review
• 2.11 Integration Result (EIA → EOA) - Integrator reporting integration/review result

For AI Maestro curl command templates with all message types, see references/ai-maestro-message-templates.md:

• Ready-to-use curl commands for each message type
• Complete JSON payloads with all required fields
• Copy-paste templates for quick messaging

Extended Communication Templates

For response templates FROM other agents TO EOA, see references/ecos-response-templates.md:

• ECOS response to EOA Task Completion Report (accept/rework/clarify)
• EAMA response to EOA Blocker Escalation (user decision delivered/deferred/rejected)
• EAA response to Design Issue Escalation (guidance/revised design/investigate)
• Decision trees for each response type

For session lifecycle messages (wake/hibernate/terminate), see references/session-lifecycle-templates.md:

• ECOS Wake message to EOA + EOA Wake ACK
• ECOS Hibernate directive + EOA Hibernate ACK
• ECOS Terminate directive + EOA Final Termination Report
• EOA Periodic Status Report (30-min scheduled summary)
• Decision trees for each lifecycle event

For task lifecycle commands (cancel/pause/resume/broadcast/stop), see references/task-lifecycle-templates.md:

• Task Cancellation send + agent work-summary response
• Task Pause/Resume send + agent state-checkpoint ACK
• Broadcast Message send + individual ACKs
• Agent Stop Work Notification + response
• Decision trees: Cancel vs Pause vs Reassign; Broadcast vs Targeted

For agent resource and skill requests, see references/resource-request-templates.md:

• Agent Resource Request (tools/access/credentials) → EOA response (grant/deny/escalate)
• Agent Skill Request (different capability) → EOA response
• EOA formal ACK of ECOS Task assignment (JSON template)
• Decision tree: Grant directly / Escalate to ECOS / Deny with alternative

3. Cross-Plugin Protocol Reference

3.1 Communication Hierarchy

USER
  ↓
EAMA (Assistant Manager) - User's interface, approval authority
  ↓
ECOS (Chief of Staff) - Agent lifecycle, team management
  ↓ ↓ ↓
EAA (Architect)  EOA (Orchestrator)  EIA (Integrator)

3.2 Who Messages Whom

3.3 Label Prefix for GitHub (Single-Account Mode)

All plugins use assign: prefix for agent assignment labels:

# Assign task to agent
gh issue edit <number> --add-label "assign:<agent-name>"

# Query agent's tasks
gh issue list --label "assign:<agent-name>"

3.4 Status Labels

3.5 Cross-Plugin Conflict Resolution

When multiple agents need to modify the same resources (labels, issues), follow conflict resolution protocol.

See references/conflict-resolution.md for:

• Authority hierarchy (EAMA > ECOS > EOA > EIA > EAA)
• Label conflict resolution rules
• Label change request protocol with message template
• Emergency override cases (agent terminated, unresponsive, critical blocker)

3.6 Escalation Order and Priority

Escalation is based on order, priority, and state transitions - not fixed time intervals (agents may hibernate for days).

See references/escalation-protocol.md for:

• 4-step escalation order (Send → First Reminder → Urgent Reminder → Escalate/Reassign)
• State-based triggers (No ACK, No Progress, Stale, Unresponsive)
• Priority escalation rules (Normal → High → Urgent → User)
• Deployment-specific timing considerations

4. Record-Keeping Standards

All emasoft plugins follow consistent record-keeping standards for delegation logs, status reports, and handoff documents.

See references/record-keeping.md for:

• Standard docs_dev/ directory structure for each plugin (orchestration, integration, design, chief-of-staff, projects, reports)
• Filename conventions (timestamped, task-based, PR-based, date-based)
• Log entry markdown format with timestamp, agent, action, status, details, output

Examples

See references/examples.md for:

• Full task assignment flow (13-step workflow from user request to completion)
• Complete curl command examples for task assignment, status request, and escalation
• Working code snippets you can copy and modify

Output

Error Handling

Quick Reference Card

Resources

• AGENT_OPERATIONS.md - Core orchestrator workflow
• eoa-label-taxonomy - GitHub label usage
• eoa-task-distribution - Task assignment protocol
• eoa-progress-monitoring - Agent state tracking
• AI Maestro AMP messaging
• AI Maestro Message Templates - Curl command templates

Converted and distributed by TomeVault — claim your Tome and manage your conversions.