English

Tu agente auxiliar nunca leyó tus reglas

Le pasas una tarea a un agente auxiliar. Vuelve habiendo ignorado una convención que tienes escrita desde hace meses. La conclusión natural es que desatendió las reglas. La explicación más probable es que nunca las recibió.

Un subagente es una sesión nueva, no una continuación

El modelo mental que causa el problema es imaginar al subagente como una extensión de tu conversación: un colega que estuvo en la sala y ahora sale a hacer una parte. No lo es. Se parece más a una sesión completamente nueva a la que le entregaron una descripción de tarea.

Un subagente que no es una bifurcación arranca con una lista corta: su propio system prompt más detalles del entorno, el prompt de delegación que se escribió al pasarle el trabajo, la jerarquía de archivos CLAUDE.md, una foto del estado de git, las skills nombradas en su campo skills, y una lista de agentes hermanos.

Lo que no recibe es la parte que sorprende:

• Historial de la conversación: nada
• Tu estilo de salida
• La memoria automática de la conversación principal
• Los archivos que ya se leyeron al contexto

Ese último causa la mayor confusión. Pasaste veinte minutos leyendo un módulo en conjunto, delegaste una tarea sobre ese módulo, y el auxiliar empieza releyendo los mismos archivos, o peor, no los lee y razona solo desde la descripción.

Explorar y planificar se saltan el archivo de reglas

Hay un filo más agudo acá. Los agentes integrados de exploración y planificación omiten tanto CLAUDE.md como el estado de git. No por descuido: a propósito, para que la investigación salga rápida y barata. No hay campo de configuración que lo cambie.

Esto importa porque esos dos se delegan de forma automática con frecuencia. No decidiste crear un subagente sin acceso a tus convenciones; el sistema eligió la herramienta correcta para explorar, y esa herramienta está hecha para viajar ligera. Así que una regla que considerarías innegociable puede simplemente estar ausente en el agente que está mirando.

Nota: Vale mantenerlo en proporción: la conversación principal lee los resultados de exploración y planificación con el archivo de reglas completo. Así que una convención que rige cómo se escribe el trabajo final normalmente no necesita llegar al explorador. Son las restricciones que rigen la exploración misma, como no leer cierto directorio o tratar un servicio como prohibido, las que sí hay que repetir.

Repite las restricciones que importan

No hay arreglo por configuración, y ese es el diseño correcto: un subagente con contexto limpio es justamente el punto de delegar. El arreglo está en cómo escribes la entrega.

Trata el prompt de delegación como un informe completo, no como un puntero. Una entrega débil nombra la tarea. Una fuerte nombra la tarea, las restricciones que la acotan, el contexto que el agente no puede deducir, y cómo se ve "terminado":

Débil:
  "Revisa el módulo de autenticación por problemas de seguridad."

Fuerte:
  "Revisa src/auth/ por vulnerabilidades. Concéntrate en manejo de
   tokens, sesiones y validación de entrada. Esta app usa tokens JWT
   en cookies httpOnly. Reporta hallazgos con severidad.
   No modifiques ningún archivo."

La segunda versión sobrevive a un contexto vacío. La primera depende de un entendimiento compartido que no existe.

Cuando la tarea sí necesita todo: bifurca

A veces repetir no es práctico, porque el contexto relevante es una hora de decisiones acumuladas. Reconstruirlo en un prompt es doloroso y además pierde información. Para eso sirve bifurcar.

Una bifurcación hereda la conversación entera, junto con el system prompt y las herramientas de la sesión principal. Se inicia con /subtask. Corre en segundo plano y su resultado regresa como un mensaje en tu conversación, así que el trabajo exploratorio queda fuera de tu contexto mientras la bifurcación lo tiene todo.

La economía favorece a las bifurcaciones más de lo que se cree. Una bifurcación comparte el caché de prompt del padre, lo que la hace más barata que levantar un subagente nuevo que debe construir el suyo. Así que la opción que le da más contexto al agente suele ser también la más barata, al revés del compromiso habitual.

Una regla aproximada: si tendrías que explicarle los antecedentes a un colega competente antes de que pueda empezar, bifurca. Si la tarea se sostiene sola y la puedes enunciar en un párrafo, delega normal y escribe bien ese párrafo.

Para llevar

Un agente delegado es alguien en su primer día: capaz, y completamente desinformado sobre los detalles de tu proyecto. Recibe el archivo de reglas, salvo que sea un agente de exploración o planificación, en cuyo caso ni eso. Nunca recibe tu conversación. Explícale como al recién llegado que es, o bifurca la conversación para que herede todo lo que ya sabes.