Creación de subagentes especializados en Claude Code

Resumen

Optimiza la entrega de funcionalidades complejas con subagentes especializados que trabajan en paralelo. Aquí se muestra, paso a paso, cómo crear e invocar subagentes de frontend y backend en Claude Code para planear el sistema de ratings en Platiflix, sin generar código y con foco en fases claras y ejecutables.

¿Cómo se diseñan e invocan subagentes en Claude Code?

Crear subagentes especializados permite dividir responsabilidades y acelerar resultados. El contexto parte del plan del subagente arquitecto, que definió el alcance para backend y frontend del sistema de ratings.

¿Dónde viven los agentes y cómo se crean archivos prompt?

Los agentes están en la carpeta agents dentro de la carpeta .cloud.
Se preparan dos prompts y se crean backend.markdown y frontend.markdown.
El prompt de frontend define su especialidad y el stack: Next, React, TypeScript.
El prompt de backend define su especialidad y el stack: FastAPI, Python, SQLAlchemy.
La lógica de ambos prompts va de lo general a lo específico: del estado del stack a sus tareas concretas en el proyecto.

¿Cuál es la diferencia entre invocación explícita e implícita?

Invocación explícita: usar @agent para elegir frontend, backend o architect.
Invocación implícita: redactar el prompt para que Claude Code decida qué subagentes activar.
Se solicita: analizar el resultado del arquitecto sobre el sistema de ratings y crear un plan de implementación para backend y frontend en paralelo.
Se pide explícitamente: no generar código, solo fases claras de implementación.

¿Qué incluye el plan de implementación para frontend?

El subagente de frontend arranca con un análisis del proyecto y detalla fases enfocadas en el sistema de ratings. La estructura es clara, accionable y alineada al stack.

¿Cómo analiza el contexto y los patrones de desarrollo?

Revisa la arquitectura actual del frontend.
Describe la estructura de componentes existente.
Identifica patrones de desarrollo presentes en el proyecto.
Explica decisiones desde el enfoque general del stack hasta responsabilidades puntuales.

¿Cuáles son las fases y consideraciones de frontend?

Definir nuevas interfaces para rating.
Crear los nuevos tipos o interfaces necesarios para soportar ratings.
Enumerar consideraciones de implementación y compatibilidad.
Proponer fases con sentido y alcance verificable.
Se aprueba la edición del archivo generado por el subagente.

¿Qué abarca el plan de backend y cómo se controla la ejecución?

El subagente de backend estructura el trabajo desde la base de datos y cubre operaciones críticas como migraciones y rollback (downgrade), alineado con la recomendación del arquitecto de empezar por lo fundamental.

¿Cuáles son las fases clave del backend?

Iniciar por la base de datos: crear migraciones y definir su estructura.
Incluir los comandos necesarios para aplicar las migraciones.
Documentar qué hacer en caso de rollback mediante downgrade.
Mantener enfoque incremental y comprobable por fases.
Resultado: plan “100% implementable de forma secuencial”, con fases independientes y sin código, solo especificaciones detalladas.

¿Cómo orquestar subagentes y monitorear su progreso?

Ejecución en paralelo: Claude Code invoca a ambos subagentes y envía prompts específicos a cada uno.
Lista de tareas: con Ctrl+T se visualizan los to-dos, que se tachan al completarse.
Aislamiento de contexto: cada subagente opera con memoria separada del resto.
Comando context: muestra el uso de memoria del sistema y de cada agente.
Métricas de tokens: el system prompt utiliza cerca de 2.2 mil tokens; las herramientas del sistema y los MCPS también consumen tokens; cada agente personalizado incrementa su uso conforme avanza la ejecución.
Archivos en carpeta spec: se generan documentos de especificación para frontend ratings y backend ratings; se puede ajustar su numeración para ordenar las fases.

¿Listo para llevar estas fases al código? Comparte en comentarios cómo organizarías las tareas entre frontend y backend en tu equipo.