Crear subagentes especializados en Claude Code te permite dividir tareas complejas entre expertos virtuales que trabajan en paralelo. Aquí aprendes a configurar un subagente de frontend y otro de backend, e invocarlos simultáneamente para planear la implementación de un sistema de ratings sobre una base de código existente.
¿Dónde se configuran los subagentes en Claude Code?
Los agentes viven dentro de la carpeta .claude/agents del proyecto. Cada uno se define en un archivo Markdown que describe su rol, su stack y sus responsabilidades.
En este flujo ya existe el subagente architect, que en clases anteriores produjo el documento 00-sistema-ratings-cursos. Ese análisis de arquitectura sirve como insumo para los nuevos subagentes [00:30].
¿Cómo defines el prompt de un subagente especializado?
La lógica es ir de lo más general a lo más específico. Cada archivo describe:
- El rol del especialista y su área de dominio.
- El stack técnico del proyecto, por ejemplo Next, React y TypeScript para frontend, o FastAPI, Python y SQLAlchemy para backend.
- Las responsabilidades concretas dentro de la ejecución.
- El contexto operativo en el que se moverá.
Con esa estructura, basta crear frontend.md y backend.md dentro de la carpeta de agentes para tenerlos disponibles [01:30].
¿Qué es un subagente en Claude Code? Es un agente personalizado con un prompt propio y un contexto aislado, pensado para encargarse de un dominio específico dentro de un proyecto.
¿Cómo invocas subagentes de forma explícita o implícita?
Claude Code admite dos formas de invocación y conviene conocer ambas para decidir cuándo usar cada una.
- Explícita: escribes
@agent y eliges de la lista (frontend, backend, architect).
- Implícita: describes la tarea en el prompt y dejas que Claude decida a qué subagentes llamar.
La forma implícita es la que habilita la ejecución en paralelo. En el prompt le pides que analice el documento del architect y que use los subagentes de frontend y backend para crear planes específicos, sin generar código todavía [03:00].
¿Cómo se ejecutan dos subagentes en paralelo?
Claude Code recibe la instrucción y lanza ambos subagentes a la vez. Internamente redacta un prompt derivado para cada uno y los pone a trabajar sobre su dominio.
Mientras corren, puedes usar Control + T para abrir la lista de to do que Claude mantiene viva. Cada tarea se tacha conforme se completa, y puedes ocultar la vista sin detener la ejecución.
¿Cuántos subagentes pueden correr en paralelo? No hay un límite fijo a dos. Puedes orquestar varios al mismo tiempo, siempre que cada uno tenga su rol bien definido.
¿Qué entregan los subagentes de frontend y backend?
Cada subagente devuelve un plan de implementación estructurado en fases, sin código, solo especificaciones de qué y cómo construir.
El plan de frontend parte del análisis de la arquitectura actual, la estructura de componentes y los patrones de desarrollo. Luego enumera las fases: nuevas interfaces y tipos para rating, consideraciones para integrarlos y los pasos siguientes [05:00].
El plan de backend identifica los patrones del código existente, mapea la estructura de directorios y propone fases que arrancan por lo más fundamental: la base de datos. Incluye los comandos para generar migraciones, la estructura de cada migración y el procedimiento de rollback mediante downgrade [06:00].
Al final, Claude resume que el plan es 100% implementable de forma secuencial, con fases independientes y sin código, tal como se solicitó.
¿Cómo se organizan los archivos de especificación?
Los planes se guardan dentro de la carpeta spec con nombres como backend-ratings y frontend-ratings. Puedes renumerarlos para imponer un orden de ejecución, por ejemplo 01-frontend-ratings y 02-backend-ratings, y así dejar claro qué fase va primero.
¿Cómo monitoreas el contexto que consumen los subagentes?
Cada subagente tiene un contexto de ejecución aislado, y eso se inspecciona con el comando context dentro de Claude Code.
Ese comando muestra cómo se reparte la memoria de la conversación entre los distintos componentes:
- El system prompt, que en este caso ocupa 2,200 tokens.
- Las herramientas del sistema y los MCPs, cada uno con su consumo propio.
- Los agentes personalizados del proyecto, con el detalle de tokens por agente.
A medida que ejecutas más subagentes, el conteo total de tokens de la conversación crece. Tener visibilidad sobre eso te ayuda a entender el costo real de orquestar varios especialistas [07:30].
Con los dos planes listos, el siguiente paso es pasar de la planificación a la generación de código. ¿En qué orden ejecutarías tú las fases, frontend o backend primero? Cuéntame en los comentarios.
