Notas perennes: Escribe notas que se acumulan con el tiempo

La mayoría de las notas de ingeniería se escriben una vez y se olvidan. Capturas algo durante una sesión de depuración, lo pegas en algún lugar y lo encuentras dos años después sin ningún contexto sobre por qué era importante.

El problema no es el esfuerzo. Los ingenieros escriben constantemente: comentarios en el código, mensajes en Slack, páginas en Confluence, descripciones en Jira, explicaciones en solicitudes de extracción (pull requests), diagramas de arquitectura. El problema es que la mayoría de esas notas están escritas para un momento específico y envejecen mal. No se acumulan como intereses compuestos. Se acumulan como deuda.

Las notas perennes son la alternativa. La idea es simple: escribe cada nota de manera que permanezca útil indefinidamente, mejore cuando la revisites y se conecte con otras notas de tal manera que todo el sistema sea más valioso con el tiempo.

El término fue popularizado por el investigador Andy Matuschak, cuyas propias notas públicas demuestran la idea a gran escala. Para los ingenieros, el principio tiene aplicaciones directas en la escritura técnica, la documentación, las decisiones de arquitectura y la captura a largo plazo de lecciones difícilmente aprendidas.

Qué hace que una nota sea perenne

Atómica

Una nota perenne contiene una sola idea. No un tema, sino una idea.

Una nota llamada “PostgreSQL” no es perenne. Es un contenedor esperando ser llenado. Una nota llamada “Los índices parciales reducen la sobrecarga de escritura cuando las consultas apuntan a un pequeño subconjunto” es perenne. Enuncia una afirmación específica y portátil.

La restricción de atomicidad es importante porque controla la reutilización. Una nota contenedora solo puede enlazarse como un tema vago. Una nota atómica puede enlazarse dondequiera que esa idea específica sea aplicable: en una discusión sobre optimización de consultas, en una comparación de estrategias de indexación, en una nota de proyecto sobre un problema de rendimiento específico.

Autónoma

Una nota perenne debe ser comprensible sin su fuente original.

Esto significa escribir con tus propias palabras. Una nota que dice “Ver el artículo vinculado — buen material sobre caché” no es perenne. Una nota que dice “La caché write-through actualiza la caché sincrónicamente con la base de datos en cada escritura, mejorando la consistencia de lectura a costa de una mayor latencia de escritura” es perenne. Puedes leerla un año después sin tener que buscar la fuente original.

Esto es más difícil de lo que parece. Escribir una nota autónoma requiere realmente entender lo que leíste, no solo etiquetarlo. Ese paso de procesamiento es donde ocurre la mayor parte del aprendizaje.

Evolutiva

Las notas perennes mejoran con el tiempo en lugar de desactualizarse.

Una nota fugaz tiene un ciclo de vida: la escribes, sirve para un momento y se vuelve irrelevante. Una nota perenne debe valer la pena revisitar y refinar seis meses o dos años después. Podrías agregar un contraejemplo, actualizarla con una experiencia en producción, enlazarla a un nuevo patrón o simplemente reescribirla con mayor precisión.

La palabra “perenne” es intencional: estas notas no mueren después de la cosecha. Persisten y mejoran.

Enlazada

Las notas perennes se conectan con otras notas en lugar de estar aisladas.

Una nota autónoma sobre caché write-through se conecta naturalmente con notas sobre cargas de trabajo intensivas en lectura, invalidación de caché, consistencia eventual y rendimiento de escritura en bases de datos. Cada enlace hace que ambas notas sean más útiles: la conexión revela un contexto que ninguna de las dos notas contiene por sí sola.

El hábito de enlazar es lo que convierte una colección de ideas individuales en una red de comprensión conectada.

Tipos de notas y cuándo usar cada una

Entender las notas perennes requiere entender lo que no son.

