~/codigoagente
Agentes de IA

El flujo diario con ECC: /plan, TDD, code review y build-fix en un proyecto real

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

El flujo diario de ECC en Claude Code son cuatro pasos: /ecc:plan para que el agente proponga un plan y espere tu confirmación, la skill tdd-workflow para implementar con tests que fallan primero, /ecc:code-review para que un revisor con contexto limpio busque fallos y /build-fix cuando algo no compila. Lo probamos sobre una API pequeña en Node: 19 tests en verde y una revisión con 9 hallazgos.

Esta es la parte 3 de la guía completa de ECC. Si aún no lo tienes, empieza por la parte 2: instalar ECC sin duplicar nada. Aquí verás cada paso con su salida real, cuánto tardó y cuánto costó en tokens, para que sepas qué esperar en tu propio proyecto.

El proyecto de prueba

Partimos de tienda-api, un servidor de node:http de 7 líneas con un único endpoint GET /products y un catálogo en memoria (una camiseta de 15 y una taza de 8). Sin framework, sin dependencias y sin tests: el punto de partida típico de un prototipo.

La tarea: añadir POST /orders, que crea un pedido con productos existentes y calcula el total.

Entorno: Claude Code 2.1.329 con ECC 2.2.3 cargado como plugin (--plugin-dir), modelo Sonnet y modo no interactivo (claude -p) para poder repetir la prueba. Fecha: 20 de noviembre de 2026.

Paso 1: /ecc:plan antes de tocar el código

snippettext
/ecc:plan "Añadir un endpoint POST /orders que crea un pedido con productos existentes y calcula el total"

El comando tiene una regla clara en su definición: reformular los requisitos, buscar patrones en el código, dividir en fases, evaluar riesgos y esperar tu confirmación antes de escribir nada. Y lo cumplió:

El plan de /ecc:plan: requisitos, fases, riesgos y las decisiones que asumió · codigoagente

Lo que más valor tuvo no fueron las fases, sino dos bloques:

  • Riesgos: detectó que el cliente podría mandar su propio precio y decidió calcular el total solo con el catálogo del servidor. También propuso limitar el tamaño del cuerpo (413).
  • Decisiones asumidas: fusionar líneas con el mismo productId, devolver 422 si el producto no existe, separar app.js de server.js para poder testear. Te las enseña para que digas si quieres otra cosa.

Tardó 56 segundos. El CLI reportó un coste de 0,37 USD (precio de API, con Sonnet).

Este paso es el que más ahorra: corregir una decisión en el plan cuesta una línea; corregirla en el código, una tarde. Si quieres profundizar en esa forma de trabajar, el capítulo 4 de la guía Claude Code de cero a producción explica cómo planificar antes de programar.

Paso 2: implementar con tdd-workflow

Respondimos al plan con:

snippettext
yes. Implementa el plan siguiendo la skill tdd-workflow (test que falla primero, luego código). Ejecuta npm test al final y resume qué tests pasaron.

La skill tdd-workflow impone el ciclo RED → GREEN → REFACTOR. El agente:

  1. Refactorizó primero sin cambiar comportamiento: app.js con createApp() y server.js reducido a 2 líneas.
  2. RED: escribió orders.test.js con node:test. Sin la lógica de pedidos, pasaban 2 tests (los de regresión de /products y del 404) y fallaban 17.
  3. GREEN: implementó readJson, buildOrder y la ruta. Pasaron los 19.
  4. Midió la cobertura: 98,5 % de líneas y de ramas; solo quedaba sin cubrir el catch que devuelve 500.
npm test después de la implementación: 19 de 19 · codigoagente

Los tests no son de relleno: cubren que el precio enviado por el cliente se ignora, cantidades 0, negativas, decimales o en texto, items vacío, JSON inválido, cuerpo de más de 100 KB y GET /orders (405).

Tardó 73 segundos y el CLI reportó 0,64 USD.

Un detalle honesto: la skill recomienda hacer commits de control tras RED y tras GREEN, y el agente no los hizo porque no se los pedimos. Si quieres ese historial, dilo en el prompt.

Paso 3: /ecc:code-review con contexto limpio

En una sesión nueva (contexto vacío, sin saber cómo se escribió el código):

snippettext
/ecc:code-review

Sin argumentos revisa los cambios sin commitear: lista los archivos con git diff, los lee enteros y busca primero problemas de seguridad (críticos) y luego de calidad.

El revisor no encontró nada crítico, pero sí 4 hallazgos medios y 5 bajos · codigoagente

Resultado: ningún problema crítico ni alto, así que no bloquea el commit. Pero encontró cosas que el agente que escribió el código pasó por alto:

  • req.url se compara tal cual, así que /products?x=1 devuelve 404. Propone new URL(req.url, 'http://x').pathname.
  • El 404 responde texto plano cuando todos los demás errores son JSON.
  • Tras un 413 no se vacía el resto del cuerpo ni se envía Connection: close: la conexión puede quedarse abierta.
  • El array orders crece sin límite en un proceso de larga duración.
  • Faltan tests de redondeo con decimales y de cuerpos null o [].

