Máster Generador — workflows multi-agente (master-crearack / master-workspace)

Qué es

Patrón “Project Mastery Workflow”: un flujo dinámico multi-agente (tool Workflow de Claude Code) que produce un mapa mental completo y fiel de un ecosistema/codebase, verificado contra el código real en una sola corrida paralela. Pensado para formar parte del expertise reusable del equipo y aplicarse a cualquier proyecto.

Resuelve el problema de fondo: la documentación estática (READMEs, context/agents/dev-*.md) se desactualiza y miente sobre el código. En vez de mantener un mapa a mano, se regenera verificado cuando hace falta.

Arquitectura (3 fases)

1. Estudio (fan-out) — un agente por dominio (app/módulo/subsistema/infra/harness). Cada agente: consulta primero la memoria/grafo del proyecto → lee la doc de contexto → lee el código real → escribe un brief de maestría exhaustivo a disco. Verifica nombres contra el código; no inventa.
2. Síntesis — un agente lee todos los briefs y consolida MASTER.md: visión de una página, mapa de componentes/conexiones, reglas operativas, footguns más peligrosos, glosario, ritual de sesión.
3. Crítico de huecos — un agente busca lo no cubierto, afirmaciones sin verificar y deudas priorizadas → GAPS.md. Cierra él mismo los huecos baratos.

Invariantes de diseño (no cambiar sin entender)

• Agentes de estudio SIN schema. Un agente que produce un entregable voluminoso (escribir un .md largo) y además debe devolver un StructuredOutput tiende a “completar sin llamarlo” y se pierde. El entregable real es el fichero en disco; el return es solo texto breve de confirmación. schema se reserva para agentes ligeros de datos pequeños. (Footgun footguns_workflow_schema_heavy_agents.)
• Persistencia incremental a disco. Cada agente escribe su brief al terminar → en modo desatendido, lo completado sobrevive aunque otros agentes (o la máquina) fallen.
• Salida FUERA de los repos. Escribe en una carpeta de trabajo aparte (C:/dev/{proyecto}-master/) para no ensuciar git ni disparar hooks de commit.
• El documento es desechable; el generador es el activo. No se mantiene el MASTER.md a mano — se regenera. Mantener un mapa estático recrea el mismo drift que el patrón denuncia.
• El código manda. Los briefs verifican contra el código y marcan dónde la doc miente. La síntesis hereda ese principio.

Instancias del equipo

Ambos viven en CreaRack-Pro/.claude/workflows/ (mecanismo nativo de Claude Code: invocables por nombre, versionados, recibidos por los 3 perfiles en el git pull de arranque).

Por qué viven en CreaRack-Pro y no en el repo workspace: la sesión siempre se ancla en CreaRack-Pro (dashboard global del equipo, incluso para iniciativas del workspace). Es el cajón que garantiza invocación por nombre desde cualquier sesión. Cada script apunta por ruta absoluta a su repo objetivo.

Invocación

Workflow({ name: "master-crearack" })
Workflow({ name: "master-crearack", args: { outDir: "C:/dev/otro-sitio" } })
Workflow({ name: "master-workspace" })

Salida: briefs/01..N-*.md + MASTER.md + GAPS.md.

Cómo instanciarlo en un proyecto nuevo

1. Define los dominios del proyecto (apps, paquetes, subsistemas, infra, harness…). Uno por agente.
2. Copia la estructura del script de referencia y rellena DOMAINS con { num, key, title, bib/docs/code } apuntando a las fuentes reales.
3. Guárdalo como .claude/workflows/master-{proyecto}.js en el repo.
4. Lánzalo: Workflow({ name: "master-{proyecto}" }).

El patrón genérico reutilizable vive en claude-method/guides/MASTER_WORKFLOW_PATTERN.md.

Métricas y lecciones (primera aplicación, s94)

• 16 dominios en paralelo. La 1ª ronda con schema perdió ~la mitad de los agentes (los pesados no llamaron a StructuredOutput); rehacer sin schema recuperó el 100%. De ahí el invariante.
• ~3,3 M tokens y ~32 min de cómputo para un ecosistema de 3 repos. Escala con el nº de dominios.
• El crítico de huecos detectó deudas reales (seguridad, observabilidad) que ningún mapa estático tenía: el valor no es solo onboarding, también auditoría de drift (los hallazgos de GAPS.md alimentaron la Fase C de saneamiento de docs y el Plan Hardening).

Versión coloquial (para cualquiera, sin jerga): [[feature—workspace—master-generador]]. Ejemplo de salida ya generada y publicada: [[concept—onboarding—mapa-maestro-ecosistema-crearack]].

Última actualización: 31-05-2026 (s99).

Véase también

• [[feature—workspace—master-generador]]
• [[concept—onboarding—mapa-maestro-ecosistema-crearack]]