erp-core/orchestration/00-guidelines/HERENCIA-DIRECTIVAS.md
rckrdmrd 4c4e27d9ba feat: Documentation and orchestration updates
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 05:35:20 -06:00

145 lines
5.0 KiB
Markdown

# 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: `shared/catalog/` *(componentes reutilizables)*
- Estándar de documentación: `/home/isem/workspace/core/standards/ESTANDAR-ESTRUCTURA-DOCUMENTACION.md`
---
*Última actualización: Diciembre 2025*