133 lines
4.4 KiB
Markdown
133 lines
4.4 KiB
Markdown
# 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*
|