Notas fugaces son capturas temporales. Una línea garabateada durante una sesión de depuración, un marcador para revisar, una pregunta para hacer seguimiento. Las notas fugaces sirven para un momento. Deben procesarse rápidamente y desecharse o promoverse a algo más duradero. La mayoría de las notas fugaces nunca se convierten en notas perennes, y eso está bien.

Notas de literatura son resúmenes de fuentes externas: una página de documentación, un postmortem, un capítulo de un libro, una conferencia. Las notas de literatura preservan lo que dijo una fuente. Son un paso hacia la comprensión, no la comprensión en sí. Una nota de literatura dice “esta fuente afirma X”. Una nota perenne dice “Creo en X por estas razones”.

Notas perennes sintetizan lo que has llegado a entender. Viven en el output del proceso de aprendizaje, no en la entrada.

Escribiendo notas técnicas perennes

La estructura de una buena nota técnica perenne sigue una lógica simple: afirmación, evidencia, implicación.

# La caché write-through mejora la consistencia de lectura a costa de la latencia de escritura

La caché write-through actualiza la caché al mismo tiempo que el almacén subyacente
en cada escritura. Cada lectura accede a datos frescos porque la ruta de escritura asegura
la consistencia antes de que se reconozca la escritura.

El compromiso es la latencia de escritura: cada escritura ahora requiere dos operaciones (almacén
y caché) para completarse antes de que el llamante reciba una confirmación.

Este patrón se adapta a cargas de trabajo intensivas en lectura donde la obsolescencia de la caché tiene un
impacto comercial real, como los conteos de inventario de productos o los ajustes de usuario.

Enlaces:
- [[La caché read-through despliega la población de la caché al tiempo de lectura]]
- [[La invalidación de caché es un problema de coordinación]]
- [[La caché write-behind intercambia consistencia por throughput de escritura]]

Esa nota es útil sin la fuente. Enuncia la afirmación, explica el compromiso, da un contexto donde se aplica y enlaza a ideas relacionadas.

Qué evitar

Referencias sensibles al tiempo envejecen mal. “A partir de Postgres 14, este comportamiento funciona así” es una nota de literatura, no una nota perenne. Escribe el principio en su lugar: “El planificador omite escaneos de índice cuando el conteo estimado de filas excede un umbral relativo al tamaño de la tabla.” Esa afirmación sobrevive a los cambios de versión incluso si el umbral cambia.

Comandos específicos de herramientas sin contexto son fragmentos, no notas. Una nota que es solo un comando kubectl copiado de una respuesta de StackOverflow no es perenne. Una nota sobre por qué ese comando funciona — qué recurso de Kubernetes afecta y qué problema resuelve — tiene posibilidades.

Suposiciones sobre el conocimiento del lector se degradan rápidamente. Escribe como si explicaras a un colega competente que no está dentro de tu contexto actual.

Buenos candidatos para notas perennes en ingeniería

Casi cualquier lección difícilmente aprendida con amplia aplicabilidad es un buen candidato:

• Compromisos de arquitectura y el razonamiento detrás de las decisiones
• Patrones de depuración que se aplican en varios sistemas
• Reglas de diseño de API y sus casos extremos
• Características de rendimiento con números del mundo real adjuntos
• Suposiciones de seguridad que resultaron ser incorrectas
• Lecciones de estrategia de pruebas de proyectos donde el enfoque falló
• Restricciones de despliegue que cambiaron cómo trabajó el equipo

El hilo conductor: suficientemente específico para ser accionable, suficientemente general para aplicarse más de una vez.

El flujo de trabajo perenne

Paso 1: Capturar notas fugaces

Captura rápidamente sin sobre pensar. El objetivo no es producir una nota perenne en el momento, es preservar la materia prima para una.

Durante una sesión de depuración:

Descubrí que la caché estaba devolviendo permisos de usuario obsoletos después de cambios de rol.
El TTL era de 5 minutos pero la actualización del rol era inmediata.
Necesito pensar cómo manejar esto: ¿invalidación en escritura?
¿O TTL más corto? ¿O actualización impulsada por eventos?

