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>
196 lines
5.6 KiB
Markdown
196 lines
5.6 KiB
Markdown
# REPORTE: ACTUALIZACION DE DIRECTIVAS Y AGENTES
|
|
|
|
**Fecha:** 2025-12-18
|
|
**Rol:** Requirements-Analyst
|
|
**Estado:** COMPLETADO
|
|
|
|
---
|
|
|
|
## RESUMEN EJECUTIVO
|
|
|
|
Se actualizo el sistema de directivas del proyecto GAMILIT para:
|
|
|
|
1. Establecer un procedimiento estandar de 5 fases obligatorio
|
|
2. Definir que la documentacion es el estado FINAL del sistema
|
|
3. Crear persistencia a traves de /compact con CLAUDE.md
|
|
4. Integrar con el sistema SIMCO/CAPVED existente
|
|
|
|
---
|
|
|
|
## ARCHIVOS CREADOS
|
|
|
|
### 1. DIRECTIVA-FASES-ESTANDAR.md
|
|
|
|
**Ubicacion:** `.claude/directivas/DIRECTIVA-FASES-ESTANDAR.md`
|
|
|
|
**Contenido:**
|
|
- Procedimiento obligatorio de 5 fases
|
|
- Fase 1: Planeacion inicial (analisis detallado)
|
|
- Fase 2: Ejecucion de analisis (segun plan)
|
|
- Fase 3: Planeacion de implementaciones
|
|
- Fase 4: Validacion (plan vs analisis)
|
|
- Fase 5: Ejecucion de implementaciones
|
|
- Guia de uso de subagentes
|
|
- Integracion con CAPVED
|
|
|
|
### 2. DIRECTIVA-DOCUMENTACION-DEFINITIVA.md
|
|
|
|
**Ubicacion:** `.claude/directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md`
|
|
|
|
**Contenido:**
|
|
- Principio: docs/ = estado FINAL del sistema
|
|
- Separacion: docs/ (definitivo) vs orchestration/ (proceso)
|
|
- Reglas de actualizacion
|
|
- SSOT para metricas
|
|
- Trazabilidad de documentacion deprecada
|
|
- Ejemplos de aplicacion
|
|
|
|
### 3. CLAUDE.md
|
|
|
|
**Ubicacion:** `/home/isem/workspace/projects/gamilit/CLAUDE.md`
|
|
|
|
**Proposito:**
|
|
- Persistencia a traves de /compact
|
|
- Carga automatica al inicio de cada sesion
|
|
- Resumen de directivas criticas
|
|
- Contexto del proyecto
|
|
- Metricas actuales
|
|
|
|
---
|
|
|
|
## ARCHIVOS ACTUALIZADOS
|
|
|
|
### _MAP.md de Directivas
|
|
|
|
**Ubicacion:** `.claude/directivas/_MAP.md`
|
|
|
|
**Cambios:**
|
|
- Agregadas 2 nuevas directivas al listado
|
|
- Actualizado total de archivos: 11 -> 13
|
|
- Actualizada fecha: 2025-11-02 -> 2025-12-18
|
|
- Agregadas a seccion de directivas criticas
|
|
|
|
---
|
|
|
|
## ESTRUCTURA FINAL DE DIRECTIVAS
|
|
|
|
```
|
|
.claude/directivas/
|
|
├── DIRECTIVAS-PRINCIPALES.md # Consolidado
|
|
├── DIRECTIVA-VALIDACION-DOCUMENTACION.md # Validacion contra docs
|
|
├── DIRECTIVA-FASES-ESTANDAR.md # [NUEVO] 5 fases
|
|
├── DIRECTIVA-DOCUMENTACION-DEFINITIVA.md # [NUEVO] Docs como estado final
|
|
├── GUIA-ORQUESTACION.md # Subagentes
|
|
├── DIRECTIVAS-FLUJOS.md # Flujos de trabajo
|
|
├── DIRECTIVAS-MICROCICLOS-ANIDADOS.md # Microciclos
|
|
├── DIRECTIVAS-PARALELIZACION.md # 15 subagentes max
|
|
├── POLITICAS-MODULARIZACION.md # Archivos <400L
|
|
├── PRINCIPIOS-SOLID-DOCS.md # SOLID para docs
|
|
├── DELIMITACION-PERFILES.md # Responsabilidades
|
|
├── PROCESO-VALIDACION.md # Validacion
|
|
└── _MAP.md # Indice
|
|
```
|
|
|
|
---
|
|
|
|
## INTEGRACION CON SISTEMAS EXISTENTES
|
|
|
|
### Relacion CAPVED <-> Fases Estandar
|
|
|
|
```
|
|
CAPVED FASES ESTANDAR
|
|
------ --------------
|
|
C - Contexto -> FASE 1: Planeacion inicial
|
|
A - Analisis -> FASE 2: Ejecucion de analisis
|
|
P - Planeacion -> FASE 3: Planeacion de implementaciones
|
|
V - Validacion -> FASE 4: Validacion
|
|
E - Ejecucion -> FASE 5: Ejecucion de implementaciones
|
|
D - Documentacion -> Integrado en cada fase
|
|
```
|
|
|
|
### Relacion con Sistema NEXUS
|
|
|
|
- NEXUS define 5 perfiles de agentes (Backend, Frontend, Database, DevOps, Integration)
|
|
- Las nuevas directivas aplican a TODOS los perfiles
|
|
- Se mantiene el limite de 15 subagentes compartidos
|
|
- Se integra con validacion contra docs existente
|
|
|
|
---
|
|
|
|
## PERSISTENCIA A TRAVES DE /COMPACT
|
|
|
|
### Mecanismo
|
|
|
|
1. **CLAUDE.md** en raiz del proyecto
|
|
- Se lee automaticamente al inicio de cada sesion
|
|
- Contiene directivas criticas resumidas
|
|
- Incluye contexto del proyecto y metricas
|
|
|
|
2. **Verificacion de carga**
|
|
- Al iniciar sesion, verificar que directivas estan activas
|
|
- Si no: Leer CLAUDE.md para recargar contexto
|
|
|
|
### Contenido de CLAUDE.md
|
|
|
|
- Procedimiento de 5 fases (resumen)
|
|
- Principio de documentacion definitiva
|
|
- SSOT y fuentes de verdad
|
|
- Contexto del proyecto
|
|
- Stack tecnologico
|
|
- Rutas importantes
|
|
- Checklist rapido
|
|
|
|
---
|
|
|
|
## VALIDACION
|
|
|
|
### Criterios Cumplidos
|
|
|
|
- [x] Directiva de 5 fases creada
|
|
- [x] Directiva de documentacion definitiva creada
|
|
- [x] CLAUDE.md para persistencia creado
|
|
- [x] _MAP.md actualizado con nuevas directivas
|
|
- [x] Integracion con CAPVED documentada
|
|
- [x] Integracion con NEXUS mantenida
|
|
- [x] Metricas actuales incluidas en CLAUDE.md
|
|
|
|
### Principios Aplicados
|
|
|
|
1. **Fases separadas:** Cada tarea pasa por 5 fases
|
|
2. **Documentacion definitiva:** docs/ = estado actual, orchestration/ = proceso
|
|
3. **Persistencia:** CLAUDE.md carga directivas automaticamente
|
|
4. **Subagentes:** Pueden ejecutar fases delegadas con contexto completo
|
|
|
|
---
|
|
|
|
## PROXIMOS PASOS SUGERIDOS
|
|
|
|
1. **Actualizar perfiles de agentes** en `.claude/agents/` para referenciar nuevas directivas
|
|
2. **Crear template de reporte** para cada fase del procedimiento
|
|
3. **Actualizar README.md** del proyecto con referencia a CLAUDE.md
|
|
4. **Validar con equipo** que el procedimiento de 5 fases es adecuado
|
|
|
|
---
|
|
|
|
## CONCLUSION
|
|
|
|
El sistema de directivas ahora tiene:
|
|
|
|
1. **Procedimiento claro:** 5 fases obligatorias para toda tarea
|
|
2. **Documentacion consistente:** Estado final, no historico
|
|
3. **Persistencia:** Directivas se cargan automaticamente
|
|
4. **Integracion:** Compatible con SIMCO, CAPVED y NEXUS existentes
|
|
|
|
Esto garantiza que:
|
|
- Los agentes siempre siguen el mismo procedimiento
|
|
- La documentacion siempre refleja el estado actual
|
|
- El contexto no se pierde con /compact
|
|
- Los subagentes reciben contexto completo
|
|
|
|
---
|
|
|
|
**Generado por:** Requirements-Analyst
|
|
**Fecha:** 2025-12-18
|
|
**Version:** 1.0
|
|
**Estado:** COMPLETADO
|