El Coro — Orquestração de Agentes IA para Claude Code
MichaelH14/el-coro-wl
Orquestrador multi-agente com 27 especialistas para Claude Code
Ver no GitHubPlugin de orquestração que transforma Claude Code em uma equipe coordenada de 27 agentes especializados (arquiteto, revisor, debugger, etc.) com 85 skills e 44 comandos. Inclui workers em background (24/7), hooks pré/pós-execução, persistência de estado em ~/.el-coro/ e dashboard Next.js. White-label pronto para produção com zero perda de estado em atualizações.
Instalação
npx convez-ai MichaelH14/el-coro-wl1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar workflows de desenvolvimento end-to-end (planejamento → código → testes → deploy)
- Escalar análise de código com múltiplos revisores especializados (TS, segurança, performance, DB)
- Monitoramento 24/7 e growth tracking com workers persistentes em VPS
- Suporte técnico automatizado e gestão de tickets via WhatsApp
Veredito

Sistema robusto de orquestração multi-agente para Claude Code com arquitetura sofisticada (27 agentes, hooks, persistência, workers 24/7). Exige setup configuracional e infraestrutura VPS, mas elimina overhead manual de coordenação de especialistas. Melhor para times técnicos que precisam escalar análise/automação de desenvolvimento.
README
A tradução para o português deste README ainda está na fila.
El Coro — Claude Code Plugin
An AI orchestration plugin for Claude Code that turns a single CLI into a coordinated team of specialized agents.
What's inside
| Component | Count |
|---|---|
| Agents | 27 |
| Skills | 85 |
| Commands | 44 |
| Hook scripts | 29 |
| Rules | 13 |
| Workflows | 1 |
| VPS Workers | 4 |
Agents
- Orchestrators:
conductor,qa-gate,genesis,sombra,cortex - Specialists:
planner,architect,api-designer,tdd-guide,debugger,build-resolver,refactor-cleaner,migration-assistant,code-reviewer,ts-reviewer,security-reviewer,performance-profiler,database-reviewer,deploy-validator,e2e-runner,doc-updater,monitor - Business:
growth-engine,support-agent,designer,design-critic,sprite-editor
Skills
Organized across 15 categories: api, brainstorming, database, deploy, el-coro, frontend, growth, operations, security, support, system, testing, typescript, ui, workflow.
Commands
44 slash commands covering planning, execution, QA, deploy, debugging, growth, support, observability, and self-evolution.
Hooks
Pre/Post tool-use hooks for: secret scanning, port safety, deploy guard, type-check, lint-check, console-log warnings, sombra observation (tool use + user prompts), cortex learning, session summary, core-rules re-injection after compaction, build-failure hints, and VPS sync.
Runtime state
All runtime state (sombra profile, session logs, instincts, SQLite store, sync logs) lives OUTSIDE the plugin install, under ~/.el-coro/ — so plugin updates and reinstalls never wipe what the system has learned. Override the location with the EL_CORO_STATE_DIR env var.
VPS Workers (24/7 background)
monitor-worker— health checks on configured servicessupport-worker— ticket polling via optional WhatsApp APIgrowth-worker— daily metrics collectiondashboard— Next.js dashboard with auth
Quick start
1. Install via Claude Code marketplace
Inside a Claude Code session, run:
/plugin marketplace add MichaelH14/el-coro-wl
/plugin install el-coro@el-coro-wl
That's it. El Coro activates on every new session via the SessionStart hook.
Local marketplace (recommended for development): if you forked/cloned the repo and want zero drift between your edits and the installed plugin, add your local clone as the marketplace instead:
claude plugin marketplace add ~/projects/el-coro-wl
claude plugin install el-coro@el-coro-wl
After editing the repo: commit (the pre-commit hook auto-bumps the version) and run claude plugin update el-coro@el-coro-wl to pick up the changes.
2. Configure
After install, the plugin lives under ~/.claude/plugins/cache/el-coro-wl/el-coro/<version>/.
Clone the repo locally to edit your personal config:
git clone https://github.com/MichaelH14/el-coro-wl.git ~/projects/el-coro
cd ~/projects/el-coro
cp config/el-coro.example.json config/el-coro.json
Edit config/el-coro.json with your values:
owner.name/owner.github— your identityvps.host/vps.user— your VPS SSH credentials (optional)services— the services you wantmonitor/growth-engineto tracknotifications.whatsapp— optional, enable if you have a WhatsApp API bridgeproducts— the productsgrowth-engine/support-agentwork on
3. Updates
Updates are automatic when auto-update is enabled (default). To force an update:
/plugin marketplace update el-coro-wl
Contributing / Releasing
If you forked this repo and want to publish updates under your own marketplace:
# One-time setup (enables auto-bump pre-commit hook)
./scripts/install-hooks.sh
From then on, every commit that touches plugin components (agents/, commands/, skills/, hooks/, rules/, dashboard/, vps/, scripts/, BLINDAJE.md) automatically bumps the patch version in .claude-plugin/plugin.json. Users who installed your marketplace get the update on their next Claude Code session.
Manual bump:
node scripts/bump-version.mjs minor # or major
Skip auto-bump for a specific commit (e.g. docs only):
EL_CORO_NO_BUMP=1 git commit -m "docs: ..."
4. (Optional) Deploy VPS workers
If you want the 24/7 background workers (monitor, support, growth, dashboard):
# Set your VPS SSH credentials
export EL_CORO_VPS_HOST=your.vps.ip
export EL_CORO_VPS_USER=your-vps-user
# Deploy
cd vps && ./deploy.sh
Then deploy the dashboard:
cd dashboard && ./deploy.sh
Architecture
Mac (interactive)
- Claude Code session
- Agents, skills, commands, hooks
sombraobserves you;cortexlearns from your corrections- Runtime state persists in
~/.el-coro/(survives plugin reinstalls) - On session close,
sync-to-vps.jsuploads profile + instincts and mirrors agents/skills/commands to the VPS (logged to~/.el-coro/logs/sync.log)
VPS (24/7 background)
- PM2 processes for monitor / support / growth / dashboard
- Reads
config/el-coro.jsonfor services list - Sends alerts to WhatsApp API (if configured) when services go down
- Dashboard at
https://your-domain.com(set up via Cloudflare Tunnel or reverse proxy)
Graceful degradation
- No VPS configured → sync hook exits silently, no VPS features
- No WhatsApp configured → alerts log locally, no push notifications
- No services configured → workers log a message and idle
- The plugin still works fully as a Mac-local agent system
Key files
.claude-plugin/plugin.json— plugin manifest.claude-plugin/marketplace.json— local marketplace entryconfig/el-coro.example.json— config templatehooks/hooks.json— hook declarationsBLINDAJE.md— the iron rules every agent inheritsagents/— one.mdper agentskills/<category>/<name>/SKILL.md— skillscommands/— slash commandsvps/— background workers for 24/7 operationdashboard/— Next.js dashboard
Philosophy
El Coro is built around these principles:
- Nothing self-approves. Every deliverable passes through
qa-gate. - Iron rules, not suggestions. Every agent inherits 12 universal rules (UA-1 to UA-12). See
BLINDAJE.md. - Anti-hallucination by default. Agents verify files, libraries, and commands before suggesting them.
- Continuous learning.
sombraprofiles the user;cortexpromotes patterns to instincts. - Graceful degradation. If a subsystem is missing (VPS, WhatsApp, etc.), the plugin keeps working.
License
MIT — see LICENSE.