rckrdmrd
608e1e2a2e
Some checks are pending
CI Pipeline / changes (push) Waiting to run
CI Pipeline / core (push) Blocked by required conditions
CI Pipeline / trading-backend (push) Blocked by required conditions
CI Pipeline / trading-data-service (push) Blocked by required conditions
CI Pipeline / trading-frontend (push) Blocked by required conditions
CI Pipeline / erp-core (push) Blocked by required conditions
CI Pipeline / erp-mecanicas (push) Blocked by required conditions
CI Pipeline / gamilit-backend (push) Blocked by required conditions
CI Pipeline / gamilit-frontend (push) Blocked by required conditions
Gamilit: - Backend: Teacher services, assignments, gamification, exercise submissions - Frontend: Admin/Teacher/Student portals, module 4-5 mechanics, monitoring - Database: DDL functions, seeds for dev/prod, auth/gamification schemas - Docs: Architecture, features, guides cleanup and reorganization Core/Orchestration: - New workspace directives index - Documentation directive Trading-platform: - Database seeds and inventory updates - Tech leader validation report 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
401 lines
12 KiB
Markdown
401 lines
12 KiB
Markdown
# PLAN: SISTEMA DE DIRECTIVAS MULTINIVEL
|
|
|
|
**Fecha:** 2025-12-18
|
|
**Tipo:** Plan de Implementacion
|
|
**Estado:** FASE 1 - Planeacion
|
|
|
|
---
|
|
|
|
## OBJETIVO
|
|
|
|
Crear un sistema de directivas con trazabilidad completa que permita:
|
|
|
|
1. **Directivas genericas** a nivel WORKSPACE/CORE
|
|
2. **Directivas especificas** en cada nivel de proyecto
|
|
3. **Carga automatica** segun el nivel de trabajo especificado
|
|
4. **Herencia clara** entre niveles
|
|
|
|
---
|
|
|
|
## NIVELES IDENTIFICADOS EN EL WORKSPACE
|
|
|
|
```
|
|
NIVEL 0: WORKSPACE
|
|
└── /home/isem/workspace/
|
|
|
|
NIVEL 1: CORE
|
|
└── /home/isem/workspace/core/
|
|
|
|
NIVEL 2A: STANDALONE (5 proyectos)
|
|
├── gamilit
|
|
├── trading-platform
|
|
├── betting-analytics
|
|
├── inmobiliaria-analytics
|
|
└── platform_marketing_content
|
|
|
|
NIVEL 2B: SUITE (erp-suite)
|
|
├── NIVEL 2B.1: SUITE-CORE (erp-core)
|
|
├── NIVEL 2B.2: VERTICALES (5)
|
|
│ ├── clinicas
|
|
│ ├── construccion
|
|
│ ├── mecanicas-diesel
|
|
│ ├── retail
|
|
│ └── vidrio-templado
|
|
├── NIVEL 2B.3: SUITE-SERVICE (saas)
|
|
└── NIVEL 2B.4: SUITE-PRODUCT (erp-basico, pos-micro)
|
|
```
|
|
|
|
---
|
|
|
|
## ARQUITECTURA DE DIRECTIVAS POR NIVEL
|
|
|
|
### Estructura Propuesta
|
|
|
|
```
|
|
NIVEL 0: WORKSPACE
|
|
/home/isem/workspace/
|
|
├── orchestration/
|
|
│ ├── directivas/
|
|
│ │ ├── DIRECTIVA-WORKSPACE-ESTANDAR.md # [NUEVO] Estandar workspace
|
|
│ │ └── DIRECTIVA-CARGA-CONTEXTO.md # [NUEVO] Como cargar contexto
|
|
│ └── INDICE-DIRECTIVAS-WORKSPACE.yml # [NUEVO] Indice maestro
|
|
|
|
NIVEL 1: CORE
|
|
/home/isem/workspace/core/
|
|
├── orchestration/
|
|
│ ├── directivas/
|
|
│ │ ├── simco/ # [EXISTENTE] 22 SIMCO
|
|
│ │ ├── principios/ # [EXISTENTE] 6 principios
|
|
│ │ └── DIRECTIVA-DOCUMENTACION-DEFINITIVA.md # [MOVER AQUI]
|
|
│ └── INDICE-DIRECTIVAS-CORE.yml # [NUEVO]
|
|
|
|
NIVEL 2A: STANDALONE
|
|
/home/isem/workspace/projects/{proyecto}/
|
|
├── docs/
|
|
│ └── 00-vision-general/
|
|
│ └── directivas/ # [NUEVO] Por proyecto
|
|
│ └── DIRECTIVA-{PROYECTO}-ESPECIFICA.md
|
|
├── orchestration/
|
|
│ ├── 00-guidelines/
|
|
│ │ ├── CONTEXTO-PROYECTO.md # [EXISTENTE]
|
|
│ │ ├── HERENCIA-SIMCO.md # [EXISTENTE]
|
|
│ │ └── HERENCIA-DIRECTIVAS.md # [ACTUALIZAR]
|
|
│ └── INDICE-DIRECTIVAS-PROYECTO.yml # [NUEVO]
|
|
|
|
NIVEL 2B.2: VERTICAL
|
|
/home/isem/workspace/projects/erp-suite/apps/verticales/{vertical}/
|
|
├── docs/
|
|
│ └── 00-vision-general/
|
|
│ └── directivas/ # Por vertical
|
|
├── orchestration/
|
|
│ └── 00-guidelines/
|
|
│ ├── HERENCIA-SIMCO.md
|
|
│ ├── HERENCIA-ERP-CORE.md
|
|
│ └── HERENCIA-DIRECTIVAS.md
|
|
```
|
|
|
|
---
|
|
|
|
## MECANISMO DE CARGA: CADENA DE HERENCIA
|
|
|
|
### Flujo de Carga Segun Nivel
|
|
|
|
```yaml
|
|
Cuando el usuario especifica:
|
|
proyecto: "gamilit"
|
|
subproyecto: null
|
|
tarea: "crear endpoint"
|
|
|
|
El sistema debe cargar (en orden):
|
|
1. WORKSPACE: orchestration/directivas/DIRECTIVA-WORKSPACE-ESTANDAR.md
|
|
2. CORE: core/orchestration/directivas/principios/*.md
|
|
3. CORE: core/orchestration/directivas/simco/SIMCO-TAREA.md
|
|
4. CORE: core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md
|
|
5. PROYECTO: projects/gamilit/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
|
|
6. PROYECTO: projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
7. PROYECTO: projects/gamilit/docs/00-vision-general/directivas/*.md (si existen)
|
|
```
|
|
|
|
```yaml
|
|
Cuando el usuario especifica:
|
|
proyecto: "erp-suite"
|
|
subproyecto: "verticales/construccion"
|
|
tarea: "modificar tabla"
|
|
|
|
El sistema debe cargar (en orden):
|
|
1. WORKSPACE: directivas workspace
|
|
2. CORE: principios + SIMCO
|
|
3. SUITE: erp-suite/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
|
|
4. SUITE-CORE: erp-suite/apps/erp-core/orchestration/00-guidelines/*.md
|
|
5. VERTICAL: verticales/construccion/orchestration/00-guidelines/*.md
|
|
6. VERTICAL: verticales/construccion/docs/00-vision-general/directivas/*.md
|
|
```
|
|
|
|
---
|
|
|
|
## INDICE MAESTRO DE DIRECTIVAS
|
|
|
|
### Archivo: INDICE-DIRECTIVAS-WORKSPACE.yml
|
|
|
|
```yaml
|
|
# /home/isem/workspace/orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml
|
|
version: "1.0.0"
|
|
fecha_actualizacion: "2025-12-18"
|
|
descripcion: "Indice maestro de todas las directivas del workspace"
|
|
|
|
niveles:
|
|
WORKSPACE:
|
|
ruta: "/home/isem/workspace"
|
|
directivas:
|
|
- ruta: "orchestration/directivas/DIRECTIVA-WORKSPACE-ESTANDAR.md"
|
|
tipo: "estandar"
|
|
obligatoria: true
|
|
descripcion: "Procedimiento estandar para todo el workspace"
|
|
- ruta: "orchestration/directivas/DIRECTIVA-CARGA-CONTEXTO.md"
|
|
tipo: "proceso"
|
|
obligatoria: true
|
|
descripcion: "Como cargar contexto segun nivel"
|
|
|
|
CORE:
|
|
ruta: "/home/isem/workspace/core"
|
|
directivas:
|
|
principios:
|
|
- ruta: "orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
|
|
alias: "@CAPVED"
|
|
obligatoria: true
|
|
- ruta: "orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
|
|
alias: "@DOC-PRIMERO"
|
|
obligatoria: true
|
|
- ruta: "orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
|
|
alias: "@ANTI-DUP"
|
|
obligatoria: true
|
|
- ruta: "orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
|
|
alias: "@VALIDAR"
|
|
obligatoria: true
|
|
operaciones:
|
|
- ruta: "orchestration/directivas/simco/SIMCO-TAREA.md"
|
|
alias: "@TAREA"
|
|
obligatoria: true
|
|
- ruta: "orchestration/directivas/simco/SIMCO-*.md"
|
|
alias: "@OP_*"
|
|
obligatoria: false
|
|
descripcion: "Segun operacion requerida"
|
|
documentacion:
|
|
- ruta: "orchestration/directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md"
|
|
alias: "@DOC-DEFINITIVA"
|
|
obligatoria: true
|
|
|
|
PROYECTOS:
|
|
STANDALONE:
|
|
patron_ruta: "/home/isem/workspace/projects/{proyecto}"
|
|
directivas:
|
|
contexto:
|
|
- ruta: "orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
|
|
obligatoria: true
|
|
- ruta: "orchestration/00-guidelines/HERENCIA-SIMCO.md"
|
|
obligatoria: true
|
|
especificas:
|
|
- ruta: "docs/00-vision-general/directivas/*.md"
|
|
obligatoria: false
|
|
descripcion: "Directivas especificas del proyecto"
|
|
proyectos:
|
|
- nombre: "gamilit"
|
|
tipo: "STANDALONE"
|
|
- nombre: "trading-platform"
|
|
tipo: "STANDALONE"
|
|
- nombre: "betting-analytics"
|
|
tipo: "STANDALONE"
|
|
- nombre: "inmobiliaria-analytics"
|
|
tipo: "STANDALONE"
|
|
|
|
SUITE:
|
|
patron_ruta: "/home/isem/workspace/projects/{suite}"
|
|
suites:
|
|
- nombre: "erp-suite"
|
|
tipo: "SUITE"
|
|
subniveles:
|
|
SUITE-CORE:
|
|
ruta: "apps/erp-core"
|
|
hereda_de: ["SUITE"]
|
|
VERTICALES:
|
|
patron_ruta: "apps/verticales/{vertical}"
|
|
hereda_de: ["SUITE", "SUITE-CORE"]
|
|
verticales:
|
|
- "clinicas"
|
|
- "construccion"
|
|
- "mecanicas-diesel"
|
|
- "retail"
|
|
- "vidrio-templado"
|
|
|
|
cadena_herencia:
|
|
STANDALONE:
|
|
orden: ["WORKSPACE", "CORE", "PROYECTO"]
|
|
SUITE:
|
|
orden: ["WORKSPACE", "CORE", "SUITE"]
|
|
SUITE-CORE:
|
|
orden: ["WORKSPACE", "CORE", "SUITE", "SUITE-CORE"]
|
|
VERTICAL:
|
|
orden: ["WORKSPACE", "CORE", "SUITE", "SUITE-CORE", "VERTICAL"]
|
|
```
|
|
|
|
---
|
|
|
|
## DIRECTIVA DE CARGA DE CONTEXTO
|
|
|
|
### Archivo: DIRECTIVA-CARGA-CONTEXTO.md
|
|
|
|
Esta directiva define COMO cargar las directivas correctas segun el nivel especificado:
|
|
|
|
```markdown
|
|
# DIRECTIVA: CARGA DE CONTEXTO SEGUN NIVEL
|
|
|
|
## PASO 1: IDENTIFICAR NIVEL
|
|
|
|
Cuando recibas un prompt con:
|
|
- proyecto: {nombre}
|
|
- subproyecto: {nombre} (opcional)
|
|
- tarea: {descripcion}
|
|
|
|
Determinar el nivel:
|
|
|
|
| Si proyecto es... | Y subproyecto es... | Entonces nivel es... |
|
|
|-------------------|---------------------|----------------------|
|
|
| gamilit, trading-platform, etc. | null | STANDALONE |
|
|
| erp-suite | null | SUITE |
|
|
| erp-suite | erp-core | SUITE-CORE |
|
|
| erp-suite | verticales/{nombre} | VERTICAL |
|
|
|
|
## PASO 2: CARGAR DIRECTIVAS EN ORDEN
|
|
|
|
Consultar INDICE-DIRECTIVAS-WORKSPACE.yml:
|
|
1. Obtener cadena_herencia[{nivel}].orden
|
|
2. Para cada nivel en orden:
|
|
a. Cargar directivas obligatorias
|
|
b. Cargar directivas especificas si existen
|
|
|
|
## PASO 3: RESOLVER CONTEXTO
|
|
|
|
Leer CONTEXTO-PROYECTO.md del nivel mas especifico:
|
|
- Obtener variables ({PROJECT}, {DB_DDL_PATH}, etc.)
|
|
- Resolver placeholders en directivas
|
|
|
|
## PASO 4: CONFIRMAR CARGA
|
|
|
|
Generar resumen:
|
|
- Nivel identificado: {nivel}
|
|
- Directivas cargadas: [lista]
|
|
- Contexto resuelto: {variables}
|
|
- Estado: READY_TO_EXECUTE
|
|
```
|
|
|
|
---
|
|
|
|
## TEMPLATE DE PROMPT PARA AGENTES
|
|
|
|
### Prompt Estandar que SI Funcionara
|
|
|
|
```markdown
|
|
## Contexto de Trabajo
|
|
|
|
**Perfil:** {nombre_perfil}
|
|
**Archivo de perfil:** {ruta al archivo de perfil}
|
|
|
|
**Proyecto:** {nombre_proyecto}
|
|
**Subproyecto:** {nombre_subproyecto o "null"}
|
|
**Nivel:** {STANDALONE | SUITE | SUITE-CORE | VERTICAL}
|
|
|
|
**Tarea:** {descripcion de la tarea}
|
|
|
|
---
|
|
|
|
### Directivas a Cargar (Obligatorio)
|
|
|
|
Antes de iniciar, cargar en orden:
|
|
|
|
1. **WORKSPACE:**
|
|
- Leer: /home/isem/workspace/orchestration/directivas/DIRECTIVA-CARGA-CONTEXTO.md
|
|
|
|
2. **CORE (Principios):**
|
|
- Leer: core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md
|
|
- Leer: core/orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md
|
|
|
|
3. **CORE (Operacion):**
|
|
- Leer: core/orchestration/directivas/simco/SIMCO-TAREA.md
|
|
- Leer: core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md
|
|
|
|
4. **PROYECTO:**
|
|
- Leer: projects/{proyecto}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
|
|
- Leer: projects/{proyecto}/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
5. **ESPECIFICAS (si existen):**
|
|
- Leer: projects/{proyecto}/docs/00-vision-general/directivas/*.md
|
|
|
|
---
|
|
|
|
### Procedimiento
|
|
|
|
Seguir ciclo CAPVED:
|
|
1. C - Contexto: Confirmar directivas cargadas
|
|
2. A - Analisis: Analizar alcance
|
|
3. P - Planeacion: Crear plan
|
|
4. V - Validacion: Validar plan
|
|
5. E - Ejecucion: Implementar
|
|
6. D - Documentacion: Actualizar docs/ como estado FINAL
|
|
```
|
|
|
|
---
|
|
|
|
## ARCHIVOS A CREAR
|
|
|
|
### Lista de Implementacion
|
|
|
|
| # | Archivo | Nivel | Proposito |
|
|
|---|---------|-------|-----------|
|
|
| 1 | `workspace/orchestration/directivas/DIRECTIVA-WORKSPACE-ESTANDAR.md` | WORKSPACE | Estandar global |
|
|
| 2 | `workspace/orchestration/directivas/DIRECTIVA-CARGA-CONTEXTO.md` | WORKSPACE | Como cargar contexto |
|
|
| 3 | `workspace/orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml` | WORKSPACE | Indice maestro |
|
|
| 4 | `core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md` | CORE | Mover de .claude/ |
|
|
| 5 | `gamilit/docs/00-vision-general/directivas/_INDEX.md` | PROYECTO | Indice directivas proyecto |
|
|
| 6 | Actualizar `HERENCIA-SIMCO.md` en cada proyecto | PROYECTO | Incluir nuevas directivas |
|
|
|
|
### Archivos a Eliminar
|
|
|
|
| Archivo | Razon |
|
|
|---------|-------|
|
|
| `.claude/directivas/DIRECTIVA-FASES-ESTANDAR.md` | Duplica CAPVED |
|
|
| `.claude/directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md` | Mover a core/ |
|
|
| `CLAUDE.md` | Reemplazado por sistema de carga |
|
|
|
|
---
|
|
|
|
## VALIDACION DEL PLAN
|
|
|
|
### Criterios de Exito
|
|
|
|
1. [ ] Un prompt con "proyecto: gamilit, tarea: X" carga las directivas correctas
|
|
2. [ ] Un prompt con "proyecto: erp-suite, subproyecto: verticales/construccion" carga la cadena completa
|
|
3. [ ] Los subagentes pueden recibir el mismo formato de prompt
|
|
4. [ ] El sistema funciona sin dependencia de .claude/
|
|
5. [ ] Todo esta en ubicaciones portables (orchestration/ o docs/)
|
|
6. [ ] INDICE-DIRECTIVAS-WORKSPACE.yml mapea todas las directivas
|
|
|
|
---
|
|
|
|
## SIGUIENTE PASO
|
|
|
|
¿Aprobar este plan para proceder con la implementacion?
|
|
|
|
Si se aprueba:
|
|
1. Crear directivas a nivel WORKSPACE
|
|
2. Mover directivas de .claude/ a core/
|
|
3. Crear estructura docs/00-vision-general/directivas/ en GAMILIT
|
|
4. Actualizar archivos HERENCIA-*.md
|
|
5. Crear INDICE-DIRECTIVAS-WORKSPACE.yml
|
|
6. Eliminar archivos obsoletos
|
|
|
|
---
|
|
|
|
**Generado por:** Requirements-Analyst
|
|
**Fecha:** 2025-12-18
|
|
**Estado:** Esperando aprobacion
|