# Sistema de Orquestación - ERP Construcción (Vertical)

## Descripción

Sistema de orquestación de agentes NEXUS para el proyecto ERP Construcción. Este proyecto **extiende erp-core** y tiene documentación específica para 15 módulos MAI-* y 3 épicas MAE-*.

## 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
├── 02-planeacion/             # Fase 2: Planeación
├── 03-tareas/                 # Descomposición de work
├── 04-ejecucion-logs/         # Fase 4: Logs
├── 05-validaciones/           # Validaciones (pre/durante/post)
│   ├── pre/
│   ├── durante/
│   └── post/
├── 06-subagentes/             # Gestión de subagentes
│
├── agentes/                   # Ejecuciones por agente
├── directivas/                # Directivas específicas de construcción
├── estados/                   # Estado de agentes
├── inventarios/               # Inventarios YAML
├── prompts/                   # Prompts específicos
├── reportes/                  # Reportes de ciclos
├── templates/                 # Templates
├── trazas/                    # Historial de tareas
│
├── PROXIMA-ACCION.md          # Siguiente tarea
└── README.md                  # Este archivo
```

## Herencia de Directivas

Este proyecto hereda directivas en orden:

1. **Globales:** `/home/isem/workspace/core/orchestration/directivas/`
2. **ERP-Suite:** `/home/isem/workspace/projects/erp-suite/orchestration/directivas/`
3. **ERP-Core:** `../../../erp-core/orchestration/directivas/`
4. **Construcción:** `./directivas/`

## Documentación Disponible

Este proyecto cuenta con **403+ archivos** de documentación técnica:

```
/docs/
├── 01-fase-alcance-inicial/    # 15 módulos MAI-*
│   ├── MAI-001-fundamentos/
│   ├── MAI-002-proyectos/
│   ├── ...
│   └── MAI-013-administracion/
├── 02-fase-enterprise/         # 3 épicas MAE-*
│   ├── MAE-014-finanzas/
│   ├── MAE-015-activos/
│   └── MAE-016-dms/
├── 02-modelado/
│   └── database-design/schemas/  # 11 archivos SQL
└── 03-fase-avanzada/           # MAA-017 HSE
```

## Uso Rápido

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

# Ver contexto
cat 00-guidelines/CONTEXTO-PROYECTO.md

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

# Ver módulos disponibles
ls ../docs/01-fase-alcance-inicial/

# Ver schemas SQL
ls ../docs/02-modelado/database-design/schemas/
```

## Flujo de 5 Fases

Toda tarea debe seguir:
1. Análisis → `01-analisis/`
2. Planeación → `02-planeacion/`
3. Validación → `05-validaciones/pre/`
4. Ejecución → `04-ejecucion-logs/`
5. Cierre → `05-validaciones/post/`

## Referencias

- [Contexto del Proyecto](00-guidelines/CONTEXTO-PROYECTO.md)
- [Herencia de Directivas](00-guidelines/HERENCIA-DIRECTIVAS.md)
- [ERP-Core](../../../erp-core/)
- [Documentación](../docs/)

---
*Sistema NEXUS - ERP Construcción (Vertical)*