- directivas/simco/_INDEX.md: Agregar 9 directivas nuevas (v3.7 + v3.8) - templates/_MAP.md: Agregar 4 templates nuevos, total 28 templates - Actualizar aliases y changelog Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
265 lines
13 KiB
Markdown
265 lines
13 KiB
Markdown
# Mapa de Templates - Sistema NEXUS
|
|
|
|
**Version:** 3.8.0
|
|
**Fecha:** 2026-01-10
|
|
**Total Templates:** 28
|
|
|
|
---
|
|
|
|
## Estructura de Archivos
|
|
|
|
```
|
|
templates/
|
|
|
|
|
+-- _MAP.md <- ESTAS AQUI
|
|
|
|
|
+-- # TEMPLATES CAPVED (Ciclo de Vida)
|
|
+-- TEMPLATE-TAREA-CAPVED.md # Tracking completo de HU con ciclo CAPVED
|
|
+-- TEMPLATE-ANALISIS.md # Fase A - Analisis pre-ejecucion
|
|
+-- TEMPLATE-PLAN.md # Fase P - Plan de ejecucion
|
|
+-- TEMPLATE-VALIDACION.md # Fase V - Validacion post-ejecucion
|
|
|
|
|
+-- # TEMPLATES DE PLANIFICACION
|
|
+-- TEMPLATE-HISTORIA-USUARIO.md # Definicion de User Stories
|
|
+-- TEMPLATE-EPICA.md # Definicion de Epicas
|
|
+-- TEMPLATE-TAREA-TECNICA.md # Tareas atomicas por capa
|
|
|
|
|
+-- # TEMPLATES DE CONTEXTO POR NIVEL
|
|
+-- CONTEXTO-NIVEL-STANDALONE.md # Proyectos independientes (Nivel 2A)
|
|
+-- CONTEXTO-NIVEL-SUITE.md # Suites multi-vertical (Nivel 2B)
|
|
+-- CONTEXTO-NIVEL-SUITE-CORE.md # Core de suite (Nivel 2B.1)
|
|
+-- CONTEXTO-NIVEL-VERTICAL.md # Verticales (Nivel 2B.2)
|
|
|
|
|
+-- # TEMPLATES DE DELEGACION
|
|
+-- TEMPLATE-DELEGACION-SUBAGENTE.md # Delegar tareas a subagentes
|
|
+-- TEMPLATE-CONTEXTO-SUBAGENTE.md # Contexto minimo para subagentes
|
|
+-- TEMPLATE-CONTEXTO-PROYECTO.md # Contexto de proyecto
|
|
+-- TEMPLATES-SUBAGENTES.md # Catalogo de prompts subagentes
|
|
|
|
|
+-- # TEMPLATES DE HERENCIA
|
|
+-- HERENCIA-SIMCO.md # Configurar herencia de directivas
|
|
+-- HERENCIA-ERP-CORE-TEMPLATE.md # Herencia para verticales ERP
|
|
+-- CONTEXTO-VERTICAL-TEMPLATE.md # Contexto especifico vertical ERP
|
|
|
|
|
+-- # TEMPLATES NUEVOS (EPIC-003)
|
|
+-- TEMPLATE-MODULO-COMPARTIDO.md # [NUEVO] Documentar modulos shared/modules/
|
|
+-- TEMPLATE-ESTRUCTURA-VERTICAL.md # [NUEVO] Crear nuevos verticales
|
|
|
|
|
+-- # TEMPLATES DE DOCUMENTACION (v3.7/v3.8)
|
|
+-- TEMPLATE-INVENTARIO-PROYECTO.md # [NUEVO] Crear inventarios YAML
|
|
+-- TEMPLATE-INTEGRACION-EXTERNA.md # [NUEVO] Documentar integraciones externas
|
|
+-- TEMPLATE-MODULO-ESTANDAR.md # [NUEVO] Documentar modulos estandar
|
|
+-- TEMPLATE-DEPRECACION.md # [NUEVO] Marcar documentos como deprecados
|
|
|
|
|
+-- # OTROS TEMPLATES
|
|
+-- TEMPLATE-ANALISIS-IMPACTO.md # Analisis de impacto cross-capa
|
|
+-- TEMPLATE-HU-DERIVADA.md # HUs detectadas durante ejecucion
|
|
+-- TEMPLATE-REPORTE-SPRINT.md # Reporte de cierre de sprint
|
|
+-- CHECKLIST-ESTRUCTURA-PROYECTO.md # Validar estructura minima
|
|
+-- SERVICE-DESCRIPTOR-TEMPLATE.yml # Descriptor de servicios
|
|
```
|
|
|
|
---
|
|
|
|
## Guia de Seleccion Rapida
|
|
|
|
### Por Tipo de Trabajo
|
|
|
|
| Situacion | Template | Alias |
|
|
|-----------|----------|-------|
|
|
| Iniciar tracking de HU completa | TEMPLATE-TAREA-CAPVED.md | @TPL_CAPVED |
|
|
| Analizar impacto antes de planificar | TEMPLATE-ANALISIS.md | @TPL_ANALISIS |
|
|
| Crear plan de ejecucion | TEMPLATE-PLAN.md | @TPL_PLAN |
|
|
| Validar trabajo ejecutado | TEMPLATE-VALIDACION.md | @TPL_VALIDACION |
|
|
| Definir nueva user story | TEMPLATE-HISTORIA-USUARIO.md | @TPL_HU |
|
|
| Definir nueva epica | TEMPLATE-EPICA.md | @TPL_EPICA |
|
|
| Desglosar HU en tareas tecnicas | TEMPLATE-TAREA-TECNICA.md | @TPL_TECNICA |
|
|
|
|
### Por Nivel de Proyecto
|
|
|
|
| Nivel | Template | Alias |
|
|
|-------|----------|-------|
|
|
| Proyecto standalone | CONTEXTO-NIVEL-STANDALONE.md | @TPL_STANDALONE |
|
|
| Suite multi-vertical | CONTEXTO-NIVEL-SUITE.md | @TPL_SUITE |
|
|
| Core de suite | CONTEXTO-NIVEL-SUITE-CORE.md | @TPL_SUITE_CORE |
|
|
| Vertical de suite | CONTEXTO-NIVEL-VERTICAL.md | @TPL_VERTICAL |
|
|
|
|
### Para Delegacion
|
|
|
|
| Situacion | Template | Alias |
|
|
|-----------|----------|-------|
|
|
| Delegar trabajo a subagente | TEMPLATE-DELEGACION-SUBAGENTE.md | @TPL_DELEGACION |
|
|
| Definir contexto minimo subagente | TEMPLATE-CONTEXTO-SUBAGENTE.md | @TPL_SUBAGENTE |
|
|
| Crear CONTEXTO-PROYECTO.md | TEMPLATE-CONTEXTO-PROYECTO.md | @TPL_CONTEXTO |
|
|
|
|
### Para Modulos y Estructura (NUEVOS)
|
|
|
|
| Situacion | Template | Alias |
|
|
|-----------|----------|-------|
|
|
| Documentar modulo en shared/modules/ | TEMPLATE-MODULO-COMPARTIDO.md | @TPL_MODULO |
|
|
| Crear nuevo vertical | TEMPLATE-ESTRUCTURA-VERTICAL.md | @TPL_ESTRUCTURA_VERTICAL |
|
|
|
|
### Para Documentacion y Mantenimiento (v3.7/v3.8)
|
|
|
|
| Situacion | Template | Alias |
|
|
|-----------|----------|-------|
|
|
| Crear inventarios YAML | TEMPLATE-INVENTARIO-PROYECTO.md | @TPL_INVENTARIO |
|
|
| Documentar integracion externa | TEMPLATE-INTEGRACION-EXTERNA.md | @TPL_INTEGRACION |
|
|
| Documentar modulo estandar | TEMPLATE-MODULO-ESTANDAR.md | @TPL_MODULO_ESTANDAR |
|
|
| Marcar documento como deprecado | TEMPLATE-DEPRECACION.md | @TPL_DEPRECACION |
|
|
|
|
### Para Herencia
|
|
|
|
| Situacion | Template | Alias |
|
|
|-----------|----------|-------|
|
|
| Configurar herencia SIMCO | HERENCIA-SIMCO.md | - |
|
|
| Proyecto que extiende ERP-Core | HERENCIA-ERP-CORE-TEMPLATE.md | - |
|
|
| Contexto de vertical ERP | CONTEXTO-VERTICAL-TEMPLATE.md | - |
|
|
|
|
---
|
|
|
|
## Integracion con Catalogo
|
|
|
|
### Templates con Verificacion de Catalogo
|
|
|
|
Los siguientes templates incluyen seccion de verificacion de @CATALOG_INDEX:
|
|
|
|
- TEMPLATE-TAREA-CAPVED.md (Fase C)
|
|
- TEMPLATE-PLAN.md (Verificacion obligatoria)
|
|
- TEMPLATE-HISTORIA-USUARIO.md (Antes de crear)
|
|
- TEMPLATE-EPICA.md (Verificar funcionalidades)
|
|
- TEMPLATE-TAREA-TECNICA.md (Antes de crear)
|
|
- TEMPLATE-DELEGACION-SUBAGENTE.md (Bloque 3)
|
|
|
|
### Como Usar con Catalogo
|
|
|
|
1. Antes de implementar, verificar catalogo:
|
|
```bash
|
|
grep -i "{funcionalidad}" shared/catalog/CATALOG-INDEX.yml
|
|
```
|
|
|
|
2. Si existe en catalogo:
|
|
- Seguir SIMCO-REUTILIZAR.md
|
|
- Copiar de shared/catalog/{funcionalidad}/_reference/
|
|
|
|
3. Si NO existe:
|
|
- Proceder con implementacion nueva
|
|
- Considerar contribuir despues (SIMCO-CONTRIBUIR-CATALOGO.md)
|
|
|
|
---
|
|
|
|
## Templates por Fase CAPVED
|
|
|
|
```
|
|
╔══════════════════════════════════════════════════════════════════════╗
|
|
║ FASE C - CONTEXTO ║
|
|
╠══════════════════════════════════════════════════════════════════════╣
|
|
║ TEMPLATE-TAREA-CAPVED.md (seccion Contexto) ║
|
|
║ CONTEXTO-NIVEL-*.md (por tipo de proyecto) ║
|
|
║ TEMPLATE-CONTEXTO-PROYECTO.md ║
|
|
╚══════════════════════════════════════════════════════════════════════╝
|
|
|
|
╔══════════════════════════════════════════════════════════════════════╗
|
|
║ FASE A - ANALISIS ║
|
|
╠══════════════════════════════════════════════════════════════════════╣
|
|
║ TEMPLATE-ANALISIS.md ║
|
|
║ TEMPLATE-ANALISIS-IMPACTO.md ║
|
|
╚══════════════════════════════════════════════════════════════════════╝
|
|
|
|
╔══════════════════════════════════════════════════════════════════════╗
|
|
║ FASE P - PLANEACION ║
|
|
╠══════════════════════════════════════════════════════════════════════╣
|
|
║ TEMPLATE-PLAN.md ║
|
|
║ TEMPLATE-HISTORIA-USUARIO.md ║
|
|
║ TEMPLATE-EPICA.md ║
|
|
║ TEMPLATE-TAREA-TECNICA.md ║
|
|
╚══════════════════════════════════════════════════════════════════════╝
|
|
|
|
╔══════════════════════════════════════════════════════════════════════╗
|
|
║ FASE V - VALIDACION ║
|
|
╠══════════════════════════════════════════════════════════════════════╣
|
|
║ TEMPLATE-VALIDACION.md ║
|
|
║ CHECKLIST-ESTRUCTURA-PROYECTO.md ║
|
|
╚══════════════════════════════════════════════════════════════════════╝
|
|
|
|
╔══════════════════════════════════════════════════════════════════════╗
|
|
║ FASE E - EJECUCION ║
|
|
╠══════════════════════════════════════════════════════════════════════╣
|
|
║ TEMPLATE-DELEGACION-SUBAGENTE.md ║
|
|
║ TEMPLATE-CONTEXTO-SUBAGENTE.md ║
|
|
║ TEMPLATES-SUBAGENTES.md ║
|
|
╚══════════════════════════════════════════════════════════════════════╝
|
|
|
|
╔══════════════════════════════════════════════════════════════════════╗
|
|
║ FASE D - DOCUMENTACION ║
|
|
╠══════════════════════════════════════════════════════════════════════╣
|
|
║ TEMPLATE-HU-DERIVADA.md ║
|
|
║ TEMPLATE-REPORTE-SPRINT.md ║
|
|
║ TEMPLATE-MODULO-COMPARTIDO.md [NUEVO] ║
|
|
╚══════════════════════════════════════════════════════════════════════╝
|
|
```
|
|
|
|
---
|
|
|
|
## Campos Comunes
|
|
|
|
### Identificacion (todos los templates)
|
|
|
|
| Campo | Descripcion |
|
|
|-------|-------------|
|
|
| ID | Identificador unico (HU-XXX, DB-XXX, etc.) |
|
|
| Proyecto/Modulo | Contexto del proyecto |
|
|
| Prioridad | P0/P1/P2/P3 |
|
|
| Estado | Pendiente/En_progreso/Completado |
|
|
| Fecha | Fecha de creacion/modificacion |
|
|
|
|
### Verificacion de Catalogo
|
|
|
|
| Campo | Descripcion |
|
|
|-------|-------------|
|
|
| Verificacion @CATALOG | Obligatorio antes de implementar |
|
|
| Funcionalidades a verificar | auth, session, rate-limit, etc. |
|
|
|
|
### Criterios y Validaciones
|
|
|
|
| Campo | Descripcion |
|
|
|-------|-------------|
|
|
| Criterios de Aceptacion | Funcionales y tecnicos |
|
|
| Definition of Done | Checklist de completitud |
|
|
| Validaciones obligatorias | build, lint, tests |
|
|
|
|
---
|
|
|
|
## Novedades v3.8.0
|
|
|
|
### Templates Nuevos (v3.7/v3.8)
|
|
|
|
1. **TEMPLATE-INVENTARIO-PROYECTO.md** - Para crear inventarios YAML estandarizados
|
|
2. **TEMPLATE-INTEGRACION-EXTERNA.md** - Para documentar integraciones con servicios externos
|
|
3. **TEMPLATE-MODULO-ESTANDAR.md** - Para documentar modulos con formato estandar
|
|
4. **TEMPLATE-DEPRECACION.md** - Para marcar documentos como deprecados
|
|
|
|
### Aliases Nuevos
|
|
|
|
- `@TPL_INVENTARIO` - TEMPLATE-INVENTARIO-PROYECTO.md
|
|
- `@TPL_INTEGRACION` - TEMPLATE-INTEGRACION-EXTERNA.md
|
|
- `@TPL_MODULO_ESTANDAR` - TEMPLATE-MODULO-ESTANDAR.md
|
|
- `@TPL_DEPRECACION` - TEMPLATE-DEPRECACION.md
|
|
|
|
### Novedades Anteriores (v2.1.0)
|
|
|
|
- **TEMPLATE-MODULO-COMPARTIDO.md** - Para documentar modulos en shared/modules/
|
|
- **TEMPLATE-ESTRUCTURA-VERTICAL.md** - Para crear nuevos verticales en suites
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
- **Directivas SIMCO:** `directivas/simco/_INDEX.md`
|
|
- **Aliases:** `referencias/ALIASES.yml`
|
|
- **Catalogo:** `shared/catalog/CATALOG-INDEX.yml`
|
|
|
|
---
|
|
|
|
**Mapa Version:** 3.8.0 | **Sistema:** SIMCO | **Total Templates:** 28
|