rckrdmrd/workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
789d1ab46b
workspace/core/orchestration/templates/HERENCIA-SIMCO.md

12 KiB
Raw Blame History

Template: Herencia SIMCO para Proyectos

Versión: 1.0.0 Sistema: SIMCO v2.2.0 + CAPVED + CCA Uso: Copiar y adaptar para cada proyecto

Instrucciones de Uso

  1. Copiar este archivo a {proyecto}/orchestration/00-guidelines/HERENCIA-SIMCO.md
  2. Reemplazar todas las variables {VARIABLE} con valores del proyecto
  3. Eliminar secciones que no apliquen según el nivel del proyecto
  4. Este archivo REEMPLAZA el antiguo HERENCIA-DIRECTIVAS.md

Herencia SIMCO - {NOMBRE_PROYECTO}

Configuración del Proyecto

Propiedad Valor
Proyecto {NOMBRE_PROYECTO}
Nivel {STANDALONE / SUITE / SUITE_CORE / VERTICAL / PRODUCT}
Padre {PROYECTO_PADRE o "core" si es standalone}
SIMCO Version 2.2.0
CAPVED Habilitado
CCA Protocol Habilitado

Jerarquía de Herencia

{AJUSTAR SEGÚN NIVEL DEL PROYECTO}

Nivel 0: core/orchestration/                    ← FUENTE PRINCIPAL
    │
    └── Nivel 1: {suite}/orchestration/         ← (si aplica)
            │
            └── Nivel 2: {suite-core}/orchestration/  ← (si aplica)
                    │
                    └── Nivel 3: {ESTE_PROYECTO}/orchestration/

Regla: Las directivas de nivel inferior pueden EXTENDER las superiores, nunca REDUCIRLAS.

Directivas Heredadas de CORE (OBLIGATORIAS)

Ubicación: core/orchestration/

1. Ciclo de Vida - USAR SIEMPRE

Alias Archivo Propósito Cuándo Usar
@TAREA directivas/simco/SIMCO-TAREA.md Punto de entrada Toda HU/tarea que genera commit
@CAPVED directivas/principios/PRINCIPIO-CAPVED.md Ciclo de 6 fases Contexto→Análisis→Plan→Validación→Ejecución→Doc
@INICIALIZACION directivas/simco/SIMCO-INICIALIZACION.md Bootstrap de agentes Al iniciar cualquier agente

2. Operaciones Universales

Alias Archivo Propósito
@CREAR directivas/simco/SIMCO-CREAR.md Crear cualquier archivo nuevo
@MODIFICAR directivas/simco/SIMCO-MODIFICAR.md Modificar archivos existentes
@VALIDAR directivas/simco/SIMCO-VALIDAR.md Validar código (build, lint, tests)
@DOCUMENTAR directivas/simco/SIMCO-DOCUMENTAR.md Documentar trabajo realizado
@BUSCAR directivas/simco/SIMCO-BUSCAR.md Buscar archivos e información
@DELEGAR directivas/simco/SIMCO-DELEGACION.md Delegar trabajo a subagentes

3. Catálogo de Funcionalidades

Alias Archivo Propósito
@CATALOG catalog/ Directorio de funcionalidades reutilizables
@CATALOG_INDEX catalog/CATALOG-INDEX.yml Índice machine-readable
@REUTILIZAR directivas/simco/SIMCO-REUTILIZAR.md ANTES de implementar algo común
@CONTRIBUIR directivas/simco/SIMCO-CONTRIBUIR-CATALOGO.md DESPUÉS de crear algo reutilizable

4. Principios Fundamentales (5)

Alias Archivo Resumen
@CAPVED PRINCIPIO-CAPVED.md Toda tarea pasa por 6 fases
@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 grandes

Directivas por Dominio Técnico

Usar según las tecnologías del proyecto:

Alias Archivo Tecnologías Aplica a {NOMBRE_PROYECTO}
@OP_DDL SIMCO-DDL.md PostgreSQL, SQL {SI/NO}
@OP_BACKEND SIMCO-BACKEND.md NestJS, Express, TypeORM, Prisma {SI/NO}
@OP_FRONTEND SIMCO-FRONTEND.md React, TypeScript, Vite {SI/NO}
@OP_MOBILE SIMCO-MOBILE.md React Native, Expo {SI/NO}
@OP_ML SIMCO-ML.md Python, FastAPI, ML/AI {SI/NO}

Directivas de Niveles y Propagación

Alias Archivo Propósito
@NIVELES SIMCO-NIVELES.md Identificar nivel jerárquico del proyecto
@PROPAGACION SIMCO-PROPAGACION.md Propagar cambios a niveles superiores
@ALINEACION SIMCO-ALINEACION.md Validar alineación DDL↔Entity↔DTO
@DECISION_MATRIZ SIMCO-DECISION-MATRIZ.md Decidir qué directiva usar

Patrones Heredados (RECOMENDADOS)

Ubicación: core/orchestration/patrones/

Patrón Cuándo Usar
MAPEO-TIPOS-DDL-TYPESCRIPT.md Mapear tipos PostgreSQL ↔ TypeScript
PATRON-VALIDACION.md Validar inputs con class-validator/Zod
PATRON-EXCEPTION-HANDLING.md Manejo de errores y excepciones
PATRON-TESTING.md Escribir tests unitarios/integración
PATRON-LOGGING.md Configurar logging estructurado
PATRON-CONFIGURACION.md Variables de entorno y config
PATRON-SEGURIDAD.md Implementar auth, OWASP Top 10
PATRON-PERFORMANCE.md Optimización y caching
PATRON-TRANSACCIONES.md Transacciones de base de datos
ANTIPATRONES.md Lo que NUNCA hacer
NOMENCLATURA-UNIFICADA.md Convenciones de nombres

Impactos y Dependencias

Ubicación: core/orchestration/impactos/

Documento Consultar Cuando
IMPACTO-CAMBIOS-DDL.md Modificar schema de BD
IMPACTO-CAMBIOS-BACKEND.md Modificar servicios/controllers
IMPACTO-CAMBIOS-ENTITY.md Modificar entities TypeORM
IMPACTO-CAMBIOS-API.md Modificar endpoints REST
MATRIZ-DEPENDENCIAS.md Ver cascada completa de dependencias

Checklists de Verificación

Ubicación: core/orchestration/checklists/

Checklist Usar Para
CHECKLIST-CODE-REVIEW-API.md Revisar código de APIs
CHECKLIST-REFACTORIZACION.md Antes de refactorizar
CHECKLIST-PROPAGACION.md Verificar propagación de cambios

Perfiles de Agentes Disponibles

Ubicación: core/orchestration/agents/perfiles/

Técnicos

Perfil Especialización
PERFIL-DATABASE.md PostgreSQL, DDL, migraciones
PERFIL-BACKEND.md NestJS, TypeORM
PERFIL-BACKEND-EXPRESS.md Express.js, Prisma/Drizzle
PERFIL-FRONTEND.md React, TypeScript
PERFIL-MOBILE-AGENT.md React Native
PERFIL-ML-SPECIALIST.md Python, ML/AI, FastAPI

Coordinación

Perfil Especialización
PERFIL-ORQUESTADOR.md Coordinación general
PERFIL-ARCHITECTURE-ANALYST.md Análisis de arquitectura
PERFIL-REQUIREMENTS-ANALYST.md Análisis de requerimientos

Calidad

Perfil Especialización
PERFIL-CODE-REVIEWER.md Revisión de código
PERFIL-BUG-FIXER.md Corrección de bugs
PERFIL-DOCUMENTATION-VALIDATOR.md Validación de documentación
PERFIL-WORKSPACE-MANAGER.md Gestión de workspace

Directivas Heredadas del Padre (si aplica)

{SOLO PARA NIVELES 2, 3, 4 - AJUSTAR SEGÚN PROYECTO}

Heredadas de {PROYECTO_PADRE}

Ubicación: {RUTA_PADRE}/orchestration/directivas/

Directiva Propósito Cómo se Extiende
{DIRECTIVA_1} {PROPÓSITO} {EXTENSIÓN_LOCAL}
{DIRECTIVA_2} {PROPÓSITO} {EXTENSIÓN_LOCAL}

Directivas Específicas de {NOMBRE_PROYECTO}

Ubicación: ./directivas/

Directiva Local Extiende Propósito Específico
{DIRECTIVA_LOCAL_1} @{ALIAS} {PROPÓSITO}
{DIRECTIVA_LOCAL_2} @{ALIAS} {PROPÓSITO}

Variables de Contexto del Proyecto

Para el protocolo CCA, este proyecto define:

# Variables para resolver en ALIASES y templates
PROJECT_NAME: "{NOMBRE_PROYECTO}"
PROJECT_LEVEL: "{NIVEL}"
PROJECT_ROOT: "{RUTA_ABSOLUTA}"

# Rutas específicas
DB_DDL_PATH: "{RUTA}/database/ddl"
BACKEND_ROOT: "{RUTA}/backend"
FRONTEND_ROOT: "{RUTA}/frontend"

# Inventarios
MASTER_INVENTORY: "orchestration/inventarios/MASTER_INVENTORY.yml"

Flujo de Trabajo con SIMCO + CAPVED

┌─────────────────────────────────────────────────────────────┐
│                    RECIBIR TAREA/HU                         │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  1. LEER @TAREA (SIMCO-TAREA.md)                            │
│     - Activa ciclo CAPVED                                   │
└─────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
   ┌─────────┐          ┌─────────┐          ┌─────────┐
   │    C    │    →     │    A    │    →     │    P    │
   │Contexto │          │Análisis │          │  Plan   │
   └─────────┘          └─────────┘          └─────────┘
        │                     │                     │
        ▼                     ▼                     ▼
   @BUSCAR              @CATALOG_INDEX         @TOKENS
   @NIVELES             @IMPACTOS              @DELEGAR
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
   ┌─────────┐          ┌─────────┐          ┌─────────┐
   │    V    │    →     │    E    │    →     │    D    │
   │Validar  │          │Ejecutar │          │  Doc    │
   │  Plan   │          │         │          │         │
   └─────────┘          └─────────┘          └─────────┘
        │                     │                     │
        ▼                     ▼                     ▼
   @ALINEACION          @OP_DDL              @DOCUMENTAR
   @DECISION_MATRIZ     @OP_BACKEND          @PROPAGACION
                        @OP_FRONTEND
                        @VALIDAR

Mapeo: Directivas Antiguas → SIMCO

Si este proyecto usaba el sistema anterior:

Directiva Antigua Reemplazada Por Alias
DIRECTIVA-FLUJO-5-FASES.md SIMCO-TAREA.md + PRINCIPIO-CAPVED.md @TAREA, @CAPVED
DIRECTIVA-VALIDACION-SUBAGENTES.md SIMCO-VALIDAR.md @VALIDAR
POLITICAS-USO-AGENTES.md SIMCO-DELEGACION.md @DELEGAR
DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md SIMCO-DOCUMENTAR.md @DOCUMENTAR
DIRECTIVA-CALIDAD-CODIGO.md patrones/ANTIPATRONES.md @PATRONES
DIRECTIVA-DISENO-BASE-DATOS.md SIMCO-DDL.md @OP_DDL
ESTANDARES-API-REST-GENERICO.md SIMCO-BACKEND.md @OP_BACKEND

Checklist de Configuración

  • Archivo copiado a orchestration/00-guidelines/HERENCIA-SIMCO.md
  • Variables {VARIABLE} reemplazadas
  • Secciones no aplicables eliminadas
  • Directivas por dominio marcadas SI/NO
  • Directivas heredadas del padre documentadas (si aplica)
  • Directivas específicas locales listadas
  • Variables de contexto CCA definidas
  • CONTEXTO-PROYECTO.md actualizado con referencia a este archivo

Sistema: SIMCO v2.2.0 + CAPVED + CCA Protocol Template Version: 1.0.0