4.7 KiB
02 - Hebra: Formato de Bitácora
Referencia canónica:
adn/00_indice.md
Esta hebra define el formato, estructura y reglas de sincronización de las bitácoras diarias del proyecto.
1. Principios Generales
- Orden Inverso Cronológico: Lo más nuevo SIEMPRE ARRIBA.
- Archivo Diario:
bitacoras/YYYY-MM-DD.md.
2. Control de Gestión
- Pendientes: Tabla de tareas por hacer (ID [Icono] - [Hora Ini] - [Nombre Tarea] | NODO | DETALLE).
- En Proceso: Tabla de tareas activas (ID [Icono] - [Hora Ini] - [Nombre Tarea] | NODO | DETALLE).
- Resumen de Actividades:
- Formato: Tabla (NODO | RESUMEN INTEGRAL).
- Estilo: Narrativa Sintética e Integral. SIN TÍTULOS NI ESTADOS en el texto. Solo la historia consolidada del día para ese nodo.
- Regla: Una sola fila por Nodo.
3. Actividades Detalladas
- Subdivisión: Encabezados por Nodo (
### srv-ns8). - Formato Jerárquico:
- Título H4 del Tema:
#### [Estado] - [ID] - [Nombre Tarea](ej.#### ✅ - A09 - dtic-BKPs C4). - Párrafo Narrativo: Descripción rica que incluye referencias de migración (ej.
➡️ **[Viene del 23/02]...**) y que explica el "qué" y el "por qué" de la tarea. - Tabla Cronológica: Tabla
| Tiempo | Descripción |.
- Título H4 del Tema:
- Formato de Tiempo y Modo: Las tablas cronológicas deben usar el formato
| I | F | Descripción | E |. - Columnas:
- I (Inicio): Hora de comienzo
HH:MM. - F (Fin): Hora de finalización
HH:MM(usar-si está en curso). - Descripción: Detalle de la actividad.
- E (Estado [Modo]): Combinación de Modo (
[P]Presencial /[R]Remoto) y Estado Semántico (✅,⏳,👁️,⚠️). Ejemplo:[P] ✅.
- I (Inicio): Hora de comienzo
- Estados (Tema): Estrictamente delimitados para trazabilidad (✅ Cerrado, ⏳ En Proceso, ⚠️ Fallo).
- Semántica (General): Uso de una taxonomía visual rica para escaneo visual ultrarrápido (ver hebra 04_iconografia.md).
- Auto-Registro (IA): Cualquier acción técnica autónoma de la IA DEBE registrarse explícitamente en las tablas cronológicas indicando "(IA)" y el respectivo emoji semántico.
3.1 Ejemplo Estructural
### sql-dasuten
#### ✅ - DB01.3 - Finalización de Resguardo Integral (Manual)
🛡️ Confirmación de cierre del backup de la VM 101.
➡️ **[Viene del 26/02](2026-02-26.md)**
| I | F | Descripción | E |
| :--- | :--- | :--- | :--- |
| 16:02 | 16:15 | Finalización exitosa del resguardo integral. | [R] ✅ |
3.2 Trazabilidad Transdiaria (Rollover)
Cuando una tarea migra entre bitácoras, se deben inyectar hipervinculos bidireccionales:
- Origen (día anterior):
➡️ **[Continúa el DD/MM](YYYY-MM-DD.md)** - Destino (día siguiente):
➡️ **[Viene del DD/MM](YYYY-MM-DD.md)**
Estos enlaces garantizan que cualquier lector pueda navegar la línea de tiempo completa de una tarea sin importar cuántos días abarque.
4. Métricas Híbridas (Telemetría)
OBLIGATORIO. Cada hito o bloque de sincronización (SINC) debe registrar el esfuerzo:
- En proceso: Usar formato
[Físico/Remoto: Iniciado HH:MM]. - Finalizado: Usar formato de duración
[Físico/Remoto: H:MM hs].
La IA escaneará sintácticamente estas métricas para graficarlas en la aplicación web del dashboard. El campo F - I determina la duración automática.
5. Reglas de Sincronización en Cascada (Triggers)
El mantenimiento de la bitácora es dinámico y reactivo. La actualización de una sección debe disparar (trigger) la actualización de sus dependencias:
- Trigger 1 (Detalle → En Proceso): Al insertar una nueva viñeta en la cronología de una tarea activa (
⏳), se DEBE actualizar la columnaDETALLEde esa misma tarea en la tablaEn Proceso. - Trigger 2 (Cierre → Resumen Integral): Al cambiar el estado de la última tarea activa de un Nodo de
⏳a✅(o⚠️), se DEBE desencadenar la redacción o actualización de suRESUMEN INTEGRAL. - Trigger 3 (Cambio de Día → Rollover): Al crear un nuevo archivo de bitácora:
- Migrar las actividades
PendientesyEn Procesohacia las tablas del nuevo día. - En la bitácora del día fenecido, cambiar el Estado Tema de las tareas migradas a
➡️(Migrado). - Inyectar hipervínculos bidireccionales de trazabilidad transdiaria.
- Migrar las actividades
6. Footer de Referencia (IA)
Al final de cada bitácora, incluir una referencia mínima a la fuente de verdad de las Directivas IA:
<!-- 🤖 PREMISAS DE TRABAJO (IA): Fuente de Verdad → adn/05_ia.md -->
Evolución: Las premisas de trabajo evolucionan exclusivamente en la hebra
05_ia.md. Las bitácoras nunca duplican las reglas.