Esa es una nota fugaz. No es una nota perenne, pero contiene las semillas de varias.

Paso 2: Procesar en notas perennes dentro de 48 horas

El procesamiento es donde aparece el valor. Toma la captura cruda y extrae las ideas que valen la pena preservar.

De esa nota de depuración, podrías escribir:

# Las entradas de caché basadas en roles requieren invalidación en escritura, no solo expiración por TTL

Cuando los datos en caché codifican permisos o roles, la expiración basada en TTL no es segura.
Un usuario cuyo rol es degradado mantiene permisos elevados hasta que expira el TTL.
Se requiere invalidación en tiempo de escritura — o actualizaciones de caché impulsadas por eventos en cambio de rol —
para la corrección en cachés sensibles a los permisos.

Enlaces:
- [[La invalidación de caché es un problema de coordinación]]
- [[Las decisiones de autorización no deben almacenarse en caché en reposo sin validación]]

El contexto de depuración ha desaparecido. La idea portátil permanece.

Paso 3: Conectar con notas existentes

Después de escribir la nota, dedica dos minutos a preguntarte:

• ¿Con qué nota existente se relaciona esto?
• ¿De qué concepto depende esto?
• ¿Qué extiende o contradice esto?

Agrega enlaces en ambas direcciones. La nueva nota enlaza a las notas existentes. Las notas existentes que ahora son más ricas por la conexión enlazan de vuelta.

Paso 4: Revisitar y mejorar

Las notas perennes no tienen un estado correcto único. Cada vez que te encuentres con la idea nuevamente — en un incidente de producción, una revisión de diseño, un comentario en revisión de código — considera regresar a la nota y hacerla mejor.

Podrías:

• Agregar un ejemplo más concreto
• Actualizar la afirmación basada en nuevas evidencias
• Eliminar un matiz que resultó no importar
• Agregar un enlace a una nueva nota relacionada
• Reescribir la frase inicial para mayor claridad

Ese ciclo de refinamiento es lo que hace que las notas se acumulen en lugar de decaer.

Notas perennes y documentación

Hay una distinción útil entre notas perennes personales y documentación del equipo.

Las notas perennes personales son tu comprensión, escritas para tu futuro yo. Pueden ser toscas, opinadas e incompletas. Su valor está en ser reutilizables para tu pensamiento.

La documentación del equipo es para comprensión compartida. Necesita precisión, accesibilidad y propiedad de mantenimiento.

Las dos capas se complementan entre sí. Tus notas perennes sobre por qué un sistema fue diseñado de cierta manera pueden convertirse en la materia prima para el registro de decisiones de arquitectura. Tus notas de depuración pueden alimentar el libro de ejecución (runbook). Tus notas de diseño de API pueden informar la guía de estilo.

La dirección del flujo suele ser: notas perennes → documentación pulida, no al revés.

Notas perennes y sistemas RAG

A medida que las herramientas de conocimiento aumentadas por IA se vuelven más prácticas, las notas perennes bien escritas se vuelven cada vez más valiosas como material fuente de recuperación. El problema de recuperación versus representación en la gestión del conocimiento es esencialmente sobre la calidad del material fuente — y las notas perennes, al ser atómicas, autónomas y escritas para la comprensión, se fragmentan bien para la búsqueda vectorial.

Un Zettelkasten de notas perennes atómicas es una base natural para un sistema personal de RAG. La estructura atómica se alinea con el tamaño del fragmento de recuperación. La propiedad autónoma significa que las notas recuperadas no necesitan contexto adicional para ser útiles. La estructura de enlaces proporciona oportunidades de traversal de grafo más allá de la búsqueda por palabras clave.

Esto es cada vez más relevante para los ingenieros que quieren consultar su propia base de conocimiento con un LLM en lugar de empezar desde cero cada vez.

