diff --git a/orchestration/00-guidelines/HERENCIA-SIMCO.md b/orchestration/00-guidelines/HERENCIA-SIMCO.md new file mode 100644 index 0000000..1e6defb --- /dev/null +++ b/orchestration/00-guidelines/HERENCIA-SIMCO.md @@ -0,0 +1,191 @@ +# Herencia SIMCO - clinica-dental + +**Sistema:** SIMCO v4.0.0 + CAPVED + SCRUM +**Fecha:** 2026-01-10 + +--- + +## Configuración del Proyecto + +| Propiedad | Valor | +|-----------|-------| +| **Proyecto** | Clinica Dental - Sistema para Clinicas Dentales | +| **Código v2** | CDN | +| **SIMCO Version** | 4.0.0 | +| **CAPVED** | Habilitado | +| **SCRUM** | Habilitado | + +--- + +## Metodología CAPVED+SCRUM + +Este proyecto utiliza la metodología integrada CAPVED+SCRUM definida en SIMCO v4.0.0. + +### Ciclo CAPVED dentro de Sprint + +``` +Sprint Start + │ + ├── Sprint Planning (usar @TPL_SPRINT_PLANNING) + │ + └── Por cada HU: + ├── [C] Contexto → Cargar directivas, verificar DoR + ├── [A] Análisis → Analizar requerimientos + ├── [P] Plan → Planificar implementación + ├── [V] Validación → Validar plan técnico + ├── [E] Ejecución → Implementar código + └── [D] Documentar → Actualizar docs, verificar DoD + │ + ├── Sprint Review + └── Sprint Retrospective (usar @TPL_RETROSPECTIVA) +``` + +--- + +## Directivas SCRUM (SIMCO v4.0.0) + +### Ejecución de Sprint + +| Alias | Directiva | Propósito | +|-------|-----------|-----------| +| `@SPRINT_EXECUTION` | `SIMCO-SPRINT-EXECUTION.md` | Ciclo completo de Sprint | +| `@AGILE_METRICS` | `SIMCO-AGILE-METRICS.md` | Métricas Velocity, Burndown | +| `@SCRUM_INTEGRATION` | `SIMCO-SCRUM-INTEGRATION.md` | Integración CAPVED+SCRUM | + +### Definition of Ready (DoR) + +| Criterio | Descripción | +|----------|-------------| +| ID asignado | `CDN-US-NNN` | +| Historia completa | Como/Quiero/Para | +| Criterios de aceptación | 3-8 criterios | +| Story Points | Fibonacci (1,2,3,5,8,13) | +| Dependencias identificadas | Sin bloqueos | +| PO aprobado | ✓ | + +### Definition of Done (DoD) + +| Criterio | Descripción | +|----------|-------------| +| Código implementado | Según especificación | +| Build pasa | Sin errores | +| Tests pasando | Unitarios + integración | +| Code review | Completado | +| Documentación | Actualizada | +| TRACEABILITY.yml | Actualizado | + +### Templates SCRUM + +| Alias | Template | Uso | +|-------|----------|-----| +| `@TPL_DEFINICION_READY` | `TEMPLATE-DEFINICION-READY.md` | Validar DoR de HU | +| `@TPL_SPRINT_BACKLOG` | `TEMPLATE-SPRINT-BACKLOG.yml` | Tracking de Sprint | +| `@TPL_RETROSPECTIVA` | `TEMPLATE-RETROSPECTIVA.yml` | Retro Start-Stop-Continue | +| `@TPL_SPRINT_PLANNING` | `TEMPLATE-ACTA-SPRINT-PLANNING.md` | Acta de Planning | + +### Checklist DoD/DoR + +| Alias | Checklist | Items | +|-------|-----------|-------| +| `@CHK_DOD_DOR` | `CHECKLIST-DOD-DOR.md` | 32 items | + +--- + +## Directivas CAPVED (Heredadas) + +### Ciclo de Vida + +| Alias | Archivo | Propósito | +|-------|---------|-----------| +| `@TAREA` | `SIMCO-TAREA.md` | Punto de entrada | +| `@CAPVED` | `PRINCIPIO-CAPVED.md` | Ciclo de 6 fases | +| `@INICIALIZACION` | `SIMCO-INICIALIZACION.md` | Bootstrap de agentes | + +### Operaciones + +| Alias | Archivo | Propósito | +|-------|---------|-----------| +| `@CREAR` | `SIMCO-CREAR.md` | Crear archivos | +| `@MODIFICAR` | `SIMCO-MODIFICAR.md` | Modificar archivos | +| `@VALIDAR` | `SIMCO-VALIDAR.md` | Validar código | +| `@DOCUMENTAR` | `SIMCO-DOCUMENTAR.md` | Documentar trabajo | +| `@BUSCAR` | `SIMCO-BUSCAR.md` | Buscar información | + +--- + +## Directivas de Documentación + +| Alias | Directiva | Propósito | +|-------|-----------|-----------| +| `@DOC_PROYECTO` | `SIMCO-DOCUMENTACION-PROYECTO.md` | Estructura docs/ | +| `@NOMENCLATURA` | `SIMCO-NOMENCLATURA.md` | Convenciones de IDs | +| `@ESTRUCTURA_DOCS` | `SIMCO-ESTRUCTURA-DOCS.md` | Estructura interna | +| `@INVENTARIOS` | `SIMCO-INVENTARIOS.md` | Inventarios YAML | +| `@MANTENIMIENTO_DOCS` | `SIMCO-MANTENIMIENTO-DOCUMENTACION.md` | Ciclo mantenimiento | +| `@SYNC_BD` | `SIMCO-SINCRONIZACION-BD.md` | Sincronización BD↔Docs | + +--- + +## Trazabilidad v2 + +### TRACEABILITY-MASTER.yml + +Ubicación: `docs/04-modelado/trazabilidad/TRACEABILITY-MASTER.yml` + +Este archivo consolida: +- Mapeo de nomenclatura v1 → v2 +- Lista de épicas con estados +- Grafo de dependencias +- Health score del proyecto + +### Nomenclatura v2 + +| Tipo | Formato | Ejemplo | +|------|---------|---------| +| Épica | `CDN-EP-NNN` | CDN-EP-001 | +| Requerimiento | `CDN-RF-NNN` | CDN-RF-001 | +| User Story | `CDN-US-NNN` | CDN-US-001 | +| Tarea | `CDN-TT-NNN` | CDN-TT-001 | +| Bug | `CDN-BG-NNN` | CDN-BG-001 | + +--- + +## Flujo de Trabajo Sprint + +```yaml +# Sprint Planning +1. Cargar: @SPRINT_EXECUTION +2. Seleccionar HUs del backlog +3. Validar DoR con @CHK_DOD_DOR +4. Estimar con Planning Poker +5. Crear Sprint Backlog con @TPL_SPRINT_BACKLOG + +# Durante Sprint (por HU) +1. Cargar: @TAREA + @CAPVED +2. Ejecutar ciclo CAPVED +3. Validar DoD con @CHK_DOD_DOR +4. Actualizar TRACEABILITY.yml + +# Sprint Review +1. Demo de funcionalidades +2. Actualizar @AGILE_METRICS + +# Sprint Retrospective +1. Usar @TPL_RETROSPECTIVA +2. Registrar Start-Stop-Continue +3. Crear action items +``` + +--- + +## Referencias + +- Directivas SIMCO: `workspace-v2/orchestration/directivas/simco/` +- Templates SCRUM: `workspace-v2/orchestration/templates/scrum/` +- Checklists: `workspace-v2/orchestration/checklists/` +- TRACEABILITY-MASTER: `docs/04-modelado/trazabilidad/TRACEABILITY-MASTER.yml` + +--- + +**Sistema:** SIMCO v4.0.0 + CAPVED + SCRUM +**Última actualización:** 2026-01-10