# FLUJO MAESTRO v2 — CESCAC (cerebro compartido)

> Fuente completa y detallada: `reglas-fijas.md` (este directorio) — este documento es la versión
> ENFOCADA en el flujo/orquestación/proceso, con los 3 diagramas visuales. Versión renderizada
> (mermaid) → `https://vps.cescac.com/cerebro/flujo.html`. **v2 (2026-07-19)** — agrega:
> consulta explícita a los 4 cerebros con evidencia, paso visible de PROMPT MASTER + carga de
> skills/herramientas, y el paso PRE-INTERVENCIÓN (agente auditor primero en órdenes de
> "revisa/mejora X").

## 1 · Los 12 pasos por CADA mensaje del dueño (orden permanente 2026-07-19, reemplaza v1)

Si no se cumplen, el trabajo NO tiene validez.

1. **ANALIZAR A FONDO** el mensaje completo → dividir en TAREAS numeradas (skill
   `divisor-tareas`). Nada se pasa por alto. Mostrar la tabla de tareas detectadas.
2. **CONSULTAR LOS 4 CEREBROS + HUB VPS**: `codebase-mcp`/`codegraph` (símbolos/call-graph del
   código), `notebooklm` (research grounded), `obsidian` (vault de notas), `graphify` (grafo de
   conocimiento oficial — código+docs+conceptos, `cerebro/grafo/`) + `vps.cescac.com/cerebro`
   (hub: memoria persistente, handoff, tablero, reglas). Ahí vive el contexto — DE AHÍ sale qué
   hay y qué no. **Dejar EVIDENCIA explícita** de qué se consultó y qué devolvió cada cerebro
   (no basta con decir "consulté" — mostrar el hallazgo). No re-diagnosticar lo ya resuelto.
   - **2b. `cerebro/lecciones.md`** (append-only, whitelist de errores YA cometidos — pixel ajeno,
     teal incorrecto, gemini-cli discontinuado, espacios en nombres dentro de comandos shell,
     story-en-feed, superadmin secuestrado, IP fantasma nginx, sobrescritura de archivo
     compartido, escaping heredoc/SSH, falsa confianza OCR, tablero sin lock, backups `.bak`
     huérfanos, tokens expuestos, token por query string): consultar ANTES de ejecutar.
     **Prohibido repetir un error ya listado.** El agente evaluador QA (paso 9) appendea ahí
     cualquier error/incidente nuevo de esta ronda — mecanismo de mantenimiento en
     `cerebro/voces-agentes.md`.
3. **[CONDICIONAL] PRE-INTERVENCIÓN — agente AUDITOR primero**: si la orden es tipo
   "revisa/mejora/audita X" (no creación desde cero), ANTES de tocar nada se lanza un agente
   AUDITOR con el rol/profesión del dominio (top 0.01% mundial) → entrega LISTA COMPLETA:
   pendientes, mejoras, errores, vulnerabilidades/seguridad. **De esa lista nace el prompt
   master del ejecutor** (paso 4). Si la orden es "crea X nuevo", se salta directo al paso 4.
4. **CREAR PROMPT MASTER** por tarea: contexto + reglas + **skills/herramientas necesarias** +
   entregable + verificación, para el agente ejecutor. Si hubo auditor (paso 3), nace de su
   lista de hallazgos, no del pedido en crudo.
5. **CARGAR SKILLS/HERRAMIENTAS**: lo declarado en el paso 4 se invoca/inyecta explícitamente
   en el prompt del agente ejecutor antes de delegar.
6. **DESIGNAR MODELO POR COMPLEJIDAD**: Opus/Fable planifica y orquesta; ejecutan
   Haiku/Sonnet/Opus según lo que la tarea necesite (ver §2).
7. **PARALELIZAR SIEMPRE**: multiagente/multitarea, pipeline cuando hay dependencias.
8. **SKILLS + ROLES PRO (ejecución)**: el ejecutor adopta el rol top 0.01% mundial para ese tipo
   de tarea.
9. **AGENTE EVALUADOR SIEMPRE** (`qa-reviewer`): revisa vulnerabilidades, errores, completitud,
   documentación; detecta mejoras → cola de tareas.
10. **VERIFICAR QUE SIRVA + LOOP**: probar de verdad (curl/SQL/test real); si falla, vuelve al
    paso 4 con lo aprendido. Respuesta final ECONÓMICA (delegar resúmenes a tier barato).
11. **TODO A MARKDOWN PRIMERO**: PDF/imagen/Office → `.md` (markitdown/tesseract/pdfplumber)
    ANTES de procesar. Ahorro masivo de tokens.
12. **CEREBROS COMPARTIDOS Y SINCRONIZADOS**: escribir de vuelta en `vps.cescac.com` (hub),
    `graphify` (grafo), `codegraph`, `obsidian` (vault), `notebooklm`. Incluye SIEMPRE:
    (a) preguntar/proponer mejoras al cerrar → `cerebro/voces-agentes.md` (append-only) + tarea
    nueva en el tablero si amerita ejecución; (b) aportar 1+ idea de ingreso legal →
    `cerebro/ideas-ingresos.md` (append-only, tarea recurrente `T-INGRESOS-PERPETUO`, sin dueño
    fijo).

### Diagrama 1 — flujo de 12 pasos (loop cerrado, con rama de pre-intervención)

```mermaid
flowchart TD
    A["1. Mensaje del dueño<br/>→ analizar a fondo"] --> B["2. Consultar 4 cerebros + hub VPS<br/>(codegraph · notebooklm · obsidian · graphify)<br/>→ EVIDENCIA en el flujo"]
    B --> DEC{"3. ¿Orden tipo<br/>'revisa/mejora/audita X'?"}
    DEC -- "SI" --> AUD["3a. Agente AUDITOR<br/>(rol/profesión del dominio)<br/>→ lista: pendientes/mejoras/errores/seguridad"]
    AUD --> C["4. Crear PROMPT MASTER<br/>(contexto+reglas+skills+entregable+verificación)<br/>nace de la lista del auditor"]
    DEC -- "NO (crear desde cero)" --> C2["4. Crear PROMPT MASTER<br/>desde el pedido directo"]
    C --> D["5. Cargar skills/herramientas<br/>(inyectar en el prompt del ejecutor)"]
    C2 --> D
    D --> E["6. Designar modelo<br/>por complejidad (tier)"]
    E --> F["7. Paralelizar<br/>(multiagente / pipeline)"]
    F --> G["8. Skills + rol pro<br/>(ejecución)"]
    G --> H["9. Agente evaluador<br/>(qa-reviewer)"]
    H --> I{"10. Verificar que sirva<br/>(curl/SQL/test real)"}
    I -- "falla" --> C
    I -- "OK" --> J["11. Todo a Markdown"]
    J --> K["12. Cerebros sincronizados<br/>+ voces-agentes.md + ideas-ingresos.md"]
    K --> L["Registro + cierre 5 campos<br/>+ OK DR"]
    L -.->|"próximo mensaje"| A
```

### Diagrama 2 — Pre-intervención: del auditor al ejecutor (detalle del paso 3)

```mermaid
flowchart LR
    Orden["Orden del dueño:<br/>'revisa/mejora/audita X'"] --> Rol["Se asigna ROL de dominio<br/>(ej. auditor de seguridad,<br/>QA médico, contador, diseñador...)"]
    Rol --> Auditor["Agente AUDITOR<br/>examina X a fondo"]
    Auditor --> Lista["Lista completa:<br/>• Pendientes<br/>• Mejoras<br/>• Errores<br/>• Vulnerabilidades/seguridad"]
    Lista --> PM["PROMPT MASTER del ejecutor<br/>nace de esta lista<br/>(no del pedido original en crudo)"]
    PM --> Skills["Skills/herramientas de la lista<br/>se cargan en el prompt"]
    Skills --> Ejecutor["Agente EJECUTOR interviene<br/>recién ahora"]
    Ejecutor --> QA["qa-reviewer verifica<br/>contra la lista original del auditor"]
```

## 2 · Orquestación por capacidad (regla `0d`)

El orquestador deriva cada tarea al agente por CAPACIDAD, no por disponibilidad:

- **Haiku / deepseek (LiteLLM)** — conversiones, lecturas, resúmenes, validaciones SÍ/NO.
- **Sonnet** — código, contenido, copy, HTMLs, edits medianos.
- **Opus / Fable** — arquitectura, decisiones críticas, orquestación de todo lo anterior.
- **Codex** — builds de features/apps completos (suscripción ChatGPT ya pagada).
- **Hermes** — tareas 24/7 del tablero (agente que corre en el VPS sin depender de que el dueño
  tenga una sesión abierta).
