javalenciacai/orchestrator

Sistema de Orquestación para Agentes de IA

Regla Principal

Toda tarea debe fluir por la jerarquía de roles. Cada rol:

1. Recibe tarea de su superior
2. Ejecuta usando sus skills O delega a subordinados
3. Reporta resultado hacia arriba

Skills Base (Todos los Roles)

Cada rol inicia con estos 2 skills:

| Skill | URL | Uso | |-------|-----|-----| | find-skills | https://skills.sh/vercel-labs/skills/find-skills | Buscar skills existentes para su dominio | | skill-creator | https://skills.sh/anthropics/skills/skill-creator | Crear skills nuevos cuando no existen |

# Instalar skills base
npx skills add vercel-labs/skills --skill find-skills
npx skills add anthropics/skills --skill skill-creator

---

Jerarquía de Roles

graph TD
    CTO[CTO<br/>Chief Technology Officer]
    
    PM[PM<br/>Product Manager]
    QAL[QAL<br/>QA Lead]
    TL[TL<br/>Tech Lead]
    InfraLead[InfraLead<br/>Infrastructure Lead]
    DataLead[DataLead<br/>Data Lead]
    
    PO[PO<br/>Product Owner]
    UX[UX<br/>UX Designer]
    QA[QA<br/>Quality Assurance]
    SecOps[SecOps<br/>Security Operations]
    Architect[Architect<br/>Software Architect]
    Dev[Dev<br/>Developer]
    DevOps[DevOps<br/>DevOps Engineer]
    DBA[DBA<br/>Database Administrator]
    DataEng[DataEng<br/>Data Engineer]
    AIEng[AIEng<br/>AI Engineer]
    
    CTO --> PM
    CTO --> QAL
    CTO --> TL
    CTO --> InfraLead
    CTO --> DataLead
    
    PM --> PO
    PM --> UX
    
    QAL --> QA
    QAL --> SecOps
    
    TL --> Architect
    TL --> Dev
    
    InfraLead --> DevOps
    InfraLead --> DBA
    
    DataLead --> DataEng
    DataLead --> AIEng
    
    classDef nivel1 fill:#ff6b6b,stroke:#c92a2a,color:#fff
    classDef nivel2 fill:#4dabf7,stroke:#1971c2,color:#fff
    classDef nivel3 fill:#51cf66,stroke:#2f9e44,color:#fff
    
    class CTO nivel1
    class PM,QAL,TL,InfraLead,DataLead nivel2
    class PO,UX,QA,SecOps,Architect,Dev,DevOps,DBA,DataEng,AIEng nivel3

Leyenda:

• 🔴 Nivel 1 (Directivo): CTO
• 🔵 Nivel 2 (Suborquestadores): PM, QAL, TL, InfraLead, DataLead
• 🟢 Nivel 3 (Ejecutores): 10 roles especializados

---

Resumen de Roles

Nivel 1: Directivo

• CTO: Orquestador principal → Delega a PM, QAL, TL, InfraLead, DataLead

Nivel 2: Suborquestadores

• PM: Gestión de producto → Delega a PO, UX
• QAL: Estrategia de calidad → Delega a QA, SecOps
• TL: Liderazgo técnico → Delega a Architect, Dev
• InfraLead: Infraestructura → Delega a DevOps, DBA
• DataLead: Datos e IA → Delega a DataEng, AIEng

Nivel 3: Ejecutores

• PO: Requisitos y backlog
• UX: Diseño de interfaces
• QA: Testing funcional
• SecOps: Seguridad
• Architect: Arquitectura de software
• Dev: Implementación de código
• DevOps: CI/CD e infraestructura
• DBA: Gestión de BD
• DataEng: Pipelines de datos
• AIEng: Modelos de IA/ML

Detalles de cada rol: Ver .agents/skills/[rol]/SKILL.md

---

Ubicación de Skills por Rol

.agents/skills/
├── cto/SKILL.md
├── pm/SKILL.md
├── qal/SKILL.md
├── tl/SKILL.md
├── infralead/SKILL.md
├── datalead/SKILL.md
├── po/SKILL.md
├── ux/SKILL.md
├── qa/SKILL.md
├── secops/SKILL.md
├── architect/SKILL.md
├── dev/SKILL.md
├── devops/SKILL.md
├── dba/SKILL.md
├── dataeng/SKILL.md
└── aieng/SKILL.md

---

Flujo de Orquestación

1. Usuario → CTO (recibe tarea)
2. CTO analiza → Delega según dominio:
   - Producto/UX → PM
   - Calidad/Seguridad → QAL
   - Desarrollo/Arquitectura → TL
   - Infraestructura/BD → InfraLead
   - Datos/IA → DataLead
3. Suborquestador → Delega a ejecutor(es)
4. Ejecutor:
   a. ¿Tiene skill? → Ejecuta
   b. ¿No tiene? → find-skills (busca)
   c. ¿No existe? → skill-creator (crea)
5. Ejecutor → Reporta a suborquestador
6. Suborquestador → Reporta a CTO
7. CTO → Responde al usuario

---

Ejemplo: "Crear API REST para usuarios"

CTO analiza → Requiere desarrollo + infra + datos
CTO delega a:
  - TL: Diseño y código
  - InfraLead: BD y deployment
  - DataLead: Analytics (opcional)

TL → Delega:
  - Architect: Diseña estructura de API REST
  - Dev: Implementa endpoints y lógica

InfraLead → Delega:
  - DBA: Diseña esquema de BD
  - DevOps: Configura CI/CD y deployment

Cada ejecutor:
  1. Busca skill (ej: Dev busca "express-api")
  2. Si no existe → skill-creator
  3. Ejecuta y reporta a su líder

Flujo de reporte:
Dev → TL → CTO
Architect → TL → CTO
DBA → InfraLead → CTO
DevOps → InfraLead → CTO
CTO consolida → Usuario

---

Referencias

• https://skills.sh — Repositorio de skills
• https://skills.sh/vercel-labs/skills/find-skills — Buscar skills
• https://skills.sh/anthropics/skills/skill-creator — Crear skills
• https://roadmap.sh/ — Base de conocimiento por rol