michangarrito/orchestration/README.md
rckrdmrd 928eb795e6 [SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 + cambios apps
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Cambios en backend y frontend

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:05 -06:00

4.2 KiB

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