Orchestrator Agent (eoa-)

Version: 1.0.0

Overview

The Orchestrator Agent handles task distribution, agent coordination, and progress monitoring. It receives plans from the Architect and coordinates subagents to implement them.

Core Responsibilities

Task Distribution: Break plans into assignable tasks
Agent Coordination: Manage subagents and remote agents
Progress Monitoring: Track task completion
Module Management: Organize work into modules
Verification: Ensure instructions are followed correctly

Components

Agents

Agent	Description
`eoa-main.md`	Main orchestrator agent
`eoa-team-orchestrator.md`	Coordinates team of agents
`eoa-task-summarizer.md`	Summarizes task progress
`eoa-checklist-compiler.md`	Creates verification checklists
`eoa-docker-container-expert.md`	Docker and container expertise
`eoa-experimenter.md`	Experimentation and prototyping

Commands

Command	Description
`eoa-start-orchestration`	Start orchestration phase
`eoa-register-agent`	Register remote agent
`eoa-assign-module`	Assign module to agent
`eoa-reassign-module`	Reassign module
`eoa-check-agents`	Check agent status
`eoa-add-module`	Add new module
`eoa-modify-module`	Modify module
`eoa-remove-module`	Remove module
`eoa-prioritize-module`	Change module priority
`eoa-orchestrator-loop`	Start orchestration loop
`eoa-orchestrator-status`	Check orchestrator status
`eoa-cancel-orchestrator`	Cancel orchestration

Skills

Skill	Description
`eoa-two-phase-mode`	Two-phase orchestration mode
`eoa-orchestration-commands`	Orchestration command patterns
`eoa-orchestration-patterns`	Orchestration best practices
`eoa-remote-agent-coordinator`	Remote agent coordination
`eoa-module-management`	Module CRUD operations
`eoa-verification-patterns`	Instruction verification
`eoa-developer-communication`	Developer comm patterns
`eoa-checklist-compilation-patterns`	Checklist generation
`eoa-agent-replacement`	Agent replacement handoffs
`eoa-task-distribution`	Task breakdown and assignment
`eoa-progress-monitoring`	Progress tracking and polling
`eoa-messaging-templates`	AI Maestro message formats
`eoa-label-taxonomy`	GitHub label system
`eoa-implementer-interview-protocol`	Interview-based requirements
`eoa-github-action-integration`	GitHub Actions patterns

Hooks

Hook	Event	Description
`eoa-orchestrator-stop`	Stop	Block exit until tasks complete
`eoa-instruction-verification-check`	PreToolUse	Verify instructions before work
`eoa-polling-reminder`	UserPromptSubmit	Remind to poll progress
`eoa-file-tracker`	PostToolUse	Track file modifications

Workflow

Receives plan from Architect (via Assistant Manager)
Creates modules from plan
Assigns modules to agents
Monitors progress via polling
Handles failures and reassignments
Reports completion to Assistant Manager
Hands off to Integrator for quality gates

Installation (Production)

Install from the Emasoft marketplace. Use --scope local to install only for this agent's directory only, or --scope global for all projects.

Role plugins are installed with --scope local inside the specific agent's working directory (~/agents/<agent-name>/). This ensures the plugin is only available to that agent.

# Add Emasoft marketplace (first time only)
claude plugin marketplace add emasoft-plugins --url https://github.com/Emasoft/emasoft-plugins

# Install plugin (--scope local = this agent's directory only, recommended)
claude plugin install emasoft-orchestrator-agent@emasoft-plugins --scope local

# RESTART Claude Code after installing (required!)

Once installed, start a session with the main agent:

claude --agent eoa-orchestrator-main-agent

Development Only (--plugin-dir)

--plugin-dir loads a plugin directly from a local directory without marketplace installation. Use only during plugin development.

claude --plugin-dir ./OUTPUT_SKILLS/emasoft-orchestrator-agent

Validation

cd OUTPUT_SKILLS/emasoft-orchestrator-agent
uv run python scripts/validate_plugin.py . --verbose

Name	eoa-handoff-protocols
Description	Use when accessing shared reference documents used across multiple Orchestrator Agent skills. Trigger with shared resource lookups.

eoa-handoff-protocols

SKILL.md