Creación de subagentes especializados en Claude Code para planificación

Potencia tu flujo de trabajo con subagentes en Claude Code y crea un plan de implementación sólido para el feature de ratings usando el contexto previo. Aquí verás cómo configurar el subagente Architect, invocarlo dentro de la conversación y documentar el resultado en el proyecto, paso a paso y sin perder trazabilidad.

¿Cómo crear un subagente en Claude Code para el feature de ratings?

Un subagente es un agente especializado con permisos y objetivos claros. La meta: que Architect defina fases, impactos y pasos técnicos para implementar ratings apoyándose en el contexto previo.

¿Cómo retomar el contexto con resume?

• Usa el comando resume para listar conversaciones previas.
• Elige la conversación con el contexto de modificaciones del feature de ratings obtenido con métodos como ultrathink, think deeply y think.
• Recuperar el contexto asegura un análisis técnico coherente con decisiones anteriores.

¿Cómo iniciar agents y elegir alcance del subagente?

• Abre agents para crear un nuevo agente especializado.
• Define el alcance: personal o solo para el proyecto.
• Selecciona creación manual para controlar nombre, descripción y permisos.
• Nómbralo “Architect”: actuará como arquitecto de software para plan de implementación de ratings.

¿Qué configurar en el agente: modelo, tools y system prompt?

Configurar bien al subagente determina su calidad de respuesta y seguridad. Aquí se centra la especialización, herramientas y formato de salida.

¿Qué rol cumple el system prompt y el yaml front matter?

• El system prompt guía el comportamiento del agente: responsabilidades, contexto del proyecto y metodología de análisis.
• Define formato de salida en markdown: análisis técnico del feature, problema identificado, impacto, propuesta de solución y plan de implementación.
• El YAML front matter contiene nombre, descripción, modelo y color.
• La definición se guarda en la carpeta Claude/Agents como archivo markdown del subagente.

¿Qué tools y modelos elegir para el agente?

• Permite herramientas clave: leer archivos, editar, ejecutar otras tools; incluso acciones como Bash y grep si se requieren.
• Ajusta permisos: evitar modo read only si el agente debe escribir o editar.
• Selecciona el modelo según la tarea: Sonnet para tareas generales, Opus para razonamiento complejo, Haiku para eficiencia; aquí se eligió el modelo 4.
• Asigna un color (amarillo) para identificar visualmente a Architect.

¿Cómo invocar al subagente con @architect?

• Reinicia completamente Claude para que tome el nuevo system prompt.
• Usa resume para volver a la conversación con contexto.
• Invoca con @architect y presiona tabulador para fijarlo en el contexto activo.
• Especifica: “utiliza el contexto existente, realiza análisis de impacto y crea el plan de implementación”.
• Verifica que la ejecución ocurra “en amarillo” y que el nombre del subagente esté resaltado.

¿Cómo documentar y guardar el plan de implementación en el proyecto?

La documentación viva dentro del repo es clave. El objetivo es persistir el análisis con un formato uniforme y fácil de versionar.

¿Qué formato markdown debe producir?

• Estructura de salida: análisis técnico del feature.
• Incluye: problema, impacto, propuesta de solución, plan de implementación por fases.
• Añade consideraciones de performance, testing y escalabilidad.

¿Cómo guardar en la carpeta spec con nomenclatura 00-nombre.markdown?

• Indica al agente: “guarda el plan con el formato del subagente en un archivo del proyecto”.
• Carpeta destino: spec en el root.
• Nomenclatura: 00-nombre-del-spec.markdown, incrementando el número con cada nuevo spec.
• Acepta la creación de la carpeta si no existe.

¿Qué mejoras técnicas incluye el plan: performance, testing y escalabilidad?

• Arquitectura sólida con fases claras de implementación.
• Fase 1: cambios en la capa de base de datos, marcada como crítica.
• Performance: creación de índices para evitar queries lentas.
• Testing: cobertura desde el inicio para validar cambios incrementales.
• Escalabilidad: decisiones alineadas con el contexto del proyecto Platzi Flix.

Además, Architect no solo sirve para nuevos features: también puede analizar un feature existente, detectar un bug y proponer una planificación de mejora con el mismo rigor.

¿Tienes dudas o quieres compartir tu propia configuración de subagentes? Deja un comentario y cuéntanos cómo lo aplicarás en tu proyecto.