michangarrito/orchestration/_archive/root-files

MiChangarrito - Orchestration

Proposito

Este directorio contiene los archivos de orquestacion para agentes de IA que trabajan en el proyecto MiChangarrito. Incluye lineamientos, inventarios YAML (SSOT), documentos de analisis, reportes y trazas de tareas.

Estructura

orchestration/
├── 00-guidelines/           # Lineamientos y contexto
│   ├── CONTEXTO-PROYECTO.md # Variables y configuracion
│   └── HERENCIA-SIMCO.md    # Directivas SIMCO heredadas
├── analisis/                # Documentos de analisis y planes
│   ├── ANALISIS-*.md
│   ├── PLAN-*.md
│   └── VALIDACION-*.md
├── inventarios/             # SSOT: Single Source of Truth
│   ├── MASTER_INVENTORY.yml
│   ├── DATABASE_INVENTORY.yml
│   ├── BACKEND_INVENTORY.yml
│   └── FRONTEND_INVENTORY.yml
├── environment/             # Configuracion de DevEnv
├── estados/                 # Estado de agentes
├── reportes/                # Reportes de progreso
├── trazas/                  # Trazas de tareas
├── CONTEXT-MAP.yml          # Mapeo de contexto
├── PROJECT-STATUS.md        # Estado actual del proyecto
├── PROXIMA-ACCION.md        # Siguiente accion recomendada
└── PLAN-IMPLEMENTACION.md   # Plan de implementacion

Guia para Agentes

Al Iniciar Trabajo en el Proyecto

1. Leer contexto del proyecto:

   orchestration/00-guidelines/CONTEXTO-PROYECTO.md
   

2. Revisar directivas heredadas:

   orchestration/00-guidelines/HERENCIA-SIMCO.md
   

3. Consultar inventario relevante:

   orchestration/inventarios/{TIPO}_INVENTORY.yml
   

4. Verificar estado actual:

   orchestration/PROJECT-STATUS.md
   

5. Consultar proxima accion:

   orchestration/PROXIMA-ACCION.md
   

Single Source of Truth (SSOT)

Los inventarios YAML son la fuente canonica de verdad para:

Inventario	Proposito	Contiene
MASTER_INVENTORY.yml	Estado consolidado	Fases, epicas, progreso
DATABASE_INVENTORY.yml	Estructura BD	11 schemas, 47 tablas
BACKEND_INVENTORY.yml	Modulos API	17 modulos, 120+ endpoints
FRONTEND_INVENTORY.yml	UI Components	12 paginas, componentes

Cuando Actualizar Inventarios

Evento	Inventario	Accion
Nueva tabla creada	DATABASE	Agregar entrada
Endpoint implementado	BACKEND	Actualizar modulo
Pagina completada	FRONTEND	Cambiar estado
Fase completada	MASTER	Actualizar progreso

Sistema de Estandares

Sistema	Version	Descripcion
SIMCO	v3.7.0	Sistema de Nomenclatura y Organizacion
CCA Protocol	v2.0	Coordinacion de Agentes
CAPVED	v1.0	Ciclo de Vida de Artefactos

Directivas Aplicables

Ver 00-guidelines/HERENCIA-SIMCO.md para lista completa de directivas:

• @DOC_PROYECTO - Estructura de documentacion
• @NOMENCLATURA - Convenciones de nombres
• @ESTRUCTURA_DOCS - Formato de documentos
• @INVENTARIOS - Formato de inventarios YAML
• @TESTING - Estandares de testing
• @INTEGRACIONES - Documentacion de APIs externas

Perfiles de Agentes

Perfil	Responsabilidad
ORQUESTADOR	Coordina y valida trabajo de otros agentes
DOCUMENTATION	Crea y actualiza documentacion
DOCUMENTATION-VALIDATOR	Valida conformidad con estandares
BACKEND	Desarrollo de modulos NestJS
FRONTEND	Desarrollo de UI React
DATABASE	Diseño y migraciones de BD

Archivos Clave

Para Comprender el Proyecto

• 00-guidelines/CONTEXTO-PROYECTO.md - Descripcion y proposito
• ../docs/_MAP.md - Mapa de documentacion

Para Conocer Estado Actual

• PROJECT-STATUS.md - Estado del proyecto
• PROXIMA-ACCION.md - Que hacer ahora
• inventarios/MASTER_INVENTORY.yml - Progreso por fase

Para Decisiones Tecnicas

• ../docs/97-adr/ - Architecture Decision Records

Metricas Actuales

Metrica	Valor
Progreso MVP	95%
Schemas BD	11
Tablas BD	47
Modulos Backend	17
Endpoints	120+
Epicas Completadas	22 de 28

---

Ultima actualizacion: 2026-01-10 Version: 1.0.0 Sistema: SIMCO v3.7.0