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
Emasoft
