Files
dtic-DIIAA/docs/ambito/dtic-ADN/A01.P007_Plantillas-Escritura-Eventos.md
T
Ricardo MonlaandClaude Opus 4.6 018e45e046 feat(ambito): Migración de dtic-ADN a estándar de ámbito A01
- Creado manifiesto A01_dtic-ADN.md siguiendo estándar A03/A04
- Renombrados planes P2604.* → A01.P00X (8 planes migrados)
- Archivado manifiesto legacy P2604_Mejoras-ADN.md en _hist/
- Actualizada ontología y contexto IA con referencias a A01

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-07 09:59:52 -03:00

4.0 KiB

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

  • Inventariar plantillas existentes en adn/tools/proy/plantillas.rb
  • Identificar tipos de eventos recurrentes en bitácoras
  • Documentar formato actual de descripciones de eventos
  • Analizar herramientas ADN a utilizar

Fase 2: Diseño de Plantillas

  • 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
  • Diseñar formato de detalle enriquecido (contexto, acción, resultado)
  • Definir convenciones de formato (emojis, Prefijos, etc.)

Fase 3: Implementación

  • Crear módulo adn/tools/templates/plantillas_eventos.rb
  • Integrar con ./adn/tools/run generar evento <tipo>
  • Documentar uso en 02_bitacora.md
  • Integrar con db evento:crear (opcional --plantilla)
  • Agregar a 05_ia.md como buena práctica

Fase 4: Adopción

  • Probar con eventos reales (usado en este mismo evento)
  • Medir mejora en consistencia
  • Recopilar feedback

Progreso

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)

  • Bugfix: Formato de hora en db evento:listar ahora muestra HH:MM:SS
  • Entrada acepta --inicio HH:MM[:SS] y --fin HH:MM[:SS]
  • Archivo: adn/tools/cli/db/evento.rb
  • --inicio usa hora actual por defecto si no se especifica
  • 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)

  • TODOS LOS 34 EVENTOS de hoy (1186-1239) mejorados con formato enriquecido
  • Tipos usados: planificación, implementación, debug, test, documentación, resolución, investigación
  • Documentado formato estándar para nuevos eventos
  • IDs mejorados: 1186-1239