3a8a459d91
## Directivas SIMCO v3.7.0 - Estandarizacion de Documentacion (7) - SIMCO-DOCUMENTACION-PROYECTO.md - SIMCO-NOMENCLATURA.md - SIMCO-ESTRUCTURA-DOCS.md - SIMCO-INVENTARIOS.md - SIMCO-TESTING.md - SIMCO-MIGRACIONES-BD.md - SIMCO-INTEGRACIONES-EXTERNAS.md ## Directivas SIMCO v3.8.0 - Mantenimiento de Documentacion (2) - SIMCO-MANTENIMIENTO-DOCUMENTACION.md - SIMCO-SINCRONIZACION-BD.md ## Templates (4) - TEMPLATE-INVENTARIO-PROYECTO.md - TEMPLATE-INTEGRACION-EXTERNA.md - TEMPLATE-MODULO-ESTANDAR.md - TEMPLATE-DEPRECACION.md ## Checklists (6) - CHECKLIST-DOCUMENTACION-PROYECTO.md - CHECKLIST-INVENTARIOS.md - CHECKLIST-NOMENCLATURA.md - CHECKLIST-MANTENIMIENTO-DOCS.md - CHECKLIST-SINCRONIZACION-BD.md - _MAP.md ## Perfil de Agente (1) - PERFIL-DOCUMENTATION-MAINTAINER.md ## Indices - INDICE-DIRECTIVAS-WORKSPACE.yml actualizado a v3.8.0 ## Submodulos actualizados (14) - gamilit, erp-core, michangarrito, template-saas - erp-suite, erp-construccion, erp-clinicas - erp-mecanicas-diesel, erp-retail, erp-vidrio-templado - trading-platform, betting-analytics - inmobiliaria-analytics, platform_marketing_content Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
234 lines
9.5 KiB
Markdown
234 lines
9.5 KiB
Markdown
# VALIDACIÓN DEL PLAN - DIRECTIVA DE MANTENIMIENTO DE DOCUMENTACIÓN
|
|
**Fecha:** 2026-01-10
|
|
**Fase:** 4 - Validación
|
|
**Estado:** EN PROGRESO
|
|
|
|
---
|
|
|
|
## 1. VALIDACIÓN DE COBERTURA DE REQUISITOS
|
|
|
|
### 1.1 Requisitos Funcionales (RF)
|
|
|
|
| ID | Requisito | Cubierto | Artefacto | Sección | Validación |
|
|
|----|-----------|----------|-----------|---------|------------|
|
|
| RF-01 | Purga gradual post-tarea/fase | ✅ SÍ | SIMCO-MANTENIMIENTO-DOCUMENTACION.md | §8. Purga Gradual | 5 subsecciones definen qué/cómo purgar |
|
|
| RF-02 | Deprecación sistemática de históricos | ✅ SÍ | SIMCO-MANTENIMIENTO-DOCUMENTACION.md | §7. Protocolo de Deprecación | 5 subsecciones + TEMPLATE-DEPRECACION |
|
|
| RF-03 | Actualización obligatoria de docs | ✅ SÍ | SIMCO-MANTENIMIENTO-DOCUMENTACION.md | §3. Triggers + §4. Ciclo | Triggers claros + ciclo de 6 pasos |
|
|
| RF-04 | Validación de dependencias (docs↔código↔BD) | ✅ SÍ | SIMCO-MANTENIMIENTO-DOCUMENTACION.md | §5. Validación de Dependencias | Matriz de impacto + checklists |
|
|
| RF-05 | Scripts BD sincronizados con cambios DDL | ✅ SÍ | SIMCO-SINCRONIZACION-BD.md | §4. Validación de Scripts | Proceso completo de sincronización |
|
|
| RF-06 | Análisis de objetos dependientes | ✅ SÍ | SIMCO-SINCRONIZACION-BD.md | §5. Matriz de Dependencias | Dependencias DDL detalladas |
|
|
| RF-07 | Agentes consulten directivas automáticamente | ✅ SÍ | SIMCO-MANTENIMIENTO-DOCUMENTACION.md | §10. Carga de Contexto | Template + instrucciones subagentes |
|
|
| RF-08 | Fases: Análisis→Plan→Validación→Refinamiento→Ejecución→Validación | ✅ SÍ | SIMCO-MANTENIMIENTO-DOCUMENTACION.md | §4. Ciclo de Mantenimiento | 6 pasos alineados con CAPVED |
|
|
|
|
**Resultado:** 8/8 requisitos cubiertos (100%)
|
|
|
|
---
|
|
|
|
### 1.2 Cobertura de Prompts de Referencia
|
|
|
|
#### Prompt 1: Sincronización BD
|
|
|
|
| Elemento del Prompt | Cubierto | Ubicación |
|
|
|---------------------|----------|-----------|
|
|
| Documentar cambios con estándares | ✅ SÍ | SIMCO-MANTENIMIENTO §4.6, CHECKLIST §6 |
|
|
| Actualizar scripts create/recreate | ✅ SÍ | SIMCO-SINCRONIZACION §4.1-4.3 |
|
|
| Ejecutar recreación para validar | ✅ SÍ | SIMCO-SINCRONIZACION §4.4-4.5, CHECKLIST §5 |
|
|
| Analizar objetos modificados | ✅ SÍ | SIMCO-SINCRONIZACION §5 |
|
|
| Validar dependencias (dependientes) | ✅ SÍ | SIMCO-MANTENIMIENTO §5.1-5.2 |
|
|
| Validar dependencias (de los que depende) | ✅ SÍ | SIMCO-MANTENIMIENTO §5.3 |
|
|
| Actualizar BD, backend, frontend | ✅ SÍ | SIMCO-SINCRONIZACION §3, CHECKLIST §2-4 |
|
|
| Fases: análisis→plan→validación→ejecución | ✅ SÍ | SIMCO-MANTENIMIENTO §4 (6 pasos CAPVED+M) |
|
|
|
|
**Resultado:** 8/8 elementos cubiertos (100%)
|
|
|
|
#### Prompt 2: Integración Docs→Desarrollo
|
|
|
|
| Elemento del Prompt | Cubierto | Ubicación |
|
|
|---------------------|----------|-----------|
|
|
| Análisis detallado de cambios en docs | ✅ SÍ | SIMCO-MANTENIMIENTO §4.1 IDENTIFICAR |
|
|
| Validar integración al desarrollo | ✅ SÍ | SIMCO-MANTENIMIENTO §4.2-4.3 |
|
|
| Separar tareas con máximo detalle | ✅ SÍ | CHECKLIST-MANTENIMIENTO (80 items en 7 secciones) |
|
|
| Fases completas de validación | ✅ SÍ | Ciclo de 6 pasos + 2 checklists |
|
|
| Comparación completa y detallada | ✅ SÍ | CHECKLIST §2 Sincronización (15 items) |
|
|
|
|
**Resultado:** 5/5 elementos cubiertos (100%)
|
|
|
|
---
|
|
|
|
## 2. VALIDACIÓN DE INTEGRACIÓN CON DIRECTIVAS EXISTENTES
|
|
|
|
### 2.1 Matriz de Integración
|
|
|
|
| Directiva Existente | Tipo de Integración | Validación |
|
|
|---------------------|---------------------|------------|
|
|
| PRINCIPIO-CAPVED.md | Extensión (Fase M) | ✅ Plan incluye §9 con diagrama CAPVED+M |
|
|
| SIMCO-DOCUMENTAR.md | Complemento | ✅ Referencias cruzadas definidas |
|
|
| SIMCO-ESTRUCTURA-DOCS.md | Extensión (frontmatter) | ✅ Plan incluye campos de mantenimiento |
|
|
| SIMCO-INVENTARIOS.md | Referencia | ✅ Ciclo incluye actualización de inventarios |
|
|
| SIMCO-DELEGACION.md | Nuevo perfil | ✅ PERFIL-DOC-MAINTAINER planificado |
|
|
| SIMCO-PROPAGACION.md | Referencia | ✅ Ciclo incluye propagación si aplica |
|
|
|
|
**Resultado:** 6/6 integraciones válidas
|
|
|
|
### 2.2 Conflictos Potenciales
|
|
|
|
| Posible Conflicto | Análisis | Resolución |
|
|
|-------------------|----------|------------|
|
|
| Duplicación con SIMCO-DOCUMENTAR | @DOCUMENTAR es para fase D, @MANTENIMIENTO_DOCS es post-D | No hay conflicto, son complementarios |
|
|
| Sobrecarga de proceso CAPVED | Fase M es opcional para tareas menores | Triggers claros definen cuándo aplicar |
|
|
| Inconsistencia de frontmatter | Nuevos campos son opcionales | Marcados como "recomendados" |
|
|
|
|
**Resultado:** Sin conflictos bloqueantes
|
|
|
|
---
|
|
|
|
## 3. VALIDACIÓN DE ARTEFACTOS PLANIFICADOS
|
|
|
|
### 3.1 Completitud de Artefactos
|
|
|
|
| Artefacto | Estructura | Contenido | Referencias | Resultado |
|
|
|-----------|------------|-----------|-------------|-----------|
|
|
| SIMCO-MANTENIMIENTO-DOCUMENTACION.md | 14 secciones | Detallado | @SYNC_BD, @CAPVED, etc. | ✅ VÁLIDO |
|
|
| SIMCO-SINCRONIZACION-BD.md | 10 secciones | Detallado | @CHK_SYNC_BD, @INVENTARIOS | ✅ VÁLIDO |
|
|
| CHECKLIST-MANTENIMIENTO-DOCS.md | 7 secciones, ~80 items | Ejecutable | @MANTENIMIENTO_DOCS | ✅ VÁLIDO |
|
|
| CHECKLIST-SINCRONIZACION-BD.md | 6 secciones, ~70 items | Ejecutable | @SYNC_BD | ✅ VÁLIDO |
|
|
| TEMPLATE-DEPRECACION.md | Template + ejemplo | Usable | @MANTENIMIENTO_DOCS | ✅ VÁLIDO |
|
|
| PERFIL-DOCUMENTATION-MAINTAINER.md | 7 secciones | Especializado | Directivas relevantes | ✅ VÁLIDO |
|
|
|
|
**Resultado:** 6/6 artefactos válidos
|
|
|
|
### 3.2 Consistencia de Aliases
|
|
|
|
| Alias | Archivo | Consistente |
|
|
|-------|---------|-------------|
|
|
| @MANTENIMIENTO_DOCS | SIMCO-MANTENIMIENTO-DOCUMENTACION.md | ✅ |
|
|
| @SYNC_BD | SIMCO-SINCRONIZACION-BD.md | ✅ |
|
|
| @CHK_MANTENIMIENTO | CHECKLIST-MANTENIMIENTO-DOCS.md | ✅ |
|
|
| @CHK_SYNC_BD | CHECKLIST-SINCRONIZACION-BD.md | ✅ |
|
|
| @TPL_DEPRECACION | TEMPLATE-DEPRECACION.md | ✅ |
|
|
| @PERFIL_DOC_MAINT | PERFIL-DOCUMENTATION-MAINTAINER.md | ✅ |
|
|
|
|
**Resultado:** 6/6 aliases consistentes
|
|
|
|
---
|
|
|
|
## 4. VALIDACIÓN DE SECUENCIA DE EJECUCIÓN
|
|
|
|
### 4.1 Orden de Dependencias
|
|
|
|
```
|
|
Sprint 1: Directivas Core
|
|
├── 1.1 SIMCO-MANTENIMIENTO-DOCUMENTACION.md (sin dependencias) ✅
|
|
└── 1.2 SIMCO-SINCRONIZACION-BD.md (sin dependencias) ✅
|
|
|
|
Sprint 2: Checklists
|
|
├── 2.1 CHECKLIST-MANTENIMIENTO-DOCS.md (depende de 1.1) ✅
|
|
└── 2.2 CHECKLIST-SINCRONIZACION-BD.md (depende de 1.2) ✅
|
|
|
|
Sprint 3: Templates y Perfiles
|
|
├── 3.1 TEMPLATE-DEPRECACION.md (depende de 1.1) ✅
|
|
└── 3.2 PERFIL-DOCUMENTATION-MAINTAINER.md (depende de 1.1, 1.2) ✅
|
|
|
|
Sprint 4: Integración
|
|
├── 4.1 INDICE-DIRECTIVAS-WORKSPACE.yml (depende de 1.*, 2.*, 3.*) ✅
|
|
├── 4.2 SIMCO-ESTRUCTURA-DOCS.md (depende de 1.1) ✅
|
|
└── 4.3 checklists/_MAP.md (depende de 2.*) ✅
|
|
|
|
Sprint 5: Validación
|
|
└── 5.* (depende de 4.*) ✅
|
|
```
|
|
|
|
**Resultado:** Secuencia de dependencias válida
|
|
|
|
### 4.2 Paralelización Posible
|
|
|
|
| Sprint | Paralelizable | Justificación |
|
|
|--------|---------------|---------------|
|
|
| Sprint 1 | SÍ | 1.1 y 1.2 son independientes |
|
|
| Sprint 2 | SÍ | 2.1 y 2.2 son independientes |
|
|
| Sprint 3 | SÍ | 3.1 y 3.2 son independientes |
|
|
| Sprint 4 | PARCIAL | 4.1 depende de todos, 4.2 y 4.3 paralelos |
|
|
| Sprint 5 | NO | Secuencial por naturaleza |
|
|
|
|
---
|
|
|
|
## 5. VALIDACIÓN DE MÉTRICAS DE ÉXITO
|
|
|
|
| Métrica | Medible | Verificable | Resultado |
|
|
|---------|---------|-------------|-----------|
|
|
| Directivas creadas (2) | ✅ SÍ | `ls` + `wc -l` | Medible |
|
|
| Checklists creados (2) | ✅ SÍ | `ls` + `wc -l` | Medible |
|
|
| Templates creados (1) | ✅ SÍ | `ls` | Medible |
|
|
| Perfiles creados (1) | ✅ SÍ | `ls` | Medible |
|
|
| Índice actualizado | ✅ SÍ | `grep version` | Medible |
|
|
| Referencias cruzadas válidas | ✅ SÍ | `grep` de aliases | Medible |
|
|
| Cobertura RF | ✅ SÍ | Esta tabla | Medible |
|
|
|
|
**Resultado:** 7/7 métricas medibles
|
|
|
|
---
|
|
|
|
## 6. ANÁLISIS DE GAPS
|
|
|
|
### 6.1 Gaps Identificados
|
|
|
|
| # | Gap | Impacto | Acción Recomendada |
|
|
|---|-----|---------|-------------------|
|
|
| G-01 | No hay script automatizado de validación | Bajo | Opcional: Crear script en fase futura |
|
|
| G-02 | No hay integración con CI/CD | Bajo | Opcional: Documentar hooks de CI |
|
|
| G-03 | No hay dashboard de estado de docs | Bajo | Fuera de alcance actual |
|
|
|
|
### 6.2 Gaps Aceptados
|
|
|
|
Todos los gaps identificados son de **impacto bajo** y pueden abordarse en iteraciones futuras. No bloquean la implementación actual.
|
|
|
|
---
|
|
|
|
## 7. RESULTADO DE VALIDACIÓN
|
|
|
|
### 7.1 Resumen
|
|
|
|
| Categoría | Resultado |
|
|
|-----------|-----------|
|
|
| Cobertura de Requisitos RF | 100% (8/8) |
|
|
| Cobertura de Prompt 1 | 100% (8/8) |
|
|
| Cobertura de Prompt 2 | 100% (5/5) |
|
|
| Integración con Existentes | 100% (6/6) |
|
|
| Conflictos Bloqueantes | 0 |
|
|
| Artefactos Válidos | 100% (6/6) |
|
|
| Secuencia de Dependencias | VÁLIDA |
|
|
| Métricas Medibles | 100% (7/7) |
|
|
|
|
### 7.2 Decisión
|
|
|
|
| Criterio | Estado |
|
|
|----------|--------|
|
|
| ¿Plan cumple requisitos? | ✅ SÍ |
|
|
| ¿Plan es viable? | ✅ SÍ |
|
|
| ¿Plan está completo? | ✅ SÍ |
|
|
| ¿Proceder a refinamiento? | ✅ SÍ |
|
|
|
|
---
|
|
|
|
## 8. RECOMENDACIONES PARA REFINAMIENTO
|
|
|
|
### 8.1 Ajustes Menores Sugeridos
|
|
|
|
1. **Agregar sección de FAQ** a SIMCO-MANTENIMIENTO-DOCUMENTACION.md
|
|
2. **Agregar ejemplos concretos** en cada sección de los checklists
|
|
3. **Simplificar triggers** para claridad (tabla de decisión)
|
|
|
|
### 8.2 No Requiere Cambios
|
|
|
|
- Estructura general de artefactos
|
|
- Secuencia de ejecución
|
|
- Integración con directivas existentes
|
|
- Aliases y referencias
|
|
|
|
---
|
|
|
|
**Estado:** FASE 4 COMPLETADA - PLAN VALIDADO
|
|
**Resultado:** APROBADO PARA REFINAMIENTO
|
|
**Siguiente:** Fase 5 - Refinamiento del Plan
|
|
**Fecha:** 2026-01-10
|