La mayoría de los desarrolladores ha probado algún sistema para tomar notas y lo ha abandonado sin hacer ruido. El patrón se repite: un fin de semana entusiasta configurando carpetas, plantillas y etiquetas, luego tres semanas archivando con disciplina, y después nada. El sistema no falló porque las notas sean inútiles, sino porque costaba más de lo que devolvía.
Este artículo describe un sistema pensado precisamente para ese fallo. Los principios: capturar tiene que ser casi gratis, la estructura tiene que ser opcional, y encontrar una nota no puede depender de la disciplina que tuviste en el pasado.
Qué conviene capturar como desarrollador
No todo merece una nota. Hay cuatro tipos que compensan una y otra vez:
Arreglos y sus causas. En cuanto un bug persistente por fin cede, escribe una línea: el síntoma y la causa real. "Test de auth intermitente — depende de la zona horaria, congelar el reloj." Es la nota más valiosa que puedes tomar, porque el mismo error volverá a encontrarte, y el mensaje de error es justo lo que vas a buscar.
Decisiones y sus motivos. Por qué paginación por cursor y no por offset. Por qué el reintento vive en el worker y no en el cliente. La decisión queda en el código; el motivo no queda en ninguna parte si no lo escribes, y es justo el motivo lo que vas a necesitar dentro de unos meses.
Comandos y conjuros. La combinación exacta de flags, el orden de los pasos del despliegue, el comando de una línea con jq. Cualquier cosa que hayas buscado dos veces.
Ideas a medio formar. El refactor que hoy no puedes hacer, la idea de producto que llegó en mitad del stand-up. Son las notas que más tardan en dar fruto y las que antes se evaporan.
Qué dejar fuera: lo que tus herramientas ya registran (el historial de git, los sistemas de tickets) y las transcripciones en bruto de cualquier cosa. Las notas son para las conclusiones.
Regla uno: capturar tiene que costar menos de cinco segundos
El tamaño de tu bóveda de notas depende casi por completo de la fricción al capturar. Con veinte segundos por captura — encontrar la app, elegir una carpeta, pensar un título — solo las ideas que parecen importantes superan el listón, y los cuatro tipos de arriba casi nunca parecen importantes en el momento. Con dos segundos, todo lo supera.
En la práctica, eso significa capturar desde donde ya estás:
En la terminal: una herramienta de captura por CLI. Con Notez,
notez "the fix was the connection pool size"— un binario de 3 MB que funciona por SSH y acepta la salida de otro comando por pipe, así que un stack trace entra con| notez.En el navegador: algo que se alcance desde la barra de direcciones. Escribir
notez.dev/your thoughtconvierte la URL en una nota, sin cambiar de app.En una sesión con IA: si tus asistentes hablan MCP, pídeles que escriban hallazgos y decisiones directamente en la bóveda ("guarda una nota con lo que decidimos aquí").
Lo que tienen en común: al capturar no eliges destino, ni título, ni formato. Una sola bandeja de entrada, y todo cae ahí.
Regla dos: la estructura se añade después, y solo donde se gana su lugar
El consejo de siempre — archivar cada nota en una jerarquía — era un impuesto que se pagaba a la búsqueda por palabras clave, que necesita ayuda para encontrar las cosas. Con una búsqueda por significado, una nota de dos líneas sin título se encuentra por su contenido, así que la cantidad de organización por defecto debería ser cero.
Añade estructura solo donde hace un trabajo que la búsqueda no puede hacer:
Etiquetas para enumerar. Cuando necesitas todas las notas de un tipo — cada
1on1, todo lo etiquetado comoresearch— etiquétalas. La búsqueda encuentra notas parecidas; las etiquetas garantizan conjuntos completos.Enlaces para las relaciones. Ten una nota mínima por cada proyecto y cada sistema, y enlázala (
[[en Notez) cada vez que aparezca. Los retroenlaces mantienen entonces un índice vivo de todo lo que toca ese proyecto o sistema, sin archivar nada.Tableros para las notas que funcionan como tareas. Una vista kanban sobre las notas cubre la lista de "cosas por probar" sin una app de tareas aparte.
Favoritos para las cinco de cada día. Las notas que abres constantemente deberían estar a un clic, no a una búsqueda.
Regla tres: encontrar una nota no puede depender de tu coherencia
El sistema tiene que funcionar en el sexto mes, cuando ya no recuerdas qué palabras usaste en el primero. Hay dos mecanismos que lo cubren.
La búsqueda semántica compara significados, no vocabulario: "aquella idea de la caché" encuentra la nota sobre memoización. Es la mayor mejora frente a los sistemas en los que haces grep sobre tus notas, porque ya no hace falta usar las mismas palabras que usaste hace meses.
Hacer preguntas va un paso más allá: en lugar de buscar la nota, le preguntas a la bóveda. El chat de IA de Notez encuentra las notas relevantes y responde con fuentes: "¿qué escribí sobre el pipeline de importación?" devuelve una respuesta que puedes comprobar contra las notas en las que se basa.
Una revisión semanal de diez minutos, no una hora de archivar
El único mantenimiento periódico que vale la pena:
Repasa por encima lo capturado en la semana.
Rescata lo que vaya a durar: añade un enlace a la nota de su proyecto, y una etiqueta si pertenece a un conjunto.
Borra lo que sea claramente efímero. (O no: la búsqueda tolera el ruido mejor de lo que crees.)
Eso es todo. Las revisiones de una hora dejan de hacerse; las de diez minutos sobreviven a las semanas cargadas.
Asegúrate una salida
Una regla general para elegir herramientas: tus notas van a durar más que cualquier app, así que elige herramientas que lo asuman. El listón es poder exportar en texto plano o Markdown en cualquier momento: Notez exporta un espacio de trabajo entero como un .zip de archivos Markdown con sus adjuntos, y lo que uses también debería superarlo. Un sistema del que puedes irte es un sistema al que puedes confiar diez años de ideas.
Todo el sistema en una pantalla
Captura desde donde estés, en menos de cinco segundos, en una sola bandeja de entrada.
Sin carpetas. Etiquetas para conjuntos completos, enlaces para relaciones, favoritos para las notas de cada día.
Encuentra por significado; haz preguntas cuando buscar sea más lento.
Diez minutos de revisión a la semana.
La exportación a Markdown como salida de emergencia.
Es aburrido a propósito. Lo aburrido es lo que sobrevive a un mes cargado, y un sistema que sigue funcionando en el sexto mes vale más que cualquier sistema elaborado que no pasó de la tercera semana.
Sigue leyendo
Cómo tomar notas desde la terminal — tres formas de tomar notas en la shell, desde
echo >> ~/notes.mdhasta una CLI de captura, y dónde falla cada una cuando necesitas recuperar la nota.Primeros pasos con Notez CLI — los comandos de instalación para macOS, Linux y Windows, dónde guarda la clave
notez loginy cómo usar la CLI en scripts con--json.Webhooks: convierte en nota todo lo que hable HTTP — una URL convierte un evento de GitHub, un paso de Zapier o un cron job en una nota, con etiquetas, adjuntos y una comprobación de firma opcional.