Saltar al contenido
← La bóveda
AgentesClaude a fondo

Tu equipo de 4 agentes en Claude Code: arquitecto, programador, tester y jefe

Cuatro agentes listos para copiar que planifican, programan, buscan fallos y te resumen lo importante. Cómo crearlos en un minuto y cómo darles el primer encargo sin saber programar.

Por Félix Go · Publicado el

4agentes
con un trabajo cada uno
1bloque
para copiar y pegar
Tú
decides; ellos ejecutan

Pedirle a Claude «hazme una web» y que lo haga todo de una vez sale regular: planifica, programa y se da el visto bueno a sí mismo. Con un equipo, cada agente hace una sola cosa y el tester se dedica a buscarle fallos al programador. Tú solo revisas el resultado.

En resumen: en Claude Code puedes crear subagentes: ayudantes con su propio trabajo e instrucciones. Pegas el bloque de esta guía y Claude te crea cuatro: el arquitecto (hace el plan y te pregunta lo importante), el programador (hace solo lo que dice el plan), el tester (intenta romperlo) y el jefe (te resume en 5 líneas qué está hecho y qué necesita de ti). Después les das algo pequeño, como una página de lista de espera, y revisas como si fueras el jefe del proyecto.

Antes de nada

  • Necesitas Claude Code, con un plan de pago de Claude. Lo más fácil: la pestaña Code de la app de Claude para ordenador.
  • Gasta más límite que un chat normal. Cada agente trabaja por su cuenta y todo cuenta para tu límite de uso. Por eso se empieza con algo pequeño.
  • No hace falta saber programar. Sí hace falta saber qué quieres y para quién. Esa parte es tuya.
Agente Su único trabajo Qué puede tocar
arquitecto Te hace preguntas y escribe el plan en pasos Solo lee e investiga. No escribe código
programador Hace el paso del plan que toca, nada más Puede crear y editar archivos
tester Busca fallos: móvil, campos vacíos, textos largos Lee y prueba. No arregla nada
jefe Te resume en 5 líneas y te dice qué decidir Solo lee

Paso 1: crea el equipo

  1. Abre la pestaña Code de la app de Claude.
  2. Copia este bloque y pégalo en el chat. Claude crea los cuatro archivos (si te pide permiso para escribir, acepta).
  3. Cierra esa conversación y abre una nueva. El equipo ya está disponible en todos tus proyectos.
Crea 4 subagentes en la carpeta ~/.claude/agents/ (un archivo .md por agente) con este contenido exacto, sin cambiar nada. Cuando termines, dime los 4 nombres.

=== Archivo: arquitecto.md ===
---
name: arquitecto
description: Convierte una idea en un plan por pasos antes de programar nada. Úsalo siempre al empezar un encargo nuevo.
tools: Read, Glob, Grep, WebSearch, Write
---
Eres el arquitecto del equipo. Antes de planificar, hazme como mucho 5 preguntas sobre para quién es, qué tiene que conseguir y qué límites hay (presupuesto, plazos, herramientas). Cuando te conteste, escribe el plan en el archivo PLAN.md de la carpeta del proyecto: pasos pequeños y numerados, cada uno con cómo comprobar que está bien hecho. No escribas código. Si algo no está claro, pregunta en vez de suponer.

=== Archivo: programador.md ===
---
name: programador
description: Hace un paso concreto de PLAN.md. Úsalo después del arquitecto, un paso cada vez.
---
Eres el programador del equipo. Lee PLAN.md y haz solo el paso que te pidan, sin añadir funciones que nadie ha pedido. Si el plan no está claro o crees que está mal, para y explica por qué. Al terminar, marca el paso como hecho en PLAN.md y resume en 3 líneas qué has cambiado.

=== Archivo: tester.md ===
---
name: tester
description: Busca fallos en lo que ha hecho el programador. Úsalo después de cada paso terminado.
tools: Read, Glob, Grep, Bash
---
Eres el tester del equipo. Tu único trabajo es encontrar fallos en lo que se acaba de hacer: cómo se ve en el móvil, campos vacíos, textos muy largos, enlaces rotos, errores al abrirlo. No arregles nada. Devuelve una lista de fallos, cada uno con cómo reproducirlo y lo grave que es (alto, medio o bajo). Si no encuentras nada, dilo y explica qué has probado.

=== Archivo: jefe.md ===
---
name: jefe
description: Revisa el trabajo del equipo y resume lo importante para el dueño. Úsalo al final de cada vuelta.
tools: Read, Glob, Grep
---
Eres el jefe de equipo. Revisa PLAN.md y lo que han hecho el programador y el tester. Dame un resumen de 5 líneas como máximo: qué está hecho, qué falla todavía y qué decisión necesitas de mí. Sin tecnicismos: escribe para alguien que no programa.

Por qué el plan va en un archivo: cada agente empieza sin ver tu conversación. PLAN.md es la libreta compartida del equipo: el arquitecto lo escribe, el programador lo sigue y el jefe lo revisa.

Paso 2: dales el primer encargo

  1. Crea una carpeta vacía para el proyecto y ábrela en Claude Code.
  2. Pega esto, cambiando lo que va entre corchetes:
Quiero [una página de lista de espera para mi curso de cerámica, con un formulario de email].
Usa el agente arquitecto para hacer el plan y espera a que te diga «adelante».
Después, para cada paso: el programador lo hace y el tester lo revisa. Si el tester encuentra fallos altos o medios, el programador los arregla antes de pasar al siguiente.
Al final, el jefe me resume.

Buenos primeros encargos: una página de lista de espera, una calculadora de presupuesto para tu web, una plantilla de factura o una pequeña herramienta interna. Malos: «mi app de un millón». Si el primero sale bien, ya subirás.

Paso 3: revisa como el jefe

  • Lee el resumen del jefe y abre el resultado. No hace falta que mires el código: mira si hace lo que querías.
  • Di qué está mal con tus palabras: «el botón no se ve en el móvil», «el texto suena muy frío». El equipo hace otra vuelta.
  • Repite hasta que te guste. Normalmente son 2 o 3 vueltas.

También puedes llamar a uno solo: «usa al tester para revisar la web que ya tengo» o escribe @ y elige al agente de la lista.

Si algo no funcionaLos tres fallos más comunes
  • No aparecen los agentes: cierra la app de Claude y vuelve a abrirla. La primera vez que se crea la carpeta de agentes puede necesitar un reinicio.
  • Se gasta el límite muy rápido: encargos más pequeños, o pide que el tester solo revise al final y no después de cada paso.
  • El programador hace cosas que no pediste: dile al arquitecto que haga pasos más pequeños y concretos.
Para ir más alláCuando ya te funcione

Cada agente es un archivo de texto en ~/.claude/agents/. Puedes abrirlo y cambiarle las instrucciones, o pedirle a Claude: «haz que el tester también revise la ortografía». Y puedes crear otros: un redactor, un revisor de SEO o uno que compruebe la parte legal.

Siguiente paso: si el equipo te come el límite, el truco del becario manda el trabajo pesado a Haiku. Y si todavía no tienes clara la idea que construir, pásala antes por los 100 compradores simulados.

Fuentes

Tu voto cuenta

¿Sobre qué quieres el próximo recurso?

Preparo los recursos nuevos según lo que más interesa a quien me sigue. Elige el tema que más te gustaría aprender a hacer con IA:

Un clic y listo. No te apunta a nada nuevo.

Hecho

¿Te ha servido?

Cuéntamelo en redes, que me hace ilusión.

Publico un recurso nuevo cada vez que pruebo algo que merece la pena.

Sigue con estos