pipeline-orchestrator

name	pipeline-orchestrator
description	Skill maestro que coordina las 9 fases del pipeline de creación de planes de negocio. Coordina BRIEF → MARKET GATE → GROUND TRUTH → MARKET → FINANCIALS → STRATEGY → BUILD → INVESTOR PACK → JUDGE con reglas de iteración y comunicación.

Pipeline Orchestrator – Plan de Negocio

Skill maestro que coordina las 9 fases. NO ejecuta fases directamente — prepara prompt, delega vía sessions_spawn, valida output y decide si continuar o iterar.

Modelo por Fase

Fase	Modelo
1. BRIEF	glm-5-turbo
1.5. MARKET GATE	glm-5-turbo
2. GROUND-TRUTH	glm-5-turbo
3. MARKET	glm-5.1
4. FINANCIALS	glm-5.1
5. STRATEGY (dual)	Razonator (GLM-5.1) + Visionator (GPT-5.5)
6. BUILD (dual)	Razonator (GLM-5.1) + Visionator (GPT-5.5)
7. INVESTOR PACK	glm-5.1
8. JUDGE (dual)	Razonator (GLM-5.1) + Visionator (GPT-5.5)
Orchestrator	glm-5.1

Orden de Ejecución

#	Fase	Input	Output
1	BRIEF	Petición de el usuario	BRIEF.json
1.5	MARKET GATE	BRIEF.json	MARKET-GATE.json
2	GROUND-TRUTH	BRIEF.json + MARKET-GATE.json	GROUND-TRUTH.json
3	MARKET	GROUND-TRUTH.json + MARKET-GATE.json	MARKET-ANALYSIS.json
4	FINANCIALS	GROUND-TRUTH.json + MARKET-ANALYSIS.json	FINANCIALS.json
5	STRATEGY*	Todo anterior	strategy/STRATEGY-A.json + STRATEGY-B.json → STRATEGY.json
6	BUILD*	Todo anterior	build/PLAN-A.md + PLAN-B.md → plan-final.md
7	INVESTOR PACK	Todo anterior	investor-evidence-pack.md
8	JUDGE*	Documento + artefactos + evidence pack	judge/JUDGE-A.json + JUDGE-B.json → JUDGE-REPORT.json + FEEDBACK-FOR-RERUN.json

*Las fases marcadas con asterisco son dual-LLM.

Ejecución de cada fase:

1. Preparar prompt con el input correcto (artefacto de la fase anterior)
2. sessions_spawn con el prompt y modelo correspondiente
3. Esperar resultado (push-based)
4. Validar que el output se generó correctamente
5. Validar JSON: Si el output es un .json, ejecutar inmediatamente:

   python3 -c "import json; json.load(open('PATH/TO/ARTIFACT.json'))"
   

   Si falla → corregir y reintentar generación antes de pasar a la siguiente fase.
6. Si falla → reintentar 1 vez → si vuelve a fallar → escalar a el usuario
7. Si ok → pasar a la siguiente fase

Skills individuales: Los prompts detallados, outputs JSON y reglas de cada fase están en skills/pipeline-{fase}/SKILL.md. Consultarlos antes de delegar cada fase.

MARKET GATE — Regla Especial

Esta fase puede detener el pipeline.

• Si MARKET-GATE.json verdict = GO → continuar a GROUND-TRUTH
• Si verdict = DUDAR → preguntar a el usuario con los flags encontrados. Esperar decisión.
• Si verdict = NO-GO → detener pipeline. Mostrar justificación a el usuario.

Paths Estándar

Durante el pipeline

projects/{proyecto}/v{n}/
├── BRIEF.json
├── MARKET-GATE.json
├── GROUND-TRUTH.json
├── MARKET-ANALYSIS.json
├── FINANCIALS.json
├── strategy/
│   ├── STRATEGY-A.json
│   ├── STRATEGY-B.json
│   └── STRATEGY.json
├── build/
│   ├── PLAN-A.md
│   ├── PLAN-B.md
│   └── plan-final.md
├── investor-evidence-pack.md
└── judge/
    ├── JUDGE-A.json
    ├── JUDGE-B.json
    ├── JUDGE-REPORT.json
    └── FEEDBACK-FOR-RERUN.json

Tras aprobación final

