mastermind-orchestration

name	mastermind-orchestration
version	1.0.0
description	Sistema de orquestación multi-agente de Mastermind — flujos de delegación por complejidad según el Mastermind v3.
tags	["orchestration","delegation","multi-agent","mastermind"]

Mastermind Orchestration — Flujos de Delegación

Cuándo usar

Cuando Mastermind recibe una tarea que requiere múltiples pasos o herramientas, evalúa la complejidad ANTES de decidir si delega o ejecuta directo.

Flujo de decisión

Petición del usuario
  ↓
¿Cuántos tool calls estimados?
  ├── 2-3 → SIMPLE → Mastermind directo
  ├── 3-5 → MEDIUM → Explorer + Mastermind + (Reviewer si crítico)
  └── 5+  → COMPLEX → Pipeline completo de subagentes

Flujos por nivel

🔵 SIMPLE (Nivel 1)

• Agentes: Mastermind directo
• Ejemplos: Leer archivo, pregunta simple, crear archivo pequeño
• Regla: NO delegar. Directo y rápido.

🟡 MEDIUM (Nivel 2)

• Agentes: Explorer (contexto) + Mastermind (ejecución) + Reviewer (validación)
• Ejemplos: Auditoría de archivo, crear skill, refactorizar código
• Flujo:
  1. Explorer analiza (read-only, max 500 tokens)
  2. Mastermind ejecuta cambios
  3. Si es crítico → Reviewer valida
  4. Mastermind presenta resultado

🔴 COMPLEX (Nivel 3)

• Agentes: Explorer → Planner → Implementer → Reviewer → Critic
• Ejemplos: Dashboard completo, migración, auditoría+corrección
• Flujo:
  1. Explorer → Contexto (read-only)
  2. Planner → Estrategia y pasos
  3. Implementer → Ejecución
  4. Reviewer → Validación PASS/FAIL
  5. Critic → Revisión adversarial (solo si impacto alto)
  6. Mastermind → Resultado + aprendizaje

Criterios de clasificación

Criterio	Simple	Medium	Complex
Archivos	1-2	3-5	6+
Tool calls	2-3	3-5	5+
Dominio	Conocido	Parcial	Nuevo
Riesgo	Bajo	Medio	Alto

Reglas del Critic

• Nunca se degrada — si no hay modelo potente disponible, se OMITE
• Se activa solo en tareas con: complejidad ≥4, ≥3 reintentos, ≥3 archivos, impacto alto
• Output: CRITIC REPORT con hallazgos adversarios

Pitfalls

• No sobre-delegar — tareas simples NO necesitan subagentes
• Context budget — Explorer max 500 tokens, Planner max 700 tokens
• Reintentos — máximo 2 por fase
• Checkpoints — en cada fase crítica, verificar antes de continuar