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

Name	eia-worktree-management
Description	Use when managing Git worktrees for parallel development with registry tracking and port allocation. Trigger with /manage-worktrees.

eia-worktree-management

SKILL.md