Agentes (subagentes)

Un subagente es una instancia de Claude con su propio contexto, su propia definición de rol y, opcionalmente, un conjunto restringido de herramientas. Se definen en archivos Markdown:

.claude/agents/<nombre>.md

El frontmatter define el agente:

---
name: code-reviewer
description: Revisa diffs en busca de bugs y problemas de estilo.
tools: Read, Grep, Glob
---

• name y description: identifican al agente y cuándo conviene usarlo.
• tools: una allowlist — el agente solo puede usar las herramientas listadas. Un revisor con Read, Grep, Glob puede inspeccionar código pero nunca editarlo.

¿Por qué delegar? Dos razones principales:

1. Aislamiento de contexto: si una tarea requiere leer 30 archivos, el subagente hace esas lecturas en su propio contexto y devuelve solo un resumen. Tu hilo principal no se infla.
2. Paralelismo: varios subagentes pueden trabajar a la vez en tareas independientes.

¿Cuándo NO delegar? Para leer un archivo puntual que ya conocés o hacer un cambio pequeño y mecánico: el costo de lanzar un agente no se justifica.

Regla clave: el trabajo intermedio del subagente (sus lecturas, sus comandos) no vuelve al orquestador. Solo regresa su mensaje final. Por eso las instrucciones que le das deben ser autocontenidas, y su respuesta debe incluir todo lo que el orquestador necesita.