# Sistema de Orquestación - ERP Core

## Descripción

Este directorio contiene el sistema de orquestación de agentes NEXUS para el proyecto ERP Core. Gestiona la ejecución de tareas, trazabilidad de agentes, y validación de entregables.

## Estructura de Directorios

```
orchestration/
├── 00-guidelines/              # Contexto y directivas
│   ├── CONTEXTO-PROYECTO.md   # Configuración del proyecto
│   └── HERENCIA-DIRECTIVAS.md # Mapeo de directivas heredadas
│
├── 01-analisis/               # Fase 1: Análisis de tareas
│   └── {FECHA}-{TAREA}-ANALISIS.md
│
├── 02-planeacion/             # Fase 2: Planes de implementación
│   └── {FECHA}-{TAREA}-PLAN.md
│
├── 03-tareas/                 # Descomposición de work items
│   └── {TAREA}/
│
├── 04-ejecucion-logs/         # Fase 4: Logs de ejecución
│   └── {FECHA}-{TAREA}-LOG.md
│
├── 05-validaciones/           # Fase 3 y 5: Validaciones
│   ├── pre/                   # Validación pre-ejecución
│   ├── durante/               # Validación durante ejecución
│   └── post/                  # Validación post-ejecución
│
├── 06-subagentes/             # Gestión de subagentes
│   └── REGISTRO-SUBAGENTES.json
│
├── agentes/                   # Ejecuciones por agente
│   ├── backend/
│   ├── frontend/
│   ├── database/
│   └── {agente}/
│
├── directivas/                # Directivas específicas de ERP-Core
│   └── DIRECTIVA-*.md
│
├── estados/                   # Estado actual de agentes
│   └── ESTADO-AGENTES.json
│
├── inventarios/               # Inventarios YAML
│   ├── BACKEND_INVENTORY.yml
│   ├── FRONTEND_INVENTORY.yml
│   └── DATABASE_INVENTORY.yml
│
├── prompts/                   # Prompts específicos de ERP
│   └── PROMPT-*.md
│
├── reportes/                  # Reportes de ciclos
│   └── {FECHA}-REPORTE.md
│
├── templates/                 # Templates del proyecto
│   └── TEMPLATE-*.md
│
├── trazas/                    # Historial de tareas por agente
│   ├── TRAZA-TAREAS-BACKEND.md
│   ├── TRAZA-TAREAS-FRONTEND.md
│   └── TRAZA-TAREAS-DATABASE.md
│
├── PROXIMA-ACCION.md          # Siguiente tarea prioritaria
└── README.md                  # Este archivo
```

## Flujo de Trabajo (5 Fases)

Toda tarea debe seguir el flujo de 5 fases definido en `DIRECTIVA-FLUJO-5-FASES.md`:

```
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  1. ANÁLISIS │───►│ 2. PLANEACIÓN│───►│3. VALIDACIÓN│───►│ 4. EJECUCIÓN│───►│  5. CIERRE  │
│  01-analisis │    │ 02-planeacion│    │ 05-valid/pre│    │04-ejec-logs │    │05-valid/post│
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
```

## Uso Rápido

### Ver siguiente tarea
```bash
cat PROXIMA-ACCION.md
```

### Ver contexto del proyecto
```bash
cat 00-guidelines/CONTEXTO-PROYECTO.md
```

### Ver directivas heredadas
```bash
cat 00-guidelines/HERENCIA-DIRECTIVAS.md
```

### Ver estado de agentes
```bash
cat estados/ESTADO-AGENTES.json
```

### Ver trazas de un agente
```bash
cat trazas/TRAZA-TAREAS-BACKEND.md
```

## Herencia de Directivas

Este proyecto hereda directivas de:

1. **Globales:** `/home/isem/workspace/core/orchestration/directivas/`
2. **ERP-Suite:** `/home/isem/workspace/projects/erp-suite/orchestration/directivas/`
3. **Locales:** `./directivas/`

Ver `00-guidelines/HERENCIA-DIRECTIVAS.md` para el mapeo completo.

## Pool de Subagentes

- **Máximo:** 15 subagentes simultáneos
- **Registro:** `06-subagentes/REGISTRO-SUBAGENTES.json`
- **Validación:** Según `DIRECTIVA-VALIDACION-SUBAGENTES.md`

## Referencias

- [Contexto del Proyecto](00-guidelines/CONTEXTO-PROYECTO.md)
- [Herencia de Directivas](00-guidelines/HERENCIA-DIRECTIVAS.md)
- [Próxima Acción](PROXIMA-ACCION.md)
- [Directivas Globales](/home/isem/workspace/core/orchestration/directivas/)

---
*Sistema NEXUS - ERP Core*