Errores comunes

Escribir demasiado ampliamente

Una nota que cubre un tema entero no es una nota perenne — es un artículo en borrador. Si tu nota es más larga que una sola pantalla y cubre más de una afirmación, divídela en notas más pequeñas y enlázalas.

Escribir demasiado estrechamente

Una nota que es demasiado específica para un contexto no tiene valor de reutilización. “Corregido el bug de la caché del servicio de facturación el 2024-03-14” es una entrada de registro, no una nota perenne. Eleva el nivel de abstracción hasta que la idea se aplique en al menos tres contextos diferentes.

Confundir “Perenne” con “Nunca Cambia”

Perenne no significa inmutable. Significa que la nota sigue valiendo la pena revisitar. Una nota sobre genéricos en Go escrita en 2022 sigue siendo perenne si la actualizas para reflejar cómo evolucionaron los patrones en 2024. Una nota que nunca tocas porque crees que es permanentemente correcta es una nota que eventualmente se volverá incorrecta en silencio.

Saltarse el paso de procesamiento

El fracaso más común es tratar las notas perennes como un objetivo de colección en lugar de una práctica de escritura. No puedes crecer una colección de notas atómicas de alta calidad guardando marcadores. La nota perenne no es el artículo que leíste — es lo que extrajiste de él con tus propias palabras.

Herramientas

Obsidian

Obsidian es la herramienta más popular para notas perennes. Sus archivos Markdown locales, enlaces bidireccionales y vista de grafo se alinean bien con la práctica. Una estructura simple:

vault/
  fleeting/
    daily/
  literature/
  evergreen/
  maps/       ← notas índice para clusters de notas perennes

La vista de grafo en Obsidian hace visibles los clusters de enlaces — útil para descubrir qué conceptos forman grupos naturales que podrían convertirse en notas índice o artículos publicados.

Markdown plano con Git

Un repositorio Git de archivos Markdown funciona bien y no tiene dependencia de ninguna herramienta específica. Los enlaces Markdown estándar conectan las notas. La búsqueda es manejada por tu editor o grep. El historial de versiones viene de Git.

knowledge/
  evergreen/
    caching/
    api-design/
    performance/
  literature/
  fleeting/

La disciplina es la misma independientemente de la herramienta — una idea por nota, escrita con tus propias palabras, enlazada a notas relacionadas.

Empezando desde cero

La manera más útil de empezar no es migrar tus notas existentes. Es escribir una nota perenne hoy.

Toma algo que aprendiste en la última semana. Escríbela como una afirmación. Explícala con tus propias palabras en un párrafo. Agrega enlaces a cero o una idea relacionada.

Esa es una nota perenne completa. Repite una vez por semana durante seis meses y tendrás un sistema funcional.

El efecto de interés compuesto tarda en hacerse visible. Los ingenieros que mantienen notas perennes durante un año a menudo informan que sus notas empiezan a responder preguntas antes de que terminen de hacerlas — porque ya han escrito la respuesta en un contexto anterior.

Reflexiones finales

La razón por la que las notas perennes funcionan no es que sean mejores para el almacenamiento. Son mejores para el pensamiento. La disciplina de escribir una idea portátil por nota, con tus propias palabras, con enlaces a ideas relacionadas, fuerza una comprensión que la colección pasiva no hace.

Para los ingenieros, esto tiene consecuencias prácticas. Las notas de un incidente de producción que procesas en formato perenne son más útiles que el registro del incidente. El compromiso de diseño que destilas en una nota atómica es más útil que el diagrama de arquitectura. El patrón de depuración que generalizas de un bug específico es más reutilizable que el ticket.

Usadas junto con el método PARA para organizar el trabajo activo, las notas perennes te dan la capa conceptual que PARA no proporciona — una red creciente de comprensión reutilizable que persiste a través de proyectos, a través de roles y a través de años.