Tardó 25 segundos y costó 0,31 USD. Ojo: en esta sesión no le dimos permiso para ejecutar npm test, y lo avisó al principio ("la revisión es solo de lectura de código"). Si se lo permites, los ejecuta.

Si quieres comparar con otros revisores, en el blog probamos Open Code Review de Alibaba y las skills implement y code-review.

Paso 4: /build-fix cuando no compila

En nuestra API no hubo build roto, así que no lo forzamos. Lo que hace, según su definición:

  1. Detecta el sistema de build: npm run build o pnpm build si hay script, npx tsc --noEmit en TypeScript, cargo build, go build ./..., mvn compile, ./gradlew compileJava o mypy ..
  2. Agrupa los errores por archivo y los arregla uno a uno con el cambio mínimo, volviendo a compilar tras cada arreglo.
  3. No toca la arquitectura: el agente build-error-resolver tiene prohibido hacer cambios grandes para que el build pase.

Es el comando que usarás cuando actualices una dependencia y aparezcan 40 errores de tipos.

Cuánto cuesta y cuánto tarda el flujo completo

PasoTiempoCoste reportado por el CLI
`/ecc:plan`56 s0,37 USD
Implementación con `tdd-workflow`73 s0,64 USD
`/ecc:code-review`25 s0,31 USD
**Total****2 min 34 s****1,32 USD**

Son precios de API con Sonnet en una tarea pequeña. Con suscripción Pro o Max no pagas por token, pero consume tu cuota. En una tarea mayor el plan y la revisión crecen poco; la implementación es la que escala.

Errores frecuentes en el flujo

  • Saltarte el plan. Si pides el código directamente, ECC no te obliga a planificar. Ponlo en tu CLAUDE.md: "usa /ecc:plan antes de cualquier funcionalidad nueva".
  • Revisar en la misma sesión. El valor de /ecc:code-review es el contexto limpio. Ábrelo en una sesión nueva o con /clear antes.
  • Pedir TDD sin nombrar la skill. "Hazlo con tests" no es lo mismo que "sigue tdd-workflow": la skill fija el orden RED → GREEN y la cobertura del 80 %.
  • Usar /tdd o /verify. En la v2.2 esos atajos se retiraron a legacy-command-shims/. Usa las skills tdd-workflow y verification-loop.

Preguntas frecuentes

¿Funciona con prompts en español? Sí. Le pasamos la tarea en español y el plan salió en español.

¿Puedo usar el flujo sin instalar todo ECC? Sí: con el instalador selectivo puedes copiar solo tdd-workflow, security-review y los comandos que uses (--skills tdd-workflow,security-review).

¿Y si el plan no me gusta? Responde modify: [cambios]. El comando está diseñado para iterar sobre el plan hasta que respondas yes.

Conclusión

El flujo de ECC no hace al agente más listo: lo hace más ordenado. Planificar primero, testear antes de implementar y revisar con otra sesión encontró 9 cosas que mejorar en código que ya pasaba 19 tests. Empieza mañana por /ecc:plan en tu próxima tarea. En la parte 4 vemos los 72 agentes de ECC y cuáles usar según tu stack.

// recurso · úsalo directamente

Flujo plan → TDD → review de ECC listo para pegar

Con ECC instalado como plugin (`ecc@ecc`), pega el prompt que encaje con tu proyecto. Funciona con Claude Code 2.1 o superior.

Licencia del repositorio: MIT

1. Instala

Plugin con asistente guiado
npx ecc-universal@2.2.3 setup
Solo las piezas del flujo (instalador desde el repositorio)
git clone https://github.com/affaan-m/ECC.git && cd ECC && npm install
./install.sh --target claude --skills tdd-workflow,security-review

2. Elige tu caso

Pega este prompt en tu agente
Vamos a construir esta funcionalidad con el flujo de ECC: <describe la funcionalidad>.

1. Ejecuta /ecc:plan con esa descripción. Enséñame requisitos, fases, riesgos y las decisiones que asumes, y espera mi "yes" o "modify".
2. Cuando lo apruebe, implementa con la skill tdd-workflow: primero los tests que fallan (enséñame cuántos fallan), luego el código mínimo hasta verde y después refactor.
3. Haz un commit tras RED y otro tras GREEN con Conventional Commits.
4. Ejecuta los tests al final y dime la cobertura.
5. No añadas dependencias sin preguntarme.

3. Guía de uso

  1. Pega el prompt y lee el plan con calma: corrige ahí cualquier decisión que no te guste.
  2. Aprueba con yes.
  3. Cuando termine, abre una sesión nueva y ejecuta /ecc:code-review.
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