workspace-v1/orchestration/templates/_MAP.md
rckrdmrd 544ab2fc3a [SIMCO-V38] docs: Actualizar indices _INDEX.md y _MAP.md a v3.8.0
- 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>
2026-01-10 08:59:23 -06:00

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