Integrator Agent (eia-)
Version: 1.0.0
Overview
The Integrator Agent handles quality gates, testing, merging, and release candidates. It ensures code quality before integration into the main branch.
Core Responsibilities
- Code Review: Review PRs for quality and correctness
- Quality Gates: Enforce TDD, tests, and standards
- Branch Protection: Prevent direct pushes to protected branches
- Issue Closure Gates: Verify requirements before closing issues
- GitHub Integration: Manage PRs, issues, and projects
Components
Agents
| Agent | Description |
|---|
eia-integrator-main-agent.md | Main integrator agent |
eia-api-coordinator.md | Coordinates GitHub API operations |
eia-bug-investigator.md | Investigates reported bugs |
eia-code-reviewer.md | Reviews code for quality |
eia-committer.md | Handles git commit operations |
eia-debug-specialist.md | Debugs CI/CD and test failures |
eia-github-sync.md | Syncs GitHub state |
eia-integration-verifier.md | Verifies integration success |
eia-pr-evaluator.md | Evaluates PR readiness |
eia-screenshot-analyzer.md | Analyzes screenshots for visual regressions |
eia-test-engineer.md | Manages test execution and coverage |
Skills
| Skill | Description |
|---|
eia-github-integration | GitHub API integration |
eia-github-pr-workflow | PR workflow patterns |
eia-github-pr-checks | PR check patterns |
eia-github-pr-merge | PR merge strategies |
eia-github-pr-context | PR context management |
eia-github-issue-operations | Issue CRUD operations |
eia-kanban-orchestration | Kanban board patterns |
eia-github-projects-sync | Projects sync |
eia-github-thread-management | Thread management |
eia-code-review-patterns | Code review patterns |
eia-multilanguage-pr-review | Multi-language reviews |
eia-tdd-enforcement | TDD enforcement |
eia-ci-failure-patterns | CI failure patterns |
eia-git-worktree-operations | Worktree operations |
eia-integration-protocols | Shared utilities |
Hooks
| Hook | Event | Description |
|---|
eia-branch-protection | PreToolUse | Block pushes to main/master |
eia-issue-closure-gate | PreToolUse | Verify before issue closure |
Quality Gates
- Branch Protection: No direct pushes to main/master
- Issue Closure Gate: Requires:
- Merged PR linked to issue
- All checkboxes checked
- Evidence of testing
- TDD compliance
Workflow
- Receives completion signal from Orchestrator
- Reviews code changes
- Runs quality gates
- Verifies tests pass
- Creates/reviews PR
- Merges when approved
- Reports to Assistant Manager
Installation (Production)
Install from the Emasoft marketplace. 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-integrator-agent@emasoft-plugins --scope local
# RESTART Claude Code after installing (required!)
Once installed, start a session with the main agent:
claude --agent eia-integrator-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-integrator-agent
Validation
cd OUTPUT_SKILLS/emasoft-integrator-agent
uv run python scripts/validate_plugin.py . --verbose
Emasoft
