balam/bitacora

Bitácora — cómo registrar

Esta carpeta es el registro vivo del proyecto Balam. Cada vez que pase algo relevante —una llamada, un correo, un mensaje de WhatsApp, una decisión— se anota aquí. Así el proyecto siempre tiene una sola fuente de la verdad de "qué se dijo, cuándo y qué quedó pendiente".

Archivos

Archivo	Para qué
REGISTRO.md	Log cronológico de toda comunicación (correos, llamadas, mensajes). Entradas numeradas, más antigua arriba.
PENDIENTES.md	Acciones abiertas (checklist). Lo que hay que hacer y quién.
../planeacion/Seguimiento-horas.md	Reglas, resumen y reconstrucción pendiente de horas efectivamente trabajadas.
../planeacion/Seguimiento-horas.csv	Fuente tabular para conciliación con Jira y facturación.
../fuentes/	Material crudo: transcripciones, archivos .eml, PRD. No se edita; es evidencia.
../README.md	Estado del proyecto (resumen ejecutivo, datos clave, decisiones). Se actualiza cuando algo cambia el rumbo.

Flujo cuando pasa algo

1. Pasa algo (llamada / correo / mensaje / decisión).
2. Guarda la evidencia en ../fuentes/ si existe (transcripción, .eml, captura). Nómbrala con fecha: 2026-06-04 - Transcript - <tema>.txt.
3. Registra la entrada en REGISTRO.md con la plantilla que corresponda (ver abajo). Usa el siguiente número consecutivo.
4. Mueve los pendientes que surjan a PENDIENTES.md.
5. Si cambió el alcance, precio, plazo o una decisión clave, actualiza también ../README.md.
6. Si hubo trabajo facturable, registra el tiempo real el mismo día en ../planeacion/Seguimiento-horas.csv; no infieras horas desde el porcentaje de avance.

Regla de oro: si no está en la bitácora, no pasó. Registrar toma 2 minutos y evita malentendidos caros.

---

Plantillas

Copia el bloque, pégalo en REGISTRO.md y rellena. La fecha en formato AAAA-MM-DD.

📞 Llamada / reunión

## N · AAAA-MM-DD HH:MM · Llamada · <tema>

> Participan: <nombres>. Canal: Teams / tel / presencial. Evidencia: `../fuentes/<archivo>` (si hay).

**Resumen:** <2-4 líneas de qué se trató.>

**Acuerdos / decisiones:**
- <decisión 1>
- <decisión 2>

**Pendientes que surgieron:**
- [ ] <responsable> — <acción> — <fecha objetivo>

**Citas relevantes:** *"<frase textual importante>"*

✉️ Correo

## N · AAAA-MM-DD HH:MM · Correo · <De> → <Para> · <asunto>

> Dirección: enviado / recibido. Evidencia: `../fuentes/<archivo>.eml` (si se guardó).

**Resumen:** <qué dice.>
**Acción derivada:** <qué hay que hacer, si aplica.>
**Adjuntos:** <nombre del adjunto, si hay.>

💬 Mensaje (WhatsApp / Teams chat)

## N · AAAA-MM-DD · Mensaje (WhatsApp) · <De> → <Para>

**Resumen:** <qué se dijo.>
**Acción:** <si aplica.>

⚖️ Decisión

## N · AAAA-MM-DD · Decisión · <título>

**Contexto:** <por qué se decide.>
**Decisión:** <qué se decidió.>
**Aprobada por:** <quién.>
**Impacto:** alcance / precio / tiempo — <detalle.>

---

Convenciones

• Una entrada por evento, numeradas y en orden cronológico (más reciente al final, igual que el hilo actual).
• Evidencia cruda en ../fuentes/, nunca editada; el resumen interpretado va en REGISTRO.md.
• Pendientes siempre con responsable y fecha; al cerrarse se marcan [x] en PENDIENTES.md (no se borran, dejan rastro).
• Fechas absolutas (2026-06-04), nunca "ayer" o "la próxima semana".
• Citas textuales entre comillas y en cursiva para distinguir lo dicho de la interpretación.