Files
balam/bitacora
Johann bee2d02f50 Documenta semana 24-27 jul: validación de prototipo (aprobada), API de Jira y avance de Etapa 1
- REGISTRO #55: validación del prototipo Etapa 0 (24-jul) APROBADA; único bloqueo = definir el flujo de facturación en Jira (sesión propuesta por Araceli para el martes 28)
- REGISTRO #56: sesión de API de Jira con Pedro (27-jul) — token PAF a 1 año, bandeja FAC; + seguimiento por correo del mismo día con los límites de velocidad (65k puntos/h, burst/s, por-issue) y entrega del token por Google Drive
- REGISTRO #57: hilo de WhatsApp con Erika (21-27 jul) — coordinación, envío del flujo por correo y reagenda 23→24 jul; 3 imágenes inferidas
- Transcripciones y correo en fuentes/; guion de validación en planeacion/
- Avance-Etapa1-2026-07-27 (nota + mensaje para Erika) y Excel del corte del 27-jul (núcleo verificado; capa de escritura en pausa por definición de Balam)
- Seguimiento-horas: sesiones del 24-jul (validación) y 27-jul (API Jira)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-27 08:18:08 -06:00
..

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.