- **Cursor / Antigravity** — toman tareas del tablero en modo PULL (nadie les hace push).

Todos leen `vps.cescac.com` (prompt-maestro + reglas-fijas + tablero) y reportan ahí. La
conversión a markdown (paso 11) la hace SIEMPRE el tier más barato posible — nunca Opus/Fable.

### Diagrama 3 — mapa de orquestación multiagente

```mermaid
flowchart TD
    Duenio["👤 Dueño (Anthony)"] --> Fable["🧠 Fable / Opus<br/>(orquestador — planifica, NO ejecuta escritura pesada)"]

    Fable --> Sonnet["Sonnet / Haiku<br/>(Claude Code — código, copy, lecturas)"]
    Fable --> Codex["Codex CLI<br/>(suscripción ChatGPT — builds completos)"]
    Fable --> Gemini["Gemini CLI<br/>(suscripción Google — en instalación)"]
    Fable --> Hermes["Hermes<br/>(VPS 24/7 — tareas continuas)"]
    Fable --> Pull["Cursor / Antigravity<br/>(modo PULL — toman del tablero)"]

    Sonnet --> Cerebros
    Codex --> Cerebros
    Gemini --> Cerebros
    Hermes --> Cerebros
    Pull --> Cerebros

    Cerebros["🗄️ Cerebros compartidos<br/>codegraph · notebooklm · obsidian · graphify<br/>+ hub vps.cescac.com/cerebro"] --> Tablero["📋 Tablero PULL<br/>cerebro/tablero_agentes.json"]
    Cerebros --> Voces["🗣️ voces-agentes.md<br/>(mejoras propuestas)"]
    Cerebros --> Ingresos["💰 ideas-ingresos.md<br/>(T-INGRESOS-PERPETUO)"]
    Tablero --> Registro["📝 Registro<br/>docs/REGISTRO_CAMBIOS_CORE.md<br/>+ cierre 5 campos + OK DR"]
    Registro -.->|"visibilidad total"| Duenio
```

## 3 · Markdown-first (regla `0b`)

TODO archivo (PDF, DOCX, XLSX, PPTX, imagen con texto, HTML, export) se procesa PRIMERO a
`.md` (skill `markitdown` o equivalente local, gratis) y se trabaja desde el `.md`. Nunca leer
documentos pesados directo. Los `.md` resultantes se guardan junto al original o en el cerebro
para reuso — evita reprocesar lo mismo dos veces.

## 4 · Registro de agentes (regla `0e`)

Cada agente que se lanza queda REGISTRADO: qué agente fue, qué tarea tomó, qué hizo, dónde quedó
el entregable — en `docs/REGISTRO_CAMBIOS_CORE.md` (formato `AGT-<tuID>`, cierre 5 campos + OK
DR) y en el tablero (`cerebro/tablero_agentes.json`, campo `notas` al cerrar). Sin registro, el
trabajo no cuenta. Antes de proponer una tarea nueva, se busca primero si YA se hizo (Registro +
tablero + docs `*_2026*.md` del repo + memoria) — repetir trabajo hecho es gasto prohibido.

## 5 · Voces + ideas de ingreso (nuevo, `T-INGRESOS-PERPETUO` + refuerzo paso 12)

- **`cerebro/voces-agentes.md`** (append-only): todo agente al cerrar PREGUNTA/PROPONE mejoras —
  el destino concreto es esta página + tarea nueva en el tablero si amerita ejecución.
- **`cerebro/ideas-ingresos.md`** (append-only): todo agente al cerrar su tarea principal aporta
  1+ idea LEGAL de ingreso digital sustentable/auto-distribuible con primer paso ejecutable.
  Tarea espejo en el tablero: `T-INGRESOS-PERPETUO` (sin dueño fijo, recurrente, nunca "hecho").

---
Mantenimiento: cambios aquí se registran en `docs/REGISTRO_CAMBIOS_CORE.md` con backup previo.
Fuente completa de las 10 reglas (ads, CRM, pagos, generadores de dinero, catálogos, marca) →
`cerebro/index.php?doc=reglas-fijas`.