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)

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.
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.
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

Workflow	Repo objetivo	Dominios	Salida por defecto
`master-crearack.js`	CreaRack-Pro (SaaS Django multi-tenant)	16 (core, racks, blueprints, monitoring, network, signage, terminal, config-ai, frontend, infra-devops, tests-tooling, workspace, supercontexto, wiki, harness, golden-rules)	`C:/dev/crearack-master/`
`master-workspace.js`	CreaRackSL-workspace (Astro + CF Workers/Functions + MCP + Biblioteca + wiki)	12 (Astro/wiki, MCP server, grafo, RAG/Oráculo, ciclo wiki, D1, dashboard, integraciones, auth, ingest/crons, profiles, estilos)	`C:/dev/workspace-master/`

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

Define los dominios del proyecto (apps, paquetes, subsistemas, infra, harness…). Uno por agente.
Copia la estructura del script de referencia y rellena DOMAINS con { num, key, title, bib/docs/code } apuntando a las fuentes reales.
Guárdalo como .claude/workflows/master-{proyecto}.js en el repo.
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]]