Memoria de subagente y buenas prácticas

Cierras el curso con tres ajustes que hacen que delegar salga realmente a cuenta: darle memoria al subagente, combinarlo con skills, y elegirle el modelo adecuado.

Memoria persistente

Por defecto, un subagente arranca de cero cada vez. El campo memory le da un directorio propio que sobrevive entre conversaciones, donde acumula aprendizajes (patrones del repo, insights de debug):

---
name: code-reviewer
description: Revisa código por calidad y seguridad.
memory: user
---

• memory: user → memoria en ~/.claude/agent-memory/, compartida en todos tus proyectos.
• memory: project / local → ligada al proyecto.

Así tu revisor "recuerda" entre sesiones los problemas recurrentes de tu base de código. Es la misma idea de la auto memory que viste en CLAUDE.md y memoria, pero para el subagente.

Combinar con skills

Un subagente puede precargar skills con el campo skills, para arrancar ya con ese conocimiento o procedimiento cargado:

---
name: api-developer
description: Implementa endpoints siguiendo las convenciones del equipo.
skills:
  - api-conventions
---

(En la otra dirección, una skill puede ejecutarse dentro de un subagente declarando context: fork en su frontmatter. Skills y subagentes se entrelazan en los dos sentidos.)

Elegir modelo: la palanca de coste

El campo model es de las decisiones más rentables. A un subagente que hace trabajo mecánico o de búsqueda no le hace falta el modelo más caro:

• Un explorador o un buscador → haiku: rápido y barato.
• Un revisor que razona sobre seguridad → sonnet.
• inherit → usa el mismo modelo que la sesión.

Delegar lo mecánico a Haiku en un subagente es una de las formas más fáciles de bajar el coste sin perder calidad donde importa.

Buenas prácticas, en una página

• Una description con disparadores claros — si no, no se delega cuando esperas.
• Mínimo privilegio en tools — dale solo lo que su tarea necesita.
• System prompt enfocado — es un especialista, no un generalista; dile exactamente su trabajo.
• Modelo según la tarea — Haiku para mecánico, Sonnet para razonar.
• Versiónalo — en .claude/agents/, para que el equipo lo herede y lo mejore.

Cierre del curso

Ya sabes extender Claude con skills (instrucciones empaquetadas) y subagentes (trabajadores con contexto propio). Tienes un revisor versionado y el criterio de cuándo delegar.

Hasta aquí, todo lo que has montado son reglas blandas o ayudas que el agente decide usar. El siguiente curso del plan cruza la última frontera: los hooks deterministas, código que se ejecuta automáticamente alrededor de cada acción y que el agente no puede saltarse.

Fuente oficial: Subagents