workspace-v1/orchestration/directivas/simco/_INDEX.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

350 lines
18 KiB
Markdown

# SISTEMA SIMCO - INDICE MAESTRO
**Single Instruction Matrix by Context and Operation**
**Version:** 2.4.0
**Fecha:** 2026-01-03
**Extension:** CCA + CAPVED + Niveles Jerarquicos + Economia de Tokens + Git + Escalamiento + Context Engineering
---
## QUE ES SIMCO
SIMCO es un sistema de directivas organizadas por **tipo de operacion**, no por perfil de agente. Esto permite que cualquier agente, independientemente de su especializacion, pueda seguir las directivas correctas cuando realiza una operacion fuera de su dominio principal.
---
## ESTRUCTURA
```
core/
├── catalog/ # CATALOGO DE FUNCIONALIDADES REUTILIZABLES
│ ├── CATALOG-INDEX.yml # Indice maquina-readable (buscar aqui PRIMERO)
│ ├── auth/ # Autenticacion y autorizacion
│ ├── session-management/ # Gestion de sesiones
│ ├── rate-limiting/ # Limitacion de tasa
│ ├── notifications/ # Sistema de notificaciones
│ ├── multi-tenancy/ # Soporte multi-tenant
│ ├── feature-flags/ # Feature flags dinamicos
│ ├── websocket/ # Comunicacion WebSocket
│ └── payments/ # Integracion de pagos
└── orchestration/
├── directivas/
│ ├── simco/ # DIRECTIVAS POR OPERACION (21 archivos)
│ │ ├── _INDEX.md ← ESTAS AQUI
│ │ │
│ │ │ # === CICLO DE VIDA ===
│ │ ├── SIMCO-TAREA.md # CICLO CAPVED - Punto de entrada para HUs
│ │ ├── SIMCO-INICIALIZACION.md # Bootstrap de agentes (CCA) + Recovery
│ │ │
│ │ │ # === CONTEXT ENGINEERING (NUEVO) ===
│ │ ├── SIMCO-CONTEXT-ENGINEERING.md # Ingenieria de contexto para agentes
│ │ │
│ │ │ # === OPERACIONES UNIVERSALES ===
│ │ ├── SIMCO-CREAR.md # Crear cualquier archivo
│ │ ├── SIMCO-MODIFICAR.md # Modificar archivos existentes
│ │ ├── SIMCO-VALIDAR.md # Validar codigo (build, lint)
│ │ ├── SIMCO-DOCUMENTAR.md # Documentar trabajo realizado
│ │ ├── SIMCO-BUSCAR.md # Buscar archivos e informacion
│ │ ├── SIMCO-DELEGACION.md # Delegar a subagentes (con CCA)
│ │ │
│ │ │ # === CATALOGO ===
│ │ ├── SIMCO-REUTILIZAR.md # Reutilizar del catalogo
│ │ ├── SIMCO-CONTRIBUIR-CATALOGO.md # Contribuir al catalogo
│ │ │
│ │ │ # === POR DOMINIO TECNICO ===
│ │ ├── SIMCO-DDL.md # Operaciones de base de datos
│ │ ├── SIMCO-BACKEND.md # Operaciones de backend NestJS
│ │ ├── SIMCO-FRONTEND.md # Operaciones de frontend React
│ │ ├── SIMCO-MOBILE.md # Operaciones React Native
│ │ ├── SIMCO-ML.md # Machine Learning y AI
│ │ │
│ │ │ # === NIVELES Y PROPAGACION ===
│ │ ├── SIMCO-NIVELES.md # Identificacion de nivel jerarquico
│ │ ├── SIMCO-PROPAGACION.md # Propagacion de documentacion
│ │ │
│ │ │ # === TOMA DE DECISIONES ===
│ │ ├── SIMCO-ALINEACION.md # Alineacion entre capas
│ │ ├── SIMCO-DECISION-MATRIZ.md # Matriz de decision para agentes
│ │ │
│ │ │ # === GIT Y GOBERNANZA ===
│ │ ├── SIMCO-GIT.md # Control de versiones y commits
│ │ ├── SIMCO-ESCALAMIENTO.md # Escalamiento a Product Owner
│ │ │
│ │ │ # === REFERENCIA ===
│ │ └── SIMCO-QUICK-REFERENCE.md # Referencia rapida (optimizado para tokens)
│ │
│ └── principios/ # PRINCIPIOS FUNDAMENTALES (6)
│ ├── PRINCIPIO-CAPVED.md # Ciclo de vida de tareas
│ ├── PRINCIPIO-DOC-PRIMERO.md
│ ├── PRINCIPIO-ANTI-DUPLICACION.md
│ ├── PRINCIPIO-VALIDACION-OBLIGATORIA.md
│ ├── PRINCIPIO-ECONOMIA-TOKENS.md # Limites y desglose de tareas
│ └── PRINCIPIO-NO-ASUMIR.md # No asumir, preguntar
├── agents/
│ └── perfiles/ # PERFILES DE AGENTES (28 archivos)
│ │
│ │ # === PERFILES TECNICOS ===
│ ├── PERFIL-DATABASE.md # PostgreSQL DDL
│ ├── PERFIL-BACKEND.md # NestJS/TypeORM
│ ├── PERFIL-BACKEND-EXPRESS.md # Express.js/Prisma
│ ├── PERFIL-FRONTEND.md # React Web
│ ├── PERFIL-MOBILE-AGENT.md # React Native
│ ├── PERFIL-ML.md # Python/ML basic
│ ├── PERFIL-ML-SPECIALIST.md # Python/ML/AI avanzado
│ ├── PERFIL-LLM-AGENT.md # Integracion LLM/AI
│ ├── PERFIL-TRADING-STRATEGIST.md # Estrategias de trading
│ │
│ │ # === PERFILES DE COORDINACION ===
│ ├── PERFIL-ORQUESTADOR.md # Coordinacion general
│ ├── PERFIL-TECH-LEADER.md # Liderazgo tecnico
│ ├── PERFIL-ARCHITECTURE-ANALYST.md # Analisis de arquitectura
│ ├── PERFIL-REQUIREMENTS-ANALYST.md # Analisis de requerimientos
│ ├── PERFIL-WORKSPACE-MANAGER.md # Gestion de workspace
│ │
│ │ # === PERFILES DE CALIDAD ===
│ ├── PERFIL-CODE-REVIEWER.md # Revision de codigo
│ ├── PERFIL-BUG-FIXER.md # Correccion de bugs
│ ├── PERFIL-TESTING.md # QA y testing
│ ├── PERFIL-QA.md # Quality Assurance
│ ├── PERFIL-DOCUMENTATION.md # Documentacion
│ ├── PERFIL-DOCUMENTATION-VALIDATOR.md # Validacion de documentacion
│ │
│ │ # === PERFILES DE AUDITORIA ===
│ ├── PERFIL-SECURITY.md # Seguridad
│ ├── PERFIL-SECURITY-AUDITOR.md # Auditoria de seguridad
│ ├── PERFIL-DATABASE-AUDITOR.md # Auditoria de BD
│ ├── PERFIL-POLICY-AUDITOR.md # Auditoria de cumplimiento
│ ├── PERFIL-INTEGRATION-VALIDATOR.md # Validacion de integracion
│ │
│ │ # === PERFILES DE INFRAESTRUCTURA ===
│ ├── PERFIL-DEVOPS.md # DevOps y CI/CD
│ └── PERFIL-DEVENV.md # Ambiente de desarrollo
├── templates/ # TEMPLATES (19 archivos)
│ │
│ │ # === CONTEXTO POR NIVEL ===
│ ├── CONTEXTO-NIVEL-STANDALONE.md # Template para proyectos standalone
│ ├── CONTEXTO-NIVEL-SUITE.md # Template para suites multi-vertical
│ ├── CONTEXTO-NIVEL-SUITE-CORE.md # Template para core de suite
│ ├── CONTEXTO-NIVEL-VERTICAL.md # Template para verticales
│ │
│ │ # === CONTEXT ENGINEERING (NUEVO) ===
│ ├── TEMPLATE-HERENCIA-CONTEXTO.md # Herencia de contexto a subagentes
│ ├── TEMPLATE-RECOVERY-CONTEXT.md # Recovery de contexto
│ │
│ │ # === TEMPLATES DE AGENTES ===
│ ├── TEMPLATE-DELEGACION-SUBAGENTE.md # Delegacion a subagentes
│ ├── TEMPLATE-CONTEXTO-SUBAGENTE.md # Contexto para subagentes
│ ├── TEMPLATE-CONTEXTO-PROYECTO.md # Contexto de proyecto
│ ├── TEMPLATES-SUBAGENTES.md # Guia de subagentes
│ │
│ │ # === TEMPLATES DE TAREAS ===
│ ├── TEMPLATE-TAREA-CAPVED.md # Tarea con ciclo CAPVED
│ ├── TEMPLATE-TAREA-TECNICA.md # Tarea tecnica simple
│ ├── TEMPLATE-HISTORIA-USUARIO.md # Historia de usuario
│ ├── TEMPLATE-EPICA.md # Epica
│ ├── TEMPLATE-PLAN.md # Plan de implementacion
│ │
│ │ # === TEMPLATES DE VALIDACION ===
│ ├── TEMPLATE-ANALISIS.md # Analisis de impacto
│ ├── TEMPLATE-VALIDACION.md # Validacion de entregables
│ ├── CHECKLIST-ESTRUCTURA-PROYECTO.md # Estructura de proyecto
│ └── _MAP.md # Mapa de templates
├── patrones/ # PATRONES DE CODIGO
│ ├── MAPEO-TIPOS-DDL-TYPESCRIPT.md # Mapeo PostgreSQL ↔ TypeScript
│ ├── PATRON-VALIDACION.md # Validacion con class-validator/Zod
│ ├── PATRON-EXCEPTION-HANDLING.md # Manejo de errores y excepciones
│ ├── PATRON-TESTING.md # Patrones de testing
│ ├── PATRON-LOGGING.md # Logging estructurado
│ ├── PATRON-CONFIGURACION.md # Variables de entorno y config
│ ├── PATRON-SEGURIDAD.md # Seguridad y OWASP
│ ├── PATRON-PERFORMANCE.md # Optimizacion y caching
│ ├── PATRON-TRANSACCIONES.md # Transacciones de BD
│ ├── ANTIPATRONES.md # Lo que NUNCA hacer
│ └── NOMENCLATURA-UNIFICADA.md # Convenciones de nombres
├── impactos/ # IMPACTO DE CAMBIOS
│ ├── IMPACTO-CAMBIOS-DDL.md # Cascada de cambios en BD
│ ├── IMPACTO-CAMBIOS-BACKEND.md # Sincronizacion Backend↔Frontend
│ ├── IMPACTO-CAMBIOS-ENTITY.md # Cambios en Entities TypeORM
│ ├── IMPACTO-CAMBIOS-API.md # Cambios en endpoints REST
│ └── MATRIZ-DEPENDENCIAS.md # Matriz completa de dependencias
├── procesos/ # PROCESOS DE TRABAJO
│ └── ORDEN-IMPLEMENTACION.md # DDL-First, orden de capas
├── checklists/ # CHECKLISTS DE VERIFICACION
│ ├── CHECKLIST-CODE-REVIEW-API.md # Revision de codigo API
│ ├── CHECKLIST-REFACTORIZACION.md # Checklist de refactoring
│ └── CHECKLIST-PROPAGACION.md # Propagacion de cambios
├── _historico/
│ └── MAPA-CONTEXTO-AGENTE.md # Trazabilidad (historico)
└── referencias/
└── ALIASES.yml # SISTEMA DE ALIAS
```
---
## GUIA RAPIDA
### Inicializacion de Agente (CCA)
```yaml
# Prompt minimo de inicializacion:
"Seras {PERFIL}-Agent trabajando en el proyecto {PROYECTO}
para realizar: {TAREA}
Antes de actuar, ejecuta el protocolo CCA (Carga de Contexto Automatica)."
# El agente debe:
1. Leer SIMCO-INICIALIZACION.md
2. Cargar contexto en cascada (Core → Proyecto → Operacion → Tarea)
3. Confirmar "READY_TO_EXECUTE" antes de implementar
4. Si detecta compactacion → Ejecutar Recovery antes de continuar
# Ver: @CONTEXT_ENGINEERING para principios de ingenieria de contexto
```
### Para TODO Agente - Siempre Leer:
| Principio | Archivo | Resumen |
|-----------|---------|---------|
| **CAPVED** | `PRINCIPIO-CAPVED.md` | Toda tarea pasa por Contexto→Analisis→Plan→Validacion→Ejecucion→Doc |
| Doc Primero | `PRINCIPIO-DOC-PRIMERO.md` | Consultar docs/ antes de implementar |
| Anti-Dup | `PRINCIPIO-ANTI-DUPLICACION.md` | Verificar que no existe antes de crear |
| Validacion | `PRINCIPIO-VALIDACION-OBLIGATORIA.md` | Build y lint DEBEN pasar |
| **Tokens** | `PRINCIPIO-ECONOMIA-TOKENS.md` | Desglosar tareas para evitar overload |
| **No Asumir** | `PRINCIPIO-NO-ASUMIR.md` | Verificar antes de asumir |
### Por Tipo de Operacion:
| Operacion | Archivo SIMCO | Cuando Usar |
|-----------|---------------|-------------|
| **Tarea/HU** | `SIMCO-TAREA.md` | **PUNTO DE ENTRADA** - Toda HU/tarea que modifica codigo |
| **Inicializacion** | `SIMCO-INICIALIZACION.md` | Bootstrap de agentes (protocolo CCA) + Recovery |
| **Context Engineering** | `SIMCO-CONTEXT-ENGINEERING.md` | Disenar, cargar y recuperar contexto |
| **Reutilizar** | `SIMCO-REUTILIZAR.md` | ANTES de implementar funcionalidad comun |
| **Contribuir** | `SIMCO-CONTRIBUIR-CATALOGO.md` | DESPUES de implementar funcionalidad reutilizable |
| **Crear** | `SIMCO-CREAR.md` | Al crear cualquier archivo nuevo |
| **Modificar** | `SIMCO-MODIFICAR.md` | Al modificar archivos existentes |
| **Validar** | `SIMCO-VALIDAR.md` | Antes de marcar tarea completa |
| **Documentar** | `SIMCO-DOCUMENTAR.md` | Al finalizar cualquier tarea |
| **Buscar** | `SIMCO-BUSCAR.md` | Para encontrar archivos/info |
| **Delegar** | `SIMCO-DELEGACION.md` | Al asignar trabajo a subagentes |
| **Alineacion** | `SIMCO-ALINEACION.md` | Validar alineacion entre capas (DDL↔Entity↔DTO) |
| **Decision** | `SIMCO-DECISION-MATRIZ.md` | Clarificar que directiva ejecutar |
### Por Dominio Tecnico:
| Dominio | Archivo SIMCO | Cuando Usar |
|---------|---------------|-------------|
| **Database** | `SIMCO-DDL.md` | Operaciones con PostgreSQL/DDL |
| **Backend NestJS** | `SIMCO-BACKEND.md` | Operaciones con NestJS/TypeORM |
| **Backend Express** | `SIMCO-BACKEND.md` | Operaciones con Express.js (Prisma/Drizzle) |
| **Frontend** | `SIMCO-FRONTEND.md` | Operaciones con React/TypeScript |
| **Mobile** | `SIMCO-MOBILE.md` | Operaciones con React Native |
| **ML/AI** | `SIMCO-ML.md` | Machine Learning, LLM integration, FastAPI |
### Por Nivel Jerarquico:
| Operacion | Archivo SIMCO | Cuando Usar |
|-----------|---------------|-------------|
| **Identificar Nivel** | `SIMCO-NIVELES.md` | PASO 0 de toda tarea - identificar donde estoy |
| **Propagar** | `SIMCO-PROPAGACION.md` | Al completar tarea - actualizar niveles superiores |
---
## ALIAS MAS USADOS
```yaml
# CICLO DE VIDA Y BOOTSTRAP
@CAPVED: core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md
@TAREA: core/orchestration/directivas/simco/SIMCO-TAREA.md
@INICIALIZACION: core/orchestration/directivas/simco/SIMCO-INICIALIZACION.md
@TPL_CAPVED: core/orchestration/templates/TEMPLATE-TAREA-CAPVED.md
# CONTEXT ENGINEERING (NUEVO)
@CONTEXT_ENGINEERING: core/orchestration/directivas/simco/SIMCO-CONTEXT-ENGINEERING.md
@TPL_RECOVERY_CTX: core/orchestration/templates/TEMPLATE-RECOVERY-CONTEXT.md
@TPL_HERENCIA_CTX: core/orchestration/templates/TEMPLATE-HERENCIA-CONTEXTO.md
# CATALOGO DE FUNCIONALIDADES (CONSULTAR PRIMERO)
@CATALOG: core/catalog/
@CATALOG_INDEX: core/catalog/CATALOG-INDEX.yml
# OPERACIONES UNIVERSALES
@REUTILIZAR: core/orchestration/directivas/simco/SIMCO-REUTILIZAR.md
@CREAR: core/orchestration/directivas/simco/SIMCO-CREAR.md
@MODIFICAR: core/orchestration/directivas/simco/SIMCO-MODIFICAR.md
@VALIDAR: core/orchestration/directivas/simco/SIMCO-VALIDAR.md
@DOCUMENTAR: core/orchestration/directivas/simco/SIMCO-DOCUMENTAR.md
@BUSCAR: core/orchestration/directivas/simco/SIMCO-BUSCAR.md
@DELEGAR: core/orchestration/directivas/simco/SIMCO-DELEGACION.md
# POR DOMINIO TECNICO
@OP_DDL: core/orchestration/directivas/simco/SIMCO-DDL.md
@OP_BACKEND: core/orchestration/directivas/simco/SIMCO-BACKEND.md
@OP_FRONTEND: core/orchestration/directivas/simco/SIMCO-FRONTEND.md
@OP_MOBILE: core/orchestration/directivas/simco/SIMCO-MOBILE.md
@OP_ML: core/orchestration/directivas/simco/SIMCO-ML.md
# NIVELES Y PROPAGACION
@NIVELES: core/orchestration/directivas/simco/SIMCO-NIVELES.md
@PROPAGACION: core/orchestration/directivas/simco/SIMCO-PROPAGACION.md
# TOMA DE DECISIONES
@ALINEACION: core/orchestration/directivas/simco/SIMCO-ALINEACION.md
@DECISION_MATRIZ: core/orchestration/directivas/simco/SIMCO-DECISION-MATRIZ.md
# TEMPLATES DE CONTEXTO
@CTX_STANDALONE: core/orchestration/templates/CONTEXTO-NIVEL-STANDALONE.md
@CTX_SUITE: core/orchestration/templates/CONTEXTO-NIVEL-SUITE.md
@CTX_SUITE_CORE: core/orchestration/templates/CONTEXTO-NIVEL-SUITE-CORE.md
@CTX_VERTICAL: core/orchestration/templates/CONTEXTO-NIVEL-VERTICAL.md
# PRINCIPIOS
@PRINCIPIOS: core/orchestration/directivas/principios/
@TOKENS: core/orchestration/directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md
# PATRONES Y REFERENCIAS
@PATRONES: core/orchestration/patrones/
@IMPACTOS: core/orchestration/impactos/
@QUICK_REF: core/orchestration/directivas/simco/SIMCO-QUICK-REFERENCE.md
# PROYECTO
@INVENTORY: orchestration/inventarios/MASTER_INVENTORY.yml
@ALIASES: core/orchestration/referencias/ALIASES.yml
```
---
## MANTENIMIENTO
| Archivo | Actualizar Cuando |
|---------|-------------------|
| SIMCO-*.md | Cambian procesos universales |
| PRINCIPIO-*.md | Cambian principios fundamentales (raro) |
| PERFIL-*.md | Cambian responsabilidades de agentes |
| ALIASES.yml | Se agregan proyectos o rutas |
| _INDEX.md | Se agregan nuevas directivas SIMCO |
---
## CHANGELOG
- **v2.4.0** (2026-01-03): Agregado Context Engineering (SIMCO-CONTEXT-ENGINEERING.md, templates de herencia y recovery)
- **v2.3.0** (2025-12-12): Git y Escalamiento (SIMCO-GIT, SIMCO-ESCALAMIENTO)
- **v2.2.0** (2025-12-08): Integracion principio ECONOMIA DE TOKENS + SIMCO-QUICK-REFERENCE
- **v2.1.0** (2025-12-08): Integracion principio CAPVED (ciclo de vida de tareas)
- **v2.0.0** (2025-12-08): Implementacion sistema SIMCO
---
**Version:** 2.4.0 | **Sistema:** SIMCO + CAPVED + Context Engineering | **Mantenido por:** Tech Lead