erp-core/orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md

5.0 KiB

Herencia de Directivas - ERP Core

Jerarquía de Directivas

Este proyecto hereda directivas en el siguiente orden de precedencia (de mayor a menor):

1. Directivas Globales (CORE)     → /home/isem/workspace/core/orchestration/directivas/
2. Directivas ERP-Suite           → /home/isem/workspace/projects/erp-suite/orchestration/directivas/
3. Directivas ERP-Core            → ./directivas/  (este proyecto)

Regla: Las directivas específicas pueden EXTENDER las globales, nunca REDUCIRLAS.


Directivas Globales Heredadas (18)

Ubicación: /home/isem/workspace/core/orchestration/directivas/

Directivas Críticas (Obligatorias)

Directiva Propósito Aplicación
DIRECTIVA-FLUJO-5-FASES.md Define el flujo de trabajo en 5 fases Toda tarea
DIRECTIVA-VALIDACION-SUBAGENTES.md Validación de subagentes Orquestación
POLITICAS-USO-AGENTES.md Políticas de uso de agentes Orquestación
DIRECTIVA-VALIDACION-DOCUMENTACION.md Validar contra /docs/ Toda tarea
DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md Documentación requerida Toda tarea

Directivas de Calidad

Directiva Propósito Aplicación
DIRECTIVA-CALIDAD-CODIGO.md Estándares de código Backend/Frontend
DIRECTIVA-DISENO-BASE-DATOS.md Diseño de BD Database
POLITICAS-MODULARIZACION.md Archivos <400 líneas Todo código
ESTANDARES-NOMENCLATURA-BASE.md Nomenclatura estándar Todo

Directivas de Proceso

Directiva Propósito Aplicación
DIRECTIVAS-FLUJOS.md Flujos de trabajo Proceso
DIRECTIVAS-MICROCICLOS-ANIDADOS.md Descomposición de tareas Planeación
DIRECTIVAS-PARALELIZACION.md Pool de 15 subagentes Orquestación
GUIA-ORQUESTACION.md Guía de orquestación Orquestación
DELIMITACION-PERFILES.md Responsabilidades por perfil Roles

Directivas de Control

Directiva Propósito Aplicación
DIRECTIVA-CONTROL-VERSIONES.md Control de versiones Git
DIRECTIVA-GESTION-BACKUPS-GITIGNORE.md Backups y gitignore Archivos
PROTOCOLO-ESCALAMIENTO-PO.md Escalamiento a PO Decisiones
DIRECTIVAS-PRINCIPALES.md Consolidado principal Referencia

Directivas Especificas de ERP-Core

Ubicacion: ./directivas/

Directivas ACTIVAS

Directiva Proposito Estado
DIRECTIVA-MULTI-TENANT.md Aislamiento por tenant_id ACTIVA
DIRECTIVA-EXTENSION-VERTICALES.md Como extienden las verticales ACTIVA
DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md Documentar ANTES de desarrollar ACTIVA
DIRECTIVA-PATRONES-ODOO.md Patrones de diseno basados en Odoo ACTIVA

Directivas PENDIENTES

Directiva Proposito Estado
DIRECTIVA-HERENCIA-MODULOS.md Herencia de modulos base Por crear
ESTANDARES-API-REST-GENERICO.md APIs RESTful estandar Por crear
POLITICA-REUTILIZACION-CODE.md Codigo reutilizable Por crear

Directivas Criticas para ERP

Las siguientes directivas son OBLIGATORIAS para cualquier desarrollo en ERP:

1. Pre-Desarrollo (ANTES de escribir codigo)

  1. DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md - Documentar todo antes de desarrollar
  2. DIRECTIVA-PATRONES-ODOO.md - Seguir patrones probados de Odoo

2. Arquitectura

  1. DIRECTIVA-MULTI-TENANT.md - Todo filtrado por tenant_id
  2. DIRECTIVA-EXTENSION-VERTICALES.md - Verticales EXTIENDEN, no modifican

3. Proceso

  1. core/orchestration/directivas/DIRECTIVA-FLUJO-5-FASES.md - Flujo obligatorio
  2. core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md - Docs en tiempo real

Cómo Aplicar Directivas

En Análisis (Fase 1)

  1. Leer DIRECTIVAS-PRINCIPALES.md
  2. Identificar directivas aplicables a la tarea
  3. Documentar en 01-analisis/

En Planeación (Fase 2)

  1. Verificar cumplimiento de directivas en el plan
  2. Referenciar directivas en 02-planeacion/

En Validación (Fase 3)

  1. Usar checklist de directivas
  2. Documentar en 05-validaciones/pre/

En Ejecución (Fase 4)

  1. Seguir directivas durante implementación
  2. Registrar desviaciones en 04-ejecucion-logs/

En Cierre (Fase 5)

  1. Validar cumplimiento final
  2. Documentar en 05-validaciones/post/

Resolución de Conflictos

Si hay conflicto entre directivas:

  1. Directiva específica tiene precedencia sobre genérica
  2. Directiva más restrictiva prevalece
  3. Escalar a PO si no hay claridad (ver PROTOCOLO-ESCALAMIENTO-PO.md)

Referencias

  • Core directivas: /home/isem/workspace/core/orchestration/directivas/
  • Catálogo central: core/catalog/ (componentes reutilizables)
  • Estándar de documentación: /home/isem/workspace/core/standards/ESTANDAR-ESTRUCTURA-DOCUMENTACION.md

Última actualización: Diciembre 2025