~/codigoagente
Agentes de IA

Los 72 agentes de ECC: cuáles usar, cuándo y cómo llamarlos en Claude Code

Al final del artículo tienes el comando, el prompt listo para copiar y un .md para descargar.

Los agentes de ECC son 72 subagentes de Claude Code con una tarea acotada cada uno: planificar (planner, architect), revisar código por lenguaje (typescript-reviewer, python-reviewer…), arreglar builds (go-build-resolver, rust-build-resolver…), cazar errores silenciosos o auditar seguridad. Para empezar te bastan cinco: planner, code-reviewer, security-reviewer, el revisor de tu lenguaje y build-error-resolver.

Esta es la parte 4 de la guía completa de ECC. Aquí verás cómo se reparten los 72, qué modelo usa cada familia, cómo se llaman (por comando, por nombre o solos) y una prueba real con silent-failure-hunter, que encontró un fallo que la revisión normal no vio.

Qué es un subagente y por qué ECC tiene tantos

Un subagente es un archivo Markdown en agents/ con un frontmatter (nombre, descripción, herramientas permitidas y modelo) y unas instrucciones. Claude Code lo lanza en un contexto separado: trabaja, devuelve un informe y su conversación no ensucia la tuya.

snippettext
---
name: code-reviewer
description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability.
tools: Read, Grep, Glob, Bash
model: sonnet
---

ECC tiene 72 porque cubre muchos lenguajes y tareas, no porque tengas que usarlos todos. Cada uno solo ocupa contexto cuando se usa; lo que sí ocupa siempre es su descripción, que Claude Code lee para decidir cuándo delegar.

Cómo se reparten los 72 agentes

Los 72 agentes por familia, contados en el commit 4adeee6 · codigoagente
FamiliaCuántosEjemplos
Planificar y diseñar8`planner`, `architect`, `code-explorer`, `spec-miner`
Revisores por lenguaje y stack24`typescript-reviewer`, `python-reviewer`, `go-reviewer`, `django-reviewer`, `database-reviewer`
Revisión de calidad10`code-reviewer`, `security-reviewer`, `silent-failure-hunter`, `refactor-cleaner`
Arreglar builds12`build-error-resolver`, `rust-build-resolver`, `pytorch-build-resolver`
Tests y docs4`tdd-guide`, `e2e-runner`, `doc-updater`, `docs-lookup`
Operar agentes5`loop-operator`, `harness-optimizer`, `chief-of-staff`
Generar con GAN3`gan-planner`, `gan-generator`, `gan-evaluator`
Open source, marketing y red6`opensource-sanitizer`, `seo-specialist`, `network-troubleshooter`

Modelos: 62 agentes usan sonnet, 6 haiku (los de documentación, comentarios y empaquetado open source) y solo 4 opus: planner, architect, spec-miner y healthcare-reviewer. Si tienes suscripción Pro, ten en cuenta que esos cuatro consumen más cuota.

Tres formas de llamar a un agente

1. A través de un comando. Es lo más cómodo. Cada comando principal tiene su agente detrás:

Quieres…UsaAgente
Planificar una funcionalidad`/ecc:plan "…"``planner`
Revisar lo que acabas de escribir`/ecc:code-review``code-reviewer`
Arreglar un build roto`/build-fix``build-error-resolver`
Buscar vulnerabilidades`/security-scan``security-reviewer`
Quitar código muerto`/refactor-clean``refactor-cleaner`
Revisar Go o Python`/go-review`, `/python-review``go-reviewer`, `python-reviewer`
Actualizar la documentación`/update-docs``doc-updater`

2. Por su nombre. Algunos no tienen comando (por ejemplo typescript-reviewer, fsharp-reviewer o silent-failure-hunter). Pídeselo a Claude: "usa el subagente ecc:typescript-reviewer para revisar src/". Con el plugin llevan el prefijo ecc:.

3. Solos. Las descripciones de varios dicen "Use PROACTIVELY": Claude Code puede delegar en ellos sin que se lo pidas. database-reviewer, por ejemplo, se activa cuando hay consultas a la base de datos.

Prueba real: silent-failure-hunter

En la parte 3 construimos un endpoint POST /orders con 19 tests en verde y lo pasamos por /ecc:code-review, que dio 9 hallazgos. Luego lanzamos solo este agente sobre el mismo app.js:

snippettext
Usa el subagente ecc:silent-failure-hunter para revisar app.js. Devuélveme su informe tal cual, en español y breve.

Tardó 24 segundos y el CLI reportó 0,16 USD. Encontró 8 puntos, y el más grave no estaba en la revisión general:

  • En el catch que devuelve 500, sendJson puede volver a lanzar si las cabeceras ya se enviaron. Eso deja una promesa rechazada sin manejar en un handler async, y en Node puede tumbar el proceso. Propone comprobar res.headersSent y registrar método y URL.
  • El catch {} del JSON.parse descarta el error original: el cliente solo ve invalid_json y depurar se complica.
  • Un cliente que corta la conexión a mitad de subida acaba como un 500 falso; hay que tratar ECONNRESET y aborted aparte.

También coincidió con la revisión general en el 404 en texto plano y en /products aceptando cualquier método. La lección: los agentes especializados ven cosas que el revisor general no prioriza. No los lances todos; lanza el que corresponde al riesgo de tu cambio.

Cuidado con consult: elige tú, no el buscador

ECC trae un buscador de componentes en lenguaje natural. Le preguntamos por revisión de código y seguridad para una app de Next.js:

terminalsh
npx ecc-universal@2.2.3 consult "code review and security for a Next.js app" --target claude
consult recomendó fsharp-reviewer para una app de Next.js · codigoagente

Acertó con capability:security, code-reviewer y security-review, pero en tercer lugar recomendó fsharp-reviewer para una app de Next.js, solo porque coincidían las palabras "code" y "review". El buscador empareja palabras clave, no entiende tu stack. Úsalo como punto de partida y añade tú typescript-reviewer y react-reviewer.

Qué agentes usar según tu stack

Tu proyectoAgentes recomendados
Next.js / React + TypeScript`typescript-reviewer`, `react-reviewer`, `react-build-resolver`, `e2e-runner`
API en Python (Django o FastAPI)`python-reviewer`, `django-reviewer` o `fastapi-reviewer`, `django-build-resolver`, `database-reviewer`
Backend en Go`go-reviewer`, `go-build-resolver`, `database-reviewer`
Rust`rust-reviewer`, `rust-build-resolver`
Android / Kotlin`kotlin-reviewer`, `kotlin-build-resolver`
iOS / Swift`swift-reviewer`, `swift-build-resolver`
Laravel / PHP`php-reviewer` (y las skills `laravel-*`)
RAG o ML en producción`rag-pipeline-reviewer`, `mle-reviewer`, `pytorch-build-resolver`
Cualquiera, antes de producción`security-reviewer`, `silent-failure-hunter`, `performance-optimizer`

Si solo instalas unos pocos a mano, cópialos a ~/.claude/agents/ y listo; cada agente es un archivo independiente:

terminalsh
git clone https://github.com/affaan-m/ECC.git
mkdir -p ~/.claude/agents
cp ECC/agents/{planner,code-reviewer,security-reviewer,typescript-reviewer,build-error-resolver,silent-failure-hunter}.md ~/.claude/agents/

Agentes que no vas a necesitar (al principio)

  • gan-planner, gan-generator, gan-evaluator: un flujo generador-evaluador para construir productos desde una línea. Interesante, pero la ruta de shell en macOS tiene un error abierto (#2674).
  • loop-operator: vigila bucles autónomos largos. Útil cuando ya automatizas mucho, no el primer día.
  • chief-of-staff: tría correo, Slack y mensajería. No tiene que ver con programar.
  • opensource-forker, -packager, -sanitizer: para publicar como open source un proyecto interno sin filtrar secretos.

Preguntas frecuentes

¿Puedo cambiar el modelo de un agente? Sí: edita la línea model: de su frontmatter. Por ejemplo, pasar planner de opus a sonnet si te preocupa la cuota.

¿Los agentes pueden modificar mi código? Depende de su línea tools:. planner solo tiene Read, Grep, Glob (no puede escribir); build-error-resolver y tdd-guide tienen Write y Edit.

¿Qué es el bloque "Prompt Defense Baseline"? Todos los agentes empiezan con unas reglas para no cambiar de rol, no revelar secretos y no generar código ejecutable sin necesidad. Es una defensa básica contra prompt injection, no una garantía.

Conclusión

De los 72 agentes de ECC, cinco cubren casi todo el trabajo diario: planner, code-reviewer, security-reviewer, el revisor de tu lenguaje y el build resolver de tu stack. Añade silent-failure-hunter antes de cada despliegue: en nuestra prueba encontró el único fallo capaz de tumbar el proceso. En la parte 5 veremos cómo elegir skills y reglas para no cargar contexto que no usas.

// recurso · úsalo directamente

Los agentes de ECC que de verdad vas a usar

Copia solo los agentes que encajan con tu stack y deja que el prompt te ayude a elegir el resto. Funciona con Claude Code 2.1 o superior.

Licencia del repositorio: MIT

1. Instala

Los 6 agentes base, a mano
git clone https://github.com/affaan-m/ECC.git
mkdir -p ~/.claude/agents
cp ECC/agents/{planner,code-reviewer,security-reviewer,build-error-resolver,silent-failure-hunter,tdd-guide}.md ~/.claude/agents/
Todos los agentes con el plugin
npx ecc-universal@2.2.3 setup

2. Elige tu caso

Pega este prompt en tu agente
Tengo los agentes de ECC disponibles. Este proyecto es <stack: p. ej. Next.js + TypeScript + Postgres>.

1. Lee los nombres y descripciones de ~/.claude/agents/ (o del plugin ecc) y dime qué 5-6 agentes encajan con este stack y para qué usaré cada uno.
2. Añade a CLAUDE.md una sección "Agentes" con: cuándo usar planner, qué revisor lanzar tras cada cambio y que antes de desplegar se ejecute silent-failure-hunter sobre los archivos tocados.
3. No copies ni instales nada más; solo propón y escribe CLAUDE.md.

3. Guía de uso

  1. Pega el prompt en la raíz del proyecto.
  2. Revisa la lista: descarta cualquier revisor de otro lenguaje.
  3. Copia a ~/.claude/agents/ solo los que aprobaste.
Prompt y guía corta en un archivoRepositorioaffaan-m/ECC

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

rea-video es una skill Apache-2.0 que desmonta un vídeo plano a plano: si es real, IA o código, voz, música, subtítulos y cómo rehacerlo. Prueba real y costos.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #3

Parte 3 de la guía: anclaje, decoy, paradoja de la elección, Hick's Law y activation energy aplicados a la página de precios, con ejemplos reales.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #2

Parte 2 de la guía: autoridad, compromiso, escasez real y framing con la skill marketing-psychology, con fragmentos reales reescritos del blog codigoagente.
  • Skills para tus agentes
  • Claude Code
leer artículo