Equipos de subagentes en Claude Code: Scout, Worker, Synthesizer

Scout, Worker y Synthesizer es el patrón para implementar planes grandes con varios subagentes sin perder detalles por la compactación: un Scout explora y arma el plan, varios Workers implementan partes en paralelo, y un Synthesizer verifica que lo implementado coincide con lo planeado. La sesión principal deja de ejecutar y pasa a coordinar; cada rol vive en su propio contexto y solo devuelve resúmenes.

El problema que resuelve: en una feature grande, a las dos horas la sesión consumió 200.000 tokens, empieza a compactar y los detalles tempranos del plan se vuelven borrosos. Para el final, ejecutas una versión interpretada del plan, no el plan. La causa no es el modelo: es usar la sesión principal como ejecutora cuando debería ser coordinadora.

Las tres etapas

Scout: planificar con exploración

Usas el modo plan y dejas que el modelo delegue la investigación al subagente built-in de planificación, explorando el código desde tantos ángulos como haga falta. El resultado es un plan denso, persistido en disco (.claude/plans/), que cubre cada cambio, sus dependencias y sus efectos colaterales.

Al terminar el Scout, reseteas el contexto con /clear. Suena contraintuitivo (acabas de pagar tokens planificando), pero el plan ya está en disco. Lo que necesitas a partir de ahora es coordinación, no el rastro de cómo llegaste al plan: esa exploración pasa a ser ruido.

Workers: implementar en paralelo

Con el plan persistido, abres una sesión limpia, lees el plan, identificas sus partes independientes y lanzas un subagente Worker por cada una. Cada Worker tiene un prompt acotado a su tarea, su propia ventana de contexto y permisos de implementación.

Los Workers corren de tres formas:

Cada Worker devuelve a la sesión coordinadora un resumen de 2.000 a 8.000 tokens. Toda la implementación, los archivos leídos y los errores que resolvió quedan en su contexto local y se descartan. Solo el resumen llega al coordinador.

Synthesizer: verificar contra el plan

El paso crítico: comprobar que la suma de las implementaciones coincide con el plan original. El Synthesizer (la propia sesión coordinadora o un subagente de revisión dedicado) lee el plan y los resúmenes y busca lo que ningún Worker individual podía detectar: contradicciones entre dos Workers, secciones del plan que nadie tocó, decisiones que se desviaron de la spec.

Por qué funciona

Cada rol vive en su propio contexto, así que la sesión principal nunca se llena con el ruido de la ejecución. Mantiene espacio mental para iterar ciclo tras ciclo hasta que el resultado se ajuste al plan, sin compactaciones que se coman los detalles.


Preguntas frecuentes

¿Qué es el patrón Scout, Worker, Synthesizer en Claude Code?

Es un workflow de tres etapas para implementar planes grandes con subagentes: un Scout explora y arma el plan (que se persiste en disco), varios Workers implementan partes en paralelo en sus propios contextos, y un Synthesizer verifica que lo implementado coincide con el plan. La sesión principal solo coordina.

¿Cómo paralelizo trabajo con subagentes en Claude Code?

Tras planificar y persistir el plan, abres una sesión limpia y lanzas un subagente Worker por cada parte independiente del plan. Pueden correr en paralelo (tres o cuatro a la vez) o coordinados con dependencias. Cada uno devuelve solo un resumen a la sesión coordinadora.

¿Por qué hay que limpiar el contexto después de planificar?

Porque el plan ya quedó persistido en disco (.claude/plans/). Lo que la sesión coordinadora necesita a partir de ahí es coordinar, no el rastro de la exploración. Dejar esa exploración en el contexto solo añade ruido que degrada los pasos siguientes.

¿Para qué sirve la etapa Synthesizer?

Para verificar que la suma de lo que implementaron los Workers coincide con el plan original. Detecta problemas que ningún Worker individual ve: contradicciones entre Workers, partes del plan que nadie tocó o desviaciones de la spec.


Recursos relacionados

Tu siguiente paso

Los comandos de subagentes y decenas más están en la Cheat Sheet de Claude Code: una hoja imprimible, en español.

Descargar la Cheat Sheet gratis

Es el resumen de Ship with Claude Code, la guía de Takren (14 módulos, 190 capítulos, actualizaciones gratuitas).