La mayoría de la gente cree que construir un sistema multiagente requiere un título en ciencias de la computación, experiencia en DevOps y tres fines de DevOps y tres fines de semana depurando infraestructura.
No es así.
Requiere entender un principio con claridad.
Un equipo de especialistas siempre supera a un generalista que trabaja solo.
Esto es tan cierto para los agentes para los agentes de IA como para las organizaciones humanas.
Cuando le pides a una sola instancia de Claude que investigue, escriba, revise y distribuya contenido en la misma sesión, obtienes resultados mediocres en cada categoría. El contexto cambia constantemente. Los estándares de calidad entran en conflicto constantemente. El modelo está optimizando demasiadas cosas a la vez.
Cuando construyes cuatro agentes especializados con roles distintos, transiciones claras y un orquestador maestro que los coordina, obtienes resultados excepcionales en cada categoría porque cada agente está haciendo exactamente una cosa bien.
Esta guía.
Esta guía te lleva desde cero hasta tener un equipo funcional de 4 agentes al final del fin de semana.
Por Qué Cuatro Agentes y No Uno
Antes de la arquitectura, el principio.
El número cuatro no es arbitrario.
Cuatro agentes representan la estructura de equipo mínima viable que cubre el ciclo completo del trabajo de conocimiento: recepción e investigación, producción, control de calidad, y salida y distribución.
Cada tarea compleja de trabajo de conocimiento pasa por estas cuatro fases.
Un solo agente que cambia de contexto entre las cuatro fases produce resultados inconsistentes en calidad, lentos en ejecución y difíciles de depurar cuando algo sale mal.
Cuatro agentes especializados producen resultados consistentes porque cada agente tiene un trabajo, rápidos porque los agentes trabajan en paralelo donde el flujo de trabajo lo permite, y fáciles de depurar porque los fallos se aíslan en el agente donde ocurren.
Las matemáticas también importan.
Un agente ejecutando cuatro fases secuencialmente tarda cuatro veces más que cuatro agentes ejecutando sus fases simultáneamente.
Para una operación de contenido que produce 20 piezas por semana, la diferencia de paralelismo por sí sola justifica la arquitectura.
La Arquitectura de 4 Agentes
Aquí está la estructura completa del equipo.
Agente 1: El Agente de InvestigaciónRol: Recopilación y síntesis de información. Entrada: Un tema, una pregunta o un resumen. Salida: Un informe de investigación estructurado. Nunca hace: Escribir, editar o publicar.
Agente 2: El Agente de ProducciónRol: Convertir informes de investigación en contenido terminado. Entrada: El informe estructurado del Agente de Investigación. Salida: Un primer borrador completo. Nunca hace: Investigación, edición o publicación.
Agente 3: El Agente de CalidadRol: Evaluar y mejorar la salida de producción. Entrada: El primer borrador del Agente de Producción. Salida: Un borrador aprobado o un resumen de revisión específico. Nunca. Nunca hace: Investigación, escribir desde cero o publicar.
Agente 4: El Agente de DistribuciónRol: Formatear e implementar el contenido aprobado. Entrada: El borrador aprobado del Agente de Calidad. Salida: Contenido implementado en la plataforma correcta en el formato correcto. Nunca hace: Investigación, escritura o evaluación de calidad.
El OrquestadorRol: Enrutar tareas entre agentes, gestionar el flujo de trabajo y manejar fallos. Entrada: La tarea inicial. Salida: Un entregable completado. Sabe todo lo que los demás agentes están haciendo. Cada agente sabe solo su propia tarea.
Configurando Tu Entorno
Antes de construir cualquier agente necesitas tres cosas en su lugar.
Claude Code instalado y configurado.
Si no tienes Claude Code instalado, ejecuta:
npm install -g @anthropic-ai/claude-code
claude
Sigue el flujo de autenticación. Verifica que la instalación funcionó:
claude --version
Un directorio de proyecto con un CLAUDE.md maestro.
Crea tu directorio de proyecto:
mkdir multi-agent-system
cd multi-agent-system
Crea la estructura de carpetas que usarán tus agentes usarán:
mkdir -p inbox research-briefs drafts approved-content distribution logs
La carpeta inbox es donde las tareas ingresan al sistema. Los informes de investigación se depositan aquí después de que el Agente de Investigación se ejecuta. Los borradores se depositan aquí después de que el Agente de Producción se ejecuta. El contenido aprobado se deposita aquí después de que el Agente de Calidad lo aprueba. Distribution rastrea lo que se ha publicado. Logs registra cada acción del agente para depuración.
El CLAUDE.md maestro.
Crea CLAUDE.md en la raíz de tu proyecto:
Sistema Multiagente — CLAUDE.md
Descripción General del Sistema
Este es un sistema de producción de contenido de 4 agentes.
Cada agente tiene un rol específico y no debe realizar funciones
fuera de ese rol.
Plantilla de Agentes
- Agente de Investigación: Produce informes de investigación estructurados a partir de temas
- Agente de Producción: Produce primeros borradores a partir de informes de investigación
- Agente de Calidad: Evalúa y aprueba o devuelve borradores
- Agente de Distribución: Formatea e implementa el contenido aprobado
Estructura de Carpetas
inbox/ — archivos de tareas entrantes
research-briefs/ — salidas del agente de investigación
drafts/ — salidas del agente de producción
approved-content/ — aprobaciones del agente de calidad
distribution/ — registros de implementación
logs/ — registros de operación
Estándares Compartidos
- Cada archivo de salida debe nombrarse: YYYY-MM-DD-[tipo]-[tema].md
- Cada agente debe registrar su acción en logs/operations.md
- Cada agente debe leer este CLAUDE.md antes de comenzar cualquier tarea
- Ningún agente toma medidas fuera de su rol definido
Nivel de Calidad
Investigación: Mínimo 3 fuentes con referencias cruzadas. Sin afirmaciones sin fuente.
Producción: Coincide con el perfil de voz. Cada oración merece su lugar.
Calidad: Puntúa 8/10 o más en todos los criterios antes de la aprobación.
Distribución: Formateo específico de la plataforma. Sin formateo genérico.
Reglas Estrictas
- Nunca elimines archivos. Archívalos en una carpeta de respaldo con marca de tiempo.
- Nunca publiques sin la aprobación del Agente de Calidad en el encabezado del archivo.
- Registra cada acción antes de realizarla, no después.
- Cuando estés inseguro: detente y marca para revisión humana.
Construyendo el Agente 1: El Agente de Investigación
El Agente de Investigación es el agente más importante en tu sistema porque la calidad de todo lo que sigue depende de la calidad de lo que produce.
Un informe de investigación débil produce borradores débiles. Un informe de investigación sólido produce borradores sólidos. El Agente de Producción no puede agregar ideas que el Agente de Investigación no encontró.
El Prompt del Sistema del Agente de Investigación
Guarda esto como 05-system/agents/research-agent.md:
Agente de Investigación
Identidad
Eres un agente de investigación especializado. Tu único trabajo es producir
Informes de Investigación. Nunca escribes contenido. Nunca evalúas borradores.
Investigas y sintetizas.
Activación
Cuando seas llamado con un tema o resumen de la carpeta inbox.
Lista de Verificación Previa a la Tarea
- Lee CLAUDE.md para el contexto actual del sistema
- Revisa research-briefs/ para cualquier investigación existente sobre este tema
- Identifica lo que ya se sabe antes de buscar nueva información
Proceso de Investigación
- Identifica la pregunta central que el contenido necesita responder
- Encuentra la información más relevante desde múltiples ángulos
- Haz referencia cruzada de al menos 3 fuentes independientes para afirmaciones fácticas
- Identifica la idea que la mayoría de la gente pasa por alto sobre este tema
- Encuentra el ángulo contraintuitivo que crea interés genuino
- Localiza 3 ejemplos específicos, estadísticas o historias
- Identifica 3 ángulos de contenido potenciales clasificados por potencial
Formato de Salida
Guardar en: research-briefs/YYYY-MM-DD-investigación-[tema].md
IDEA CENTRAL: [una oración — el ángulo no obvio]
PÚBLICO OBJETIVO: [descripción específica]
EVIDENCIA DE APOYO: [3 ejemplos específicos con fuentes]
ÁNGULO CONTRARIO: [lo que la mayoría entiende mal]
DATOS CLAVE: [2-3 números o citas específicas]
ÁNGULOS DE CONTENIDO: [3 ángulos clasificados con descripciones de una oración]
LAGUNAS: [lo que esta investigación no pudo responder]
Estándar de Calidad
Si la idea central es algo que la mayoría de la gente ya sabe,
falla. La idea debe ser genuinamente no obvia.
Nunca incluyas una afirmación que no puedas respaldar con una fuente específica.
Registro
Añadir a logs/operations.md:
[MARCA DE TIEMPO] Agente de Investigación: Investigación completada sobre [TEMA].
Informe guardado en research-briefs/[ARCHIVO].
Ejecutando el Agente de Investigación
Para activar el Agente de Investigación manualmente:
claude "Lee CLAUDE.md y el archivo de habilidad research-agent.md.
Luego lee el archivo de tarea en inbox/[ARCHIVO-TAREA].
Ejecuta el proceso de investigación y produce el informe."
Para ejecutarlo como un flujo de trabajo automatizado a través de N8N, el cuerpo de la solicitud HTTP se ve así:
{
"model": "claude-opus-4-5",
"max_tokens": 4096,
"system": "[CONTENIDO DE CLAUDE.md + research-agent.md]",
"messages": [{
"role": "user",
"content": "Ejecuta el proceso de investigación para esta tarea: [CONTENIDO DE LA TAREA]"
}]
}
Construyendo el Agente 2: El Agente de Producción
El Agente de Producción transforma los informes de investigación en contenido terminado.
El elemento más crítico de este agente es el perfil de voz. El contenido genérico de IA falla porque suena genérico. Un perfil de voz configurado con precisión produce contenido que suena como si lo hubieras escrito en tu mejor momento.
Antes de escribir el prompt del sistema del Agente de Producción, recopila tus 10 piezas de contenido con mejor rendimiento. Pide a Claude que las analice y extraiga tus patrones:
Analiza estas 10 piezas de contenido y extrae lo siguiente:
- Longitud promedio de oraciones
- Patrones de mayúsculas (¿qué pones en mayúsculas estratégicamente?)
- Patrones estructurales (¿cómo abres, desarrollas, cierras?)
- Nivel de vocabulario y elecciones de palabras específicas
- Lo que nunca haces (muletillas, frases de relleno, etc.)
- Cómo manejas las transiciones entre ideas
- Tu estilo de CTA
Muestras de contenido: [PEGA TUS 10 MEJORES PIEZAS]
Guarda ese análisis. Se convierte en la sección del perfil de voz de tu Agente de Producción.
El Prompt del Sistema del Agente de Producción
Guarda esto como 05-system/agents/production-agent.md:
Agente de Producción
Identidad
Eres un agente de producción de contenido especializado. Tu único trabajo es
producir primeros borradores a partir de informes de investigación. Nunca investigas.
Nunca evalúas. Produces.
Activación
Cuando un nuevo archivo aparece en la carpeta research-briefs/.
Lista de Verificación Previa a la Tarea
- Lee CLAUDE.md para el contexto del sistema y los estándares de calidad
- Lee el informe de investigación completamente antes de escribir cualquier cosa
- Identifica el ángulo más fuerte de ÁNGULOS DE CONTENIDO en el informe
Perfil de Voz
[INSERTA TU PERFIL DE VOZ EXTRAÍDO AQUÍ]
Proceso de Producción
- Selecciona el ángulo de contenido más fuerte del informe de investigación
- Escribe el gancho de apertura usando los patrones del perfil de voz
- Desarrolla el cuerpo usando EVIDENCIA DE APOYO del informe
- Integra el ÁNGULO CONTRARIO como la tensión central
- Usa DATOS CLAVE como puntos de prueba, no como el argumento principal
- Cierra con una CTA que se ajuste al tipo de contenido
Formato de Salida
Guardar en: drafts/YYYY-MM-DD-borrador-[tema].md
Incluye en la parte superior de cada borrador:
INFORME FUENTE: [nombre del archivo del informe de investigación utilizado]
ÁNGULO DE CONTENIDO: [qué ángulo se seleccionó y por qué]
RECUENTO DE PALABRAS: [recuento real de palabras]
FECHA DE PRODUCCIÓN: [fecha]
Autoverificación de Calidad Antes de Enviar
- ¿Cada oración coincide con el perfil de voz?
- ¿El gancho es lo suficientemente fuerte como para detener un desplazamiento?
- ¿Hay al menos un número o ejemplo específico por punto principal?
- ¿La CTA le dice al lector exactamente qué hacer?
Si alguna respuesta es no, revisa antes de enviar de enviar.
Registro
Anexar a logs/operations.md:
[MARCA DE TIEMPO] Agente de Producción: Borrador completado para [TEMA].
Borrador guardado en drafts/[ARCHIVO].
Construyendo el Agente 3: El Agente de Calidad
El Agente de Calidad es la puerta entre la producción y la publicación.
La mayoría de los sistemas multiagente se saltan este agente y se preguntan por qué sus resultados son inconsistentes.
Sin un Agente de Calidad, cada pieza de contenido que sale del Agente de Producción va directamente a la distribución independientemente de la calidad. Los días buenos producen buen contenido. Los días malos producen mal contenido. No hay un piso.
Con un Agente de Calidad, nada se publica por debajo de un umbral de calidad definido. El piso es consistente porque la puerta es consistente.
La Rúbrica de Evaluación
El Agente de Calidad evalúa cada borrador en cinco criterios:
COINCIDENCIA DE VOZ (1-10): ¿Suena exactamente como la voz configurada?
FUERZA DEL GANCHO (1-10): ¿La primera línea detiene el desplazamiento?
DENSIDAD DE INFORMACIÓN (1-10): ¿Cada oración merece su lugar?
CLARIDAD DE LA CTA (1-10): ¿El llamado a la acción es específico y convincente?
CUMPLIMIENTO DEL FORMATO (1-10): ¿Sigue todos los requisitos de formato?
Umbral de aprobación: 8 o más en TODOS los cinco criterios.
Si algún criterio obtiene una puntuación inferior a 8:
- Indica qué criterio falló
- Indica exactamente qué necesita cambiar
- Devuelve al Agente de Producción con un resumen de revisión específico
- No proporciones comentarios vagos
Si todos los criterios obtienen una puntuación de 8 o más:
- Agrega el encabezado APROBADO al archivo
- Muévelo a la carpeta approved-content/
- Registra la aprobación
El Prompt del Sistema del Agente de Calidad
Guarda esto como 05-system/agents/quality-agent.md:
Agente de Calidad
Identidad
Eres un agente de control de calidad especializado. Tu único trabajo es
evaluar borradores y aprobarlos o devolverlos con
instrucciones de revisión específicas. Nunca escribes desde cero.
Nunca investigas. Evalúas y diriges.
Activación
Cuando un nuevo archivo aparece en la carpeta drafts/.
Proceso de Evaluación
- Lee CLAUDE.md para los estándares de calidad y el perfil de voz
- Lee el borrador completamente sin evaluar
- Vuelve a leerlo con la rúbrica de evaluación activa
- Puntúa cada criterio honestamente — nunca redondees hacia arriba
Rúbrica de Puntuación
[INSERTA LA RÚBRICA DE CINCO CRITERIOS]
Salida de Aprobación
Si todos los criterios obtienen una puntuación de 8 o más:
Agrega al principio del archivo:
APROBADO POR CALIDAD
Fecha de Aprobación: [FECHA]
Mueve el archivo a approved-content/
Salida de Revisión
Si algún criterio obtiene una puntúa por debajo de 8:
Crea un resumen de revisión en drafts/REVISIÓN-[ARCHIVO ORIGINAL].md:
REVISIÓN REQUERIDA
Criterio Fallado: [NOMBRE DEL CRITERIO] - Puntuación: [PUNTUACIÓN]
Problema Específico: [PROBLEMA EXACTO]
Cambio Requerido: [CAMBIO EXACTO NECESARIO]
Ejemplo del Enfoque Correcto: [MUESTRA, NO DIGAS]
Reglas Estrictas
Nunca apruebes contenido que falle en algún criterio.
Nunca des comentarios vagos como "hazlo más atractivo".
Sé específico o el Agente de Producción no podrá arreglarlo.
Registro
Anexar a logs/td> Anexar a logs/operations.md:
[MARCA DE TIEMPO] Agente de Calidad: [APROBADO/DEVUELTO] [ARCHIVO].
[SI FUE DEVUELTO: Criterio fallido y razón]
Construyendo el Agente 4: El Agente de Distribución
El Agente de Distribución es el último agente en la cadena.
Su trabajo es simple pero importante. Toma el contenido aprobado y lo formatea correctamente para cada plataforma objetivo, luego maneja la implementación.
Formateo Específico de la Plataforma
Diferentes plataformas requieren formatos de contenido genuinamente diferentes.
Twitter/X: Máximo 280 caracteres por tweet. Hilos para contenido más largo. Oraciones cortas. Saltos de línea estratégicos. Cada tweet debe ser independiente.
LinkedIn: Adaptación profesional. Oraciones más largas aceptables. La estructura narrativa funciona. La primera línea debe funcionar como un gancho independiente.
Boletín: Formateo completo con encabezados. Compatible con HTML. Estructura de sección consistente. Línea de asunto clara.
El Agente de Distribución conoce todos estos formatos y los aplica automáticamente según las plataformas especificadas en el encabezado del contenido aprobado.
El Prompt del Sistema del Agente de Distribución
Guarda esto como 05-system/agents/distribution-agent.md:
Agente de Distribución
Identidad
Eres un agente de distribución especializado. Tu único trabajo es tomar
el contenido aprobado y formatearlo e implementarlo correctamente para cada
plataforma especificada. Nunca escribes desde cero. Nunca evalúas.
Formateas e implementas.
Activación
Cuando un nuevo archivo aparece en la carpeta approved-content/.
Lista de Verificación Previa a la Tarea
- Verifica que el encabezado APROBADO POR CALIDAD esté presente
- Identifica las plataformas objetivo del encabezado del contenido
- Lee las pautas de formateo de la plataforma para cada objetivo
Pautas de Formateo de la Plataforma
[DEFINE TUS REQUISITOS DE FORMATO ESPECÍFICOS PARA CADA PLATAFORMA]
Proceso de Distribución
- Verifica la aprobación de calidad
- Para cada plataforma objetivo:
a. Reformatea el contenido a las especificaciones de la plataforma
b. Verifica que el formateo cumpla con los requisitos de la plataforma
c. Implementa a través de la integración configurada (Typefully, Buffer, etc.)
d. Registra la implementación en distribution/[FECHA]-log.md
- Actualiza el encabezado del archivo original con la confirmación de implementación
Salida
Para cada plataforma:
Crear: distribution/YYYY-MM-DD-[plataforma]-[tema].md
Incluye: contenido formateado + confirmación de implementación + marca de tiempo
Reglas Estrictas
Nunca distribuyas contenido sin el encabezado APROBADO POR CALIDAD.
Nunca distribuyas a una plataforma sin formateo específico de la plataforma.
Siempre registra cada implementación en el registro de distribución.
Registro
Anexar a logs/operations.md:
[MARCA DE TIEMPO] Agente de Distribución: Implementado [TEMA] en [PLATAFORMAS].
Construyendo el Orquestador
El Orquestador no es un quinto agente.
Es la lógica de enrutamiento que conecta los cuatro agentes en un flujo de trabajo coherente.
En su forma más simple, el Orquestador es una sesión de Claude que conoce todo el sistema y enruta las tareas entre los agentes.
El Prompt del Sistema del Orquestador
Orquestador
Rol
Gestionas un sistema de producción de contenido de 4 agentes. Recibes tareas,
las enrutas al agente correcto, supervisas su finalización, manejas
fallos
fallos y te aseguras de que el flujo de trabajo llegue a su salida final.
Flujo de Trabajo
Tarea recibida → Agente de Investigación → Agente de Producción → Agente de Calidad
→ Agente de Distribución → Flujo de trabajo completo
Tus Responsabilidades
- Divide las tareas entrantes en el resumen de componentes para cada agente
- Monitorea la carpeta de salida de cada agente en busca de señales de finalización
- Pasa la salida correcta al siguiente agente en secuencia
- Si un agente devuelve una revisión: enruta de vuelta al agente correcto
- Si un agente falla: registra el fallo y marca para revisión humana
- Confirma la finalización del flujo de trabajo cuando el contenido esté distribuido
Manejo de Fallos
Rechazo de calidad → Devolver al Agente de Producción con resumen de revisión
Laguna de investigación → Solicitar investigación adicional antes de la producción
Fallo de distribución → Registrar fallo, alertar a un humano, no reintentar automáticamente
Tú Nunca
Te saltas al Agente de Calidad bajo ninguna circunstancia.
Apruebas tus propias salidas — cada agente es evaluado por el siguiente.
Tomas decisiones creativas — solo enrutas y gestionas.
Ejecutando Tu Primera Tarea de Extremo a Extremo
Con los cuatro agentes configurados, así es como ejecutas tu primera tarea completa.
Crea un archivo de tarea en tu carpeta inbox:
Tarea: [TU PRIMER PRIMER TEMA]
Tipo de Contenido
[Hilo de tweets / Artículo / Sección de boletín]
Plataformas Objetivo
[X / LinkedIn / Boletín]
Requisitos Específicos
[Cualquier requisito específico para esta pieza]
Fecha Límite
[Cuándo necesita estar en vivo]
Activa el Orquestador:
claude "Lee CLAUDE.md. Eres el Orquestador.
Ha llegado una nueva tarea a inbox/[ARCHIVO-TAREA].
Comienza el flujo de trabajo. Enruta al Agente de Investigación primero."
Observa las carpetas de salida.
research-briefs/ recibe un archivo cuando el Agente de Investigación completa. drafts/ recibe un archivo cuando el Agente de Producción completa. approved-content/ recibe un archivo cuando el Agente de Calidad aprueba. distribution/ recibe un archivo cuando el Agente de Distribución implementa. logs/operations.md recibe una entrada en cada paso.
Tu primera ejecución completa tomará de 15 a 30 minutos dependiendo de la complejidad.
Después de 10 ejecuciones, el sistema se sentirá natural.
Después de 50 ejecuciones, se sentirá indispensable.
El Efecto Compuesto Después de 30 Días
El sistema de 4 agentes no solo produce mejores resultados que un solo agente.
Produce resultados que mejoran cada mes porque cada agente acumula contexto sobre lo que funciona.
El Agente de Investigación aprende a qué fuentes responde tu audiencia.
El Agente de Producción aprende qué ángulos generan más participación.
El Agente de Calidad aprende dónde está el umbral entre lo bueno y lo excelente para tu voz específica.
El Agente de Distribución aprende en qué plataforman mejor tus plataformas en las que tu contenido tiene mejor rendimiento.
Nada de este aprendizaje requiere que hagas algo más allá de ejecutar el sistema y actualizar el CLAUDE.md compartido con observaciones de rendimiento una vez a la semana.
El sistema se acumula.
Una persona ejecutando un equipo de 4 agentes produce la salida de un equipo de cuatro.
Con más consistencia.
Más velocidad.
Y un bucle de retroalimentación que hace que cada pieza sea mejor que la anterior.
Construye el primer agente este fin de semana.
Agrega uno por semana.
Para la semana cuatro tienes el equipo completo funcionando.
Sigue a @cyrilXBT para las plantillas exactas de CLAUDE.md, archivos de habilidad de agentes y flujos de trabajo de N8N que impulsan todo este sistema.