projects/{proyecto}/
├── v{n}/              ← artefactos de la versión
│   ├── BRIEF.json
│   ├── ...
│   └── JUDGE-REPORT.json
├── plan-final.md      ← documento final
├── plan-final.pdf
├── investor-evidence-pack.md
└── latest → v{n}/     ← symlink a versión más reciente

PDF

node tools/pdf-generator.mjs projects/{proyecto}/plan-final.md --output projects/{proyecto}/plan-final.pdf
node tools/pdf-generator.mjs projects/{proyecto}/v{n}/investor-evidence-pack.md --output projects/{proyecto}/v{n}/investor-evidence-pack.pdf

Diagrama de Decisión

INICIO
  │
  ▼
FASE 1: BRIEF ──→ preguntas_pendientes? ──SÍ──→ Preguntar el usuario → re-BRIEF
  │                                         │
  │                                         NO
  ▼                                         │
FASE 1.5: MARKET GATE ──→ NO-GO? ──SÍ──→ Detener. Mostrar justificación a el usuario.
  │                         │
  │                        NO
  │                         │
  │               DUDAR? ──SÍ──→ Preguntar el usuario. Esperar decisión.
  │                         │
  │                        GO
  ▼                         │
FASE 2: GROUND-TRUTH ──→ supuestos ❓? ──SÍ──→ Preguntar el usuario → re-GT
  │                                         │
  │                                         NO
  ▼                                         │
FASE 3: MARKET → FASE 4: FINANCIALS → FASE 5: STRATEGY (dual, debe consultar ≥3 skills de expertos de negocio) → FASE 6: BUILD (dual) → FASE 7: INVESTOR PACK
  │
  ▼
FASE 8: JUDGE (dual) ──→ rejected? ──SÍ──→ Usar FEEDBACK-FOR-RERUN.json → Volver a fase(s) relevante(s)
  │                    │
  │                   NO
  ▼
✅ ENTREGAR: projects/{proyecto}/plan-final.md + investor-evidence-pack.md + plan-final.pdf

Reglas de Iteración

Condición	Acción
BRIEF tiene preguntas_pendientes no vacío	Detener. Preguntar a el usuario. Re-ejecutar BRIEF con datos completados.
MARKET GATE verdict = NO-GO	Detener pipeline. Mostrar justificación.
MARKET GATE verdict = DUDAR	Preguntar a el usuario. Esperar decisión explícita.
GROUND-TRUTH tiene supuestos críticos en ❓	Detener. Mostrar a el usuario. Esperar validación.
JUDGE rechaza (rejected)	Usar FEEDBACK-FOR-RERUN.json para identificar fases. Re-ejecutar fases específicas con feedback aplicado.
Cualquier fase falla 2 veces	Escalar a el usuario con resumen del error

JUDGE → Fase a re-ejecutar

Tipo de issue en JUDGE	Fase a volver
Mercado no validado	Fase 1.5: MARKET GATE
Datos/coherencia	Fase 2: GROUND-TRUTH
Mercado/competencia	Fase 3: MARKET
Financieros / fiscalidad	Fase 4: FINANCIALS
Estratégicos	Fase 5: STRATEGY
Redacción	Fase 6: BUILD
Investor pack deficiente	Fase 7: INVESTOR PACK

Límites

• Máx 2 iteraciones por fase individual
• Máx 3 ciclos completos (Build → Judge)
• Si se exceden → escalar a el usuario con resumen

Comunicación con el usuario

Momento	Qué mostrar
Inicio	"Voy a crear un plan de negocio para {nombre}. Pipeline de 9 fases."
Tras BRIEF	Si faltan datos → preguntar. Si ok → breve resumen.
Tras MARKET GATE	Veredicto + competidores encontrados + flags. Si NO-GO o DUDAR → explicar.
Tras GROUND-TRUTH	Si hay supuestos ❓ → preguntar. Si ok → "Supuestos validados, avanzando."
Tras MARKET	Resumen: competidores encontrados, oportunidades clave.
Tras FINANCIALS	Break-even, beneficio after-tax, escenario base.
Tras STRATEGY	Propuesta de valor, modelo, próximos pasos resumidos.
Tras BUILD	"Documento generado. Generando Investor Evidence Pack."
Tras INVESTOR PACK	"Investor Pack generado. Ejecutando evaluación de calidad (JUDGE)."
Tras JUDGE	Verdict + score + issues (si hay) + feedback para re-run (si aplica).
Final	"Plan completo en projects/{proyecto}/. PDF + Investor Pack generados."