workspace-v1/projects/erp-suite/orchestration/00-guidelines/HERENCIA-DIRECTIVAS.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

4.3 KiB

Herencia de Directivas - ERP Suite

Arquitectura de Directivas

Este proyecto (nivel Suite) hereda directivas del workspace (core) y define directivas que aplican a todos sus verticales y al core ERP.

Directivas Globales (heredadas de core)

Path: ~/workspace/core/orchestration/directivas/

Estas directivas aplican a TODOS los proyectos del workspace:

Directiva Propósito
DIRECTIVA-FLUJO-5-FASES.md Workflow obligatorio de 5 fases
DIRECTIVA-VALIDACION-SUBAGENTES.md Validación de entregables
POLITICAS-USO-AGENTES.md Reglas de delegación
DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md Documentación requerida
DIRECTIVA-CALIDAD-CODIGO.md Estándares de código
DIRECTIVA-CONTROL-VERSIONES.md Git y versionado
DIRECTIVA-GESTION-BACKUPS-GITIGNORE.md Backups y gitignore
PROTOCOLO-ESCALAMIENTO-PO.md Escalamiento al PO
ESTANDARES-NOMENCLATURA-BASE.md Nomenclatura base
SISTEMA-RETROALIMENTACION.md Mejora continua

Directivas a Nivel Suite

Path: ~/workspace/projects/erp-suite/orchestration/directivas/

Directiva Propósito
(Por definir según necesidades de la suite) -

Prompts Base (heredados de core)

Path: ~/workspace/core/orchestration/prompts/base/

Prompt Uso
PROMPT-SUBAGENTES-BASE.md Instrucciones generales para subagentes
PROMPT-BUG-FIXER.md Corrección de bugs genérico
PROMPT-CODE-REVIEWER.md Revisión de código
PROMPT-FEATURE-DEVELOPER.md Desarrollo de features
PROMPT-DOCUMENTATION-VALIDATOR.md Validación de documentación
PROMPT-POLICY-AUDITOR.md Auditoría de políticas
PROMPT-REQUIREMENTS-ANALYST.md Análisis de requerimientos
PROMPT-WORKSPACE-MANAGER.md Gestión del workspace

Templates y Checklists (core)

Path: ~/workspace/core/orchestration/templates/

  • TEMPLATE-ANALISIS.md
  • TEMPLATE-PLAN.md
  • TEMPLATE-VALIDACION.md
  • TEMPLATE-CONTEXTO-SUBAGENTE.md

Path: ~/workspace/core/orchestration/checklists/

  • CHECKLIST-CODE-REVIEW-API.md
  • CHECKLIST-REFACTORIZACION.md

Orden de Precedencia (Suite Multi-Nivel)

Cuando hay conflicto entre directivas en la suite:

  1. Directivas específicas del vertical (mayor prioridad)
  2. Directivas de erp-core
  3. Directivas a nivel suite
  4. Directivas globales del workspace
  5. Prompts específicos
  6. Prompts base del workspace

Estructura de Herencia en la Suite

workspace/core (Nivel 1)
    └── erp-suite (Nivel 2B)
        ├── erp-core (Nivel 2B.1)
        │   └── [directivas core ERP]
        └── verticales/ (Nivel 2B.2)
            ├── construccion/
            ├── vidrio-templado/
            ├── mecanicas-diesel/
            ├── clinicas/
            └── retail/

Cada vertical hereda:

  1. Directivas de core/orchestration/directivas/
  2. Directivas de erp-suite/orchestration/directivas/
  3. Directivas de erp-core/orchestration/directivas/
  4. Sus propias directivas específicas

Catálogo de Funcionalidades Usado

Este proyecto utiliza las siguientes funcionalidades del catálogo core:

Funcionalidad Uso en la suite
auth Autenticación centralizada
multi-tenancy Separación por empresa/sucursal

Path catálogo: ~/workspace/core/catalog/

Uso para Subagentes

Al invocar un subagente para trabajar en la suite, incluir en el contexto:

DIRECTIVAS_A_LEER:
  globales:
    - ~/workspace/core/orchestration/directivas/DIRECTIVA-FLUJO-5-FASES.md
    - ~/workspace/core/orchestration/directivas/POLITICAS-USO-AGENTES.md
  suite:
    - ~/workspace/projects/erp-suite/orchestration/directivas/[DIRECTIVA-SUITE].md
  erp_core:
    - ~/workspace/projects/erp-suite/apps/erp-core/orchestration/directivas/[DIRECTIVA-CORE].md
  vertical:
    - ~/workspace/projects/erp-suite/apps/verticales/[VERTICAL]/orchestration/directivas/[DIRECTIVA].md
  prompt_base:
    - ~/workspace/core/orchestration/prompts/base/PROMPT-SUBAGENTES-BASE.md
  contexto_proyecto:
    - ~/workspace/projects/erp-suite/orchestration/00-guidelines/CONTEXTO-PROYECTO.md

Sistema NEXUS + SIMCO v2.2.0 - ERP Suite Nivel: 2B (Suite Multi-Vertical) Actualizado: 2025-12-08