Skip to content

English · Español

Lab 01 — Escribe el postmortem del viaje

🇪🇸 La autopsia del viaje. Cinco secciones, estructura canónica. No es un diario; es un documento técnico con narrativa. Mínimo 1500 palabras.

Objetivo

Producir docs/phase-40-hardening-postmortem/postmortem.md: un postmortem estructurado y sin culpa (blameless) del viaje de 40 fases por lynx-cortex. Longitud: ≥ 1500 palabras.

Preparación

  • Los 40 archivos PHASE_NN_REPORT.md.
  • La serie learners/borja/journal/YYYY-MM-DD.md.
  • PROPOSAL_REVIEW.md para el registro de decisiones arquitectónicas.
  • git log --oneline --decorate para la línea temporal.
  • El análisis de supervivencia de decisiones de theory/02-decision-survival.md (para informar §3).

Tareas

Sigue la plantilla de cinco secciones de theory/01-postmortem-structure.md:

Sección 1 — Resumen (100-200 palabras)

Escríbela al final. Lee todas las demás secciones primero, después destílalas en un único párrafo que capture: - Qué fue el proyecto (una frase). - Qué se entregó (una frase). - Qué no se entregó (una frase). - La lección principal (una frase).

Sección 2 — Línea temporal

Saca de git log y de los archivos PHASE_NN_REPORT.md. Una línea por fase. Formato:

2026-MM-DD — Phase NN <Name>. <One-line outcome>. [link to PHASE_NN_REPORT.md or commit SHA]

Añade anotaciones para los baches:

2026-03-04 — Phase 18 training loop kickoff.
2026-03-05 — TROUGH: training loss flat at 4.16; root cause discovered to be axis-1 vs axis-2 bug in attention mask. Fix in commit abc1234.
2026-03-06 — Loss curve resumes expected descent.

Incluye entre 5 y 10 "baches". Si el viaje fue demasiado tranquilo para encontrar alguno, o te estás mintiendo o no asumiste riesgos — ambas cosas merecen una línea en §3.

Sección 3 — Factores contribuyentes

Apunta a 5-8 factores. Mezcla estructurales y puntuales. Para cada uno, escribe 2-4 frases:

Factores estructurales (ejemplos): - La política NumPy primero / hecho a mano / framework al final. - El ritual por fase (Plan → Build → Teach → Run → Report → Reflect). - La política bilingüe. - La restricción CPU-only forzando un corpus microscópico. - El giro §A13 de gramática verbal desde las C-strings.

Eventos puntuales (ejemplos): - El bug de eje en la Fase 18. - La migración Pydantic v1 → v2 en la Fase 30. - La KV cache de la Fase 22 invalidando el sampler tal como estaba escrito en la Fase 21. - Eventos de cuota / coste / hardware.

Para cada uno, escribe la causa estructural, no la personal (según el principio blameless).

Sección 4 — Lecciones aprendidas

3-7 principios generalizables. Cada uno en el formato regla + por qué + cómo aplicar:

Lección 1: Construye el conjunto de evaluación antes que el modelo. Por qué: El corpus de verbos §A13 existía en la Fase 12 — seis fases antes del modelo. Cada evaluación posterior tuvo ground truth inequívoco. Cómo aplicar la próxima vez: En el próximo proyecto, dedica el primer 10% del tiempo al diseño de la evaluación. Niégate a escribir código de entrenamiento hasta que el conjunto de evaluación sea concreto y pequeño.

Lección 2: La intuición probada vence a la teoría elegante. Por qué: La elección de Pre-LN (Fase 17) se justificó con una comparación de ablación explícita, no con "todo el mundo lo usa". La ablación de 30 líneas valió el día. Cómo aplicar la próxima vez: Siempre que elijas entre dos opciones igualmente citadas, ejecuta una ablación de 1 hora. No la saltes.

Extrae las lecciones que cambiarán cómo empieza el próximo proyecto — no platitudes genéricas.

Sección 5 — Acciones a tomar

3-5 acciones concretas para futuros proyectos. Formato:

[Acción] para [fecha]. Propietario: [futuro-Borja]. Criterio de éxito: [señal observable].

Ejemplos:

Adopta la regla BLUEPRINT.md en el próximo proyecto desde el día 1. Propietario: futuro-Borja. Criterio de éxito: cualquier módulo nuevo en src/ tiene un BLUEPRINT.md en menos de 48 horas desde su creación.

Programa una relectura a 6 meses de este postmortem (evento de calendario para 2026-11-23). Propietario: futuro-Borja. Criterio de éxito: existe un evento de calendario con un enlace a este archivo.

Añade un check-in "off-ramp 1" el 2026-08-23 (a 3 meses). ¿Empezó Borja el próximo proyecto elegido? Propietario: futuro-Borja. Criterio de éxito: una entrada de journal en esa fecha o antes que responda sí/no con razonamiento.

Verificación de recuento de palabras

Ejecuta un recuento rápido tras cada sección. El documento final debe tener ≥ 1500 palabras.

wc -w docs/phase-40-hardening-postmortem/postmortem.md

Si está por debajo, examina qué secciones están delgadas. No rellenes — investiga qué secciones desarrollaste poco.

Aceptación

  • postmortem.md existe en docs/phase-40-hardening-postmortem/postmortem.md.
  • Las cinco secciones presentes, en el orden canónico.
  • Recuento de palabras ≥ 1500.
  • La línea temporal contiene fechas específicas, fases y al menos 5 baches anotados.
  • La sección de factores contribuyentes nombra ≥ 5 factores.
  • La sección de lecciones tiene 3-7 lecciones, cada una con regla/por qué/cómo aplicar.
  • Acciones a tomar tiene 3-5 entradas, cada una con fecha y criterio de éxito.
  • El markdown renderiza limpio (sin enlaces rotos).

Trampas

  • Saltar la línea temporal. Sin la línea temporal, el postmortem no tiene columna vertebral. No la cortes.
  • Escribir el resumen primero. Escríbelo al final; es una destilación.
  • Lenguaje blameless cosmético que oculta culpa personal. "Borja cometió un error" reformulado a "ocurrió un error" no es blameless — es evasivo. Blameless significa identificar la causa estructural que permitió el error. Siempre hay una causa estructural.
  • Demasiadas lecciones. Siete es el máximo. Más de siete significa que no filtraste; el lector hojeará y saltará.
  • Acciones sin fechas o criterios de éxito. Sin ellos, las acciones son deseos. Añade ambos, o borra la acción.
  • Volver a litigar decisiones. Un postmortem no es el lugar para argumentar que, digamos, la Fase 17 debió usar Post-LN. Indica la decisión, indica el resultado, sigue adelante. Guarda los "y si..." para la carta del próximo proyecto.

Extensión

  • Embebe diagramas clave. La cascada de supervivencia de decisiones (de theory/02-decision-survival.md), el gráfico de coste vs. aprendizaje (de PHASE_40_PLAN.md §2.1).
  • Añade una subsección "qué me sorprendió más". Tres a cinco sorpresas concretas del viaje. Suelen ser las lecciones de mayor señal.

Siguiente: 02-reading-list.md