# Orchestration - Template SaaS

**Proposito:** Carpeta de orquestacion para agentes IA y gestion del proyecto.
**Sistema:** SIMCO v3.7
**Proyecto:** template-saas

---

## Descripcion

Esta carpeta contiene todos los archivos necesarios para la orquestacion del proyecto por agentes IA, incluyendo contexto, inventarios, planes y trazas de ejecucion.

---

## Contenido

| Directorio | Descripcion |
|------------|-------------|
| `00-guidelines/` | Contexto, herencia SIMCO y guias del proyecto |
| `analisis/` | Documentos de analisis, validacion y planes de fases |
| `inventarios/` | Inventarios YAML (SSOT del proyecto) |
| `planes/` | Historico de sprints y planes ejecutados |
| `trazas/` | Trazas de ejecucion y reportes |

---

## Archivos Principales

| Archivo | Proposito |
|---------|-----------|
| `CONTEXT-MAP.yml` | Mapeo de contexto del proyecto (aliases, rutas) |
| `PROJECT-STATUS.md` | Estado actual del proyecto |
| `PROXIMA-ACCION.md` | Siguiente paso recomendado |

---

## Inventarios (SSOT)

| Inventario | Contenido |
|------------|-----------|
| `MASTER_INVENTORY.yml` | Inventario maestro (modulos, integraciones, sprints) |
| `DATABASE_INVENTORY.yml` | Schemas, tablas, enums, funciones PostgreSQL |
| `BACKEND_INVENTORY.yml` | Modulos NestJS, services, controllers, tests |
| `FRONTEND_INVENTORY.yml` | Portales, pages, components, hooks React |

---

## Directivas SIMCO

El proyecto hereda las siguientes directivas del workspace:

| Directiva | Alcance |
|-----------|---------|
| @DOC_PROYECTO | Estructura de carpetas docs/ y orchestration/ |
| @NOMENCLATURA | Patrones SAAS-NNN, INT-NNN, ADR-NNNN |
| @ESTRUCTURA_DOCS | Frontmatter YAML, secciones obligatorias |
| @INVENTARIOS | Formato de inventarios YAML |
| @INTEGRACIONES | Template para integraciones externas |

Ver: `00-guidelines/HERENCIA-SIMCO.md` para detalles completos.

---

## Flujo de Trabajo

```
1. Leer CONTEXTO-PROYECTO.md
2. Consultar PROJECT-STATUS.md
3. Revisar PROXIMA-ACCION.md
4. Ejecutar tarea asignada
5. Actualizar inventarios correspondientes
6. Documentar en trazas/ si es necesario
```

---

## Estructura

```
orchestration/
├── README.md              # Este archivo
├── CONTEXT-MAP.yml        # Mapeo de contexto
├── PROJECT-STATUS.md      # Estado actual
├── PROXIMA-ACCION.md      # Siguiente paso
├── 00-guidelines/         # Guias y herencia
│   ├── CONTEXTO-PROYECTO.md
│   └── HERENCIA-SIMCO.md
├── analisis/              # Documentos de analisis
│   ├── FASE-1-*.md
│   ├── FASE-2-*.md
│   └── ...
├── inventarios/           # SSOT YAML
│   ├── MASTER_INVENTORY.yml
│   ├── DATABASE_INVENTORY.yml
│   ├── BACKEND_INVENTORY.yml
│   └── FRONTEND_INVENTORY.yml
├── planes/                # Historico de sprints
└── trazas/                # Trazas de ejecucion
```

---

**Ultima actualizacion:** 2026-01-10
**Autor:** Claude Code (Estandarizacion SIMCO v3.7)