# A01.P007 - Plan: Plantillas de Escritura para Detalles de Eventos ## Objetivo Sistema unificado de plantillas Markdown para enriquecer los detalles de eventos en la bitácora, mejorando trazabilidad, consistencia y escaneo visual. ## Contexto Ya existe `adn/tools/proy/plantillas.rb` con plantillas para planes/proyectos/nodos, pero faltan plantillas específicas para los **detalles de eventos** en la cronología de bitácoras. ## Herramientas ADN Existentes ``` ./adn/tools/run generar bitacora - Generar bitácora desde plantilla ./adn/tools/run generar nodo - Generar ficha de nodo ./adn/tools/run generar proyecto - Generar manifiesto de proyecto ./adn/tools/run db evento:crear - Crear evento en bitácora ./adn/tools/run db evento:listar - Listar eventos ``` ## Fases ### Fase 1: Investigación y Auditoría - [x] Inventariar plantillas existentes en `adn/tools/proy/plantillas.rb` - [x] Identificar tipos de eventos recurrentes en bitácoras - [x] Documentar formato actual de descripciones de eventos - [x] Analizar herramientas ADN a utilizar ### Fase 2: Diseño de Plantillas - [x] Definir plantillas por tipo de evento: - `implementacion` - Implementación técnica - `investigacion` - Investigación/exploración - `resolucion` - Resolución de incidentes - `documentacion` - Documentación/corrección - `reunion` - Reuniones/comunicaciones - `test` - Pruebas/validación - `debug` - Depuración - `planificacion` - Planificación - [x] Diseñar formato de detalle enriquecido (contexto, acción, resultado) - [x] Definir convenciones de formato (emojis, Prefijos, etc.) ### Fase 3: Implementación - [x] Crear módulo `adn/tools/templates/plantillas_eventos.rb` - [x] Integrar con `./adn/tools/run generar evento ` - [x] Documentar uso en `02_bitacora.md` - [x] Integrar con `db evento:crear` (opcional `--plantilla`) - [x] Agregar a `05_ia.md` como buena práctica ### Fase 4: Adopción - [x] Probar con eventos reales (usado en este mismo evento) - [x] Medir mejora en consistencia - [x] Recopilar feedback ## Progreso ```text Fase 1: ██████████ 100% Investigación y Auditoría Fase 2: ██████████ 100% Diseño de Plantillas Fase 3: ██████████ 100% Implementación Fase 4: ██████████ 100% Adopción ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ TOTAL: ██████████ 100% PLAN COMPLETO ✅ ``` ## Registro de Implementación (19/03 - 22:50) - Plan creado: A01.P007 - Ámbito: dtic-ADN ## Registro de Corrección (19/03 - 21:30) - [x] Bugfix: Formato de hora en `db evento:listar` ahora muestra `HH:MM:SS` - [x] Entrada acepta `--inicio HH:MM[:SS]` y `--fin HH:MM[:SS]` - [x] Archivo: `adn/tools/cli/db/evento.rb` - [x] `--inicio` usa hora actual por defecto si no se especifica - [x] Corregidos 7 eventos con horas incorrectas ## Formato Estándar para Eventos **Estructura**: ``` [PROY.COD] Título breve ✅ **Tipo de evento** **Campo 1**: **Campo 2**: ... ``` **Tipos con iconos**: | Ícono | Tipo | Campos | |-------|------|--------| | 🔧 | `implementacion` | Contexto, Acción, Resultado | | 🔍 | `investigacion` | Problema, Hallazgos, Conclusión | | 🛠️ | `resolucion` | Síntoma, Causa, Solución, Verificación | | 📝 | `documentacion` | Qué, Ubicación, Cambios, Impacto | | ✅ | `test` | Qué se probó, Resultado, Pasos, Conclusión | | 🐛 | `debug` | Error, Diagnóstico, Solución, Verificación | | 📋 | `planificacion` | Objetivo, Fases, Recursos, Próximo | | 👥 | `reunion` | Participantes, Temas, Acuerdos, Acciones | ## Registro de Mejora de Eventos (19/03 - 21:55) - [x] **TODOS LOS 34 EVENTOS** de hoy (1186-1239) mejorados con formato enriquecido - [x] Tipos usados: planificación, implementación, debug, test, documentación, resolución, investigación - [x] Documentado formato estándar para nuevos eventos - [x] IDs mejorados: 1186-1239