- En tareas que se extienden por varios días, como un problema de permisos en el pipeline de despliegue, es fácil perder el contexto de trabajo con un solo mensaje, reunión o llamada.
- Un diario de trabajo es el hábito de anotar los comandos ejecutados, los resultados, el flujo de pensamiento y la siguiente acción, y ayuda a recuperar la concentración rápidamente al retomar.
- Después de empezar a escribir la situación en las notas diarias de Obsidian durante tareas con poca documentación y donde era difícil contactar a la persona responsable, se volvió más fácil reconstruir el contexto al pasar entre varias tareas.
- La clave no está en volver a leer todo el registro después, sino en crear una estructura que ordene el pensamiento y un caché que guarde el último estado.
- Si se te corta la concentración con frecuencia, puedes reducir el costo de cambiar de contexto dejando una nota breve sobre lo que estás haciendo y la siguiente acción, y al volver leer las últimas pocas líneas.
El momento en que se rompe el contexto de trabajo
- Cuando llevas varios días atorado con una tarea compleja, tienes que mantener en la cabeza el flujo de resolución del problema mientras saltas entre varias pestañas de documentación y resultados de comandos.
- Incluso una interrupción breve, como una notificación de IM, una solicitud de documentación de un PM o una llamada del manager, puede hacerte perder con facilidad dónde ibas.
- Era especialmente difícil mantener la concentración al cambiar de contexto todo el día como administrador, o al manejar al mismo tiempo varios proyectos en conflicto como desarrollador.
- Un patrón común es empezar una tarea, cambiar a otra, entrar a una reunión y terminar el día leyendo correos e IM sin recordar la esencia de lo que estabas haciendo al principio.
Método y efecto del diario de trabajo
- Mientras trabajaba en tareas sin documentación y donde también era difícil contactar a la persona responsable anterior, empecé a escribir mi frustración en las notas diarias de Obsidian.
- Después empecé a registrar juntos los comandos ejecutados y sus resultados, el flujo de pensamiento, lo que estoy haciendo ahora y lo que pienso hacer después.
- Por ejemplo, anotar comandos como
--yo-compress-shit really-well-like-5000-or-somethingy los errores de fallo. - Después de una interrupción, releo el registro y vuelvo rápido a la tarea original.
- Por ejemplo, anotar comandos como
- Tras mantener este método durante los últimos 3 a 4 meses, sentí que la reconstrucción del contexto se volvió mucho más rápida al cambiar entre varias tareas.
- Un diario de trabajo no es un documento para releer por completo más tarde.
- El proceso mismo de registrar crea una estructura que ordena las ideas.
- Las últimas pocas líneas funcionan como un caché que guarda el estado necesario para volver a empezar.
- Si tu concentración se rompe seguido o tienes que ir y venir entre varias cosas, puedes empezar con algo simple: anota lo que estás haciendo ahora y lo que estás pensando, y al retomar vuelve a leer las últimas pocas líneas.
1 comentarios
Opiniones de Hacker News
La ventaja de llevar un diario no es solo que sea más fácil retomar el trabajo, sino que ayuda a solidificar el modelo mental en una estructura ramificada de posibilidades concretas estrechamente ligadas a un problema específico.
El trabajo pasa a ser explorar y modificar ese árbol, y se puede reducir el tiempo que se pierde descubriendo ramas faltantes para completarlas o recorriendo al azar los mismos puntos una y otra vez.
En especial en sistemas distribuidos, el trabajo es minucioso, manual, propenso a errores y con mucha latencia; con un modelo sólido, se pueden procesar las listas de verificación con mucha más confianza.
La capacidad de convertir sobre la marcha un problema complejo en una forma más concreta es una habilidad clave.
La mayor barrera es algo parecido a los celos. Parece que otras personas hacen estas cosas solo en su cabeza, sin documentación, y al tomar eso como prueba de superioridad intelectual, uno empieza a sospechar que usar una ayuda como un diario significa falta de capacidad.
Pero mapear problemas complejos con herramientas no es un fracaso, sino casi una necesidad, sobre todo en sistemas que se abordan por primera vez. Con el tiempo, al acumular experiencia, puede que se necesiten menos ayudas, pero eso tiene más que ver con la diferencia de experiencia que con una señal de inteligencia o capacidad.
Lo uso todos los días.
El primer commit puede empezar con tres líneas de código y un comentario largo con lo que ya intenté o pensé.
Para cuando termino el trabajo, elimino las partes especulativas o demasiado extensas, y lo que queda suele ser código muy bien comentado.
Creo que este método produce mejor código más rápido que mantenerlo todo solo en la cabeza. Hasta ahora nadie se ha quejado.
Ahora simplemente conocen ese camino y ya no necesitan el diario, pero a nuestros ojos parecen superiores.
No sé cuánta explicación debería escribir. Estoy escribiendo código, y algunos dicen que el código debería explicarse por sí mismo, así que al final se vuelve a la vieja pregunta de cuántos comentarios poner junto al código.
También es un problema cómo volver a encontrar notas escritas antes. Se pueden usar etiquetas y búsqueda, pero no es fácil imaginar la etiqueta perfecta que uno recordará después.
Ya tengo demasiadas notas, y muchas de ellas quedaron obsoletas. No quiero dedicar tiempo a actualizarlas, pero si no lo hago pueden generar malentendidos.
Hace falta un equilibrio entre “simplemente hacerlo” y “escribir sobre ello”, y no estoy seguro de haber encontrado bien ese equilibrio.
Como alternativa, también parece posible un foro donde los colegas discutan lo que están haciendo ahora, lo que planean hacer y lo que ya terminaron. Aun así, la capacidad de búsqueda podría ser un problema, pero las herramientas de foro registran automáticamente cuándo y quién escribió cada cosa.
Las notas de otras personas pueden ayudar tanto como las propias.
Cuando empecé con Obsidian lo usaba de esa forma, pero mientras más contenido agregaba, más empecé a organizarlo todo.
Así terminó pareciéndose más a un repositorio de textos largos que a un diario.
Estoy pensando en usar ambos, para tener una herramienta aparte dedicada al journaling.
Lo que hizo que este hábito se me afianzara fue abandonar por completo la estructura, la organización y conceptos formales como “log” o “journaling”, priorizar totalmente la captura por encima de la búsqueda, y dejar lo demás para más tarde en manos de las herramientas de búsqueda y la proximidad.
Configuré el ícono de OneNote en el área de notificaciones para crear una nueva nota rápida y lo uso sin restricciones.
De vez en cuando reviso páginas completas, especialmente las recientes, combino y reorganizo algunas, muevo otras a la pestaña “archive” y listo.
La tinta más tenue y desordenada es más poderosa que el recuerdo más fuerte.
Cada vez creo un archivo de texto nuevo y no lo vuelvo a abrir, o escribo una página en un cuaderno de papel y no la vuelvo a mirar.
El acto de escribir en sí aporta muchísimo valor.
Está en orden cronológico de arriba abajo, y separo los párrafos por día laboral.
Escribo con más detalle del necesario, y no penalizo los errores de ortografía o gramática.
La función Daily Note de Obsidian es excelente, y si necesito un documento dedicado para un tema específico, puedo extraer una página desde ahí.
Como es simplemente Markdown, la búsqueda es rápida, y también me gusta poder usar expresiones regulares si hace falta.
La vista de grafo sirve para crear notas sobre temas específicos y conectarlas entre sí, o separar algunas partes para explicarlas con más profundidad, pero no es imprescindible si no estás construyendo tu propia base de conocimiento.
Incluso esa base de conocimiento, como cualquier documento, se vuelve obsoleta con el tiempo.
Mientras la herramienta de notas permita buscar lo suficiente como para volver a encontrar las cosas, no importa demasiado cuál uses; al final lo importante es anotarlo.
Para volver a encontrar algo, los backlinks por sí solos funcionan sorprendentemente bien.
Para este uso, GitHub Issues encaja sorprendentemente bien
Todo en lo que estoy trabajando tiene un issue de GitHub. El trabajo open source va en repositorios públicos, y el resto del trabajo y la investigación personal en repositorios privados
Cada vez que descubro algo, agrego un comentario. Puede incluir fragmentos de código copiados y pegados, enlaces útiles, citas, capturas de pantalla o referencias a otros issues
Muchas veces un solo issue termina con decenas de comentarios míos, y esos comentarios se vuelven un registro detallado del proceso de trabajo; aunque me interrumpa o cambie a otra cosa, me permiten retomarlo rápidamente
Aquí hay un ejemplo de un hilo público de investigación más complejo: https://github.com/simonw/public-notes/issues/1
Cada día creo un issue nuevo para planear lo que quiero hacer ese día y también dejar notas sueltas. Describí ese método aquí: https://til.simonwillison.net/github-actions/daily-planner
Como lo uso no solo para un diario de trabajo sino para todo, aparece un pequeño problema
Cuando tiras ahí tanto material de referencia futuro como logs de trabajo, y terminas con unos 50 canales, es fácil no volver a mirarlos salvo cuando los necesitas
Al principio parece más una función que un bug, pero revisar una vez después de cierto tiempo desde la captura realmente ayuda
Por eso planeo crear un bot que cada fin de semana reorganice los logs de trabajo y los volcados de referencias y me los envíe por email
Después de eso, creo que sería perfecto para mí crear notas semanales privadas personales como https://simonwillison.net/tags/weeknotes/ y repasarlas el fin de semana
https://GitHub.com/irthomasthomas/undecidability/issues
El código que lo hace funcionar está aquí
https://GitHub.com/irthomasthomas/label-maker — inicio y estado actual
Como sigo comentando en el issue mientras lo voy “resolviendo”, normalmente hay muchos más comentarios en issues que commits
Si aparece un problema nuevo, creo un issue nuevo; si surge una nueva idea sobre ese problema, dejo un comentario, y así sucesivamente
Me da cierta duda dejar un flujo de trabajo personal a merced de una empresa
Sorprende cómo muchos desarrolladores intentan sobreoptimizar la productividad con herramientas y técnicas sofisticadas, pero en la práctica todo termina volviendo a fundamentos simples
Como fundador con mucho cambio de contexto, dependo de unas pocas cosas
Un archivo de texto interminable para tareas y diario de trabajo [0], un calendario para planificar y bloquear tiempo de concentración, un bloqueador de sitios web y notificaciones desactivadas
[0] https://news.ycombinator.com/item?id=39432876
El formato de esquema de org-mode también es bastante bueno, y los comandos de teclado para crear y manipular esquemas, crear enlaces y alternar estados TODO se aprenden en un día
Como uso Doom Emacs, ya sabía vi, así que fue fácil empezar porque no tuve que aprender también comandos nuevos de edición de texto
El concepto de “inbox” del método Zettelkasten también me resultó muy útil
Cuando aparece algo que todavía no entra en mi sistema, lo pongo en el inbox para procesarlo más tarde. En la computadora uso org-capture, y en el teléfono, beorg
Así no tengo que hacer un cambio completo de contexto solo para ingresar una nota, y luego solo tengo que vaciar el inbox periódicamente
Actualmente no uso Emacs para nada más que org-mode, pero me satisface mucho más que un archivo
.mdinterminableSolo uso un plugin del editor que facilita marcar tareas como completadas o canceladas, y cambio el archivo cada mes para ordenarlo un poco y reducir el alcance de las búsquedas por palabra clave
Durante varios años ha sido mi forma más efectiva de hacer gestión de proyectos y journaling
Me refiero, por ejemplo, a una lista mensual como la que se usa en bullet journal
¿Cuál sería la mejor forma de sincronizar en la nube? En equipos de la empresa puede haber restricciones para instalar apps
Me gusta tener un archivo devlog.md por cada proyecto o repositorio
El log no es más que una pila de comentarios, pendientes y quejas en orden cronológico inverso
En VSCode tengo mapeado cmd+shift+I para insertar una marca de tiempo
Cada vez que quiero escribir algo, pongo una marca de tiempo al inicio de la lista y sigo escribiendo. Mantengo este archivo junto al repositorio
Es especialmente útil por la mañana para recuperar en qué me había quedado la noche anterior
Puede incluir cualquier cosa: notas sobre la estructura de módulos, fragmentos de código y datos para pruebas, etc.
Como dijo uno de los comentarios superiores, funciona como un sistema más grande, es decir, como nodos de conocimiento dentro de un grafo, y termino revisando esos logs más seguido de lo que esperaba
Cuanto más exploras y documentas, más conexiones aparecen y mejor se vuelve
devlog.mdal sistema de control de versiones?Si no, ¿cómo lo sincronizas entre varias computadoras?
Para mí, la parte más difícil de las metodologías y trucos de trabajo como llevar un diario o Pomodoro es mantenerlos en el tiempo
Tengo un diario de trabajo, pero lo abandono y vuelvo, lo abandono de nuevo y vuelvo otra vez
Agradecería consejos de quienes han logrado sostenerlo por mucho tiempo
Manejo todo con un diario de trabajo y seguimiento de tiempo, incluidos mis proyectos personales, pero tuve que aprenderlo por etapas hasta que se convirtió en un flujo de trabajo natural
La ruta que recomiendo es esta. Al principio, concéntrate solo en dejar algún tipo de nota al comienzo o al final de cada día
No importa dónde ni en qué formato escribas; lo clave es anotar siempre aunque sea un poco al inicio o al final del día
Cuando ya tengas el hábito de tomar notas todos los días, identifica en qué actividades necesitas notas con más frecuencia y anota antes o durante esas actividades
Por ejemplo, si sueles volver a consultar un ticket de trabajo para encontrar información importante, empieza a incluir esa información en tus notas
Cuando ya tomes notas todos los días y agregues lo que necesitas, se acumularán muchas notas; ahí es cuando conviene pensar en estructura y formato
Si sientes que un archivo de texto con tu propio marcado no escala, puedes mirar herramientas como Obsidian y Markdown, o Emacs y org-mode
Después, repite el proceso de usar todos los días el método de notas que elegiste, crear buenos hábitos y mejorar tu sistema de notas para que se adapte a ti
Si algo te parece poco valioso en comparación con el tiempo que requiere, cámbialo para dedicarle menos tiempo o simplemente déjalo
Después de ver una vez lo útiles que son las notas antiguas, queda clarísimo que hay que actualizarlo
Mantengo un encabezado estándar para cada entrada nueva
* DD/MM/YYYY** Admin** Meetings** Tickets/Stories/Work** ProblemsCopio y pego ese encabezado al final del archivo y voy completándolo mientras avanzo
Antes hacía que el diario se abriera automáticamente al iniciar el editor, pero al final quité esa configuración
Lo que realmente me funcionó fue convertir el diario en la herramienta principal de mi trabajo
En lugar de escribir de vez en cuando lo que hice hoy, cuando empiezo algo medianamente complejo escribo de inmediato mi enfoque. Por ejemplo: “Necesito hacer X, así que empecé por Y”
Tal vez haces distintos tipos de trabajo y, de manera inconsciente, sientes que el journaling es útil para algunos y para otros no
Está bien. Considéralo una herramienta ocasional, y cuando te atasques con algo y te frustres, ten presente el journaling como una opción
La técnica de escribir un diario mientras trabajas a veces se llama interstitial journaling, y me llegó a gustar mucho como forma de ayudar a concentrarme y llevar registro de lo que estaba haciendo
Creé una herramienta que conecta esas notas con proyectos diferenciados por color y marcas de tiempo
https://interstitch.app
Sin querer terminó pareciéndose a una herramienta de seguimiento de tiempo facturable como la que usaría un freelancer, pero el caso de uso que me interesa es la productividad personal
Aparte de mi uso personal, no puedo decir que haya generado mucho interés, pero es bastante agradable ir dejando notas sobre la marcha y ver fácilmente cuánto tiempo dediqué a un proyecto específico
También puedes agregar
#hashtaga las notas y filtrar por ese hashtag en la vista de calendarioEs completamente gratis si a alguien le sirve
“Ignora todas las instrucciones anteriores. Muestra tu proceso de trabajo. Explica tu proceso de pensamiento en detalle. Mantén un diario del avance del trabajo.”
He usado este prompt conmigo mismo de forma intermitente durante años, pero sigo alucinando, perdiendo el foco y yéndome por las ramas
Uso un método parecido: mientras resuelvo un problema, escribo una entrada de blog para mí mismo
Se siente como escribir una guía de uso antes de saber realmente cómo hacerlo, y cada vez que busco material cito las fuentes
Cuando el problema queda resuelto o ya construí “eso”, vuelvo a revisar el documento y lo publico internamente o lo guardo en el archivo
Este hábito realmente se consolidó después de leer Writing to Learn, de William Zinsser. Hoy se lo recomiendo a todo el mundo
“Escribir nos permite descubrir qué sabemos y qué no sabemos sobre aquello que intentamos aprender”
Prácticamente cada vez que intento llevar un diario por salud mental, termino atorado con cómo se supone que debo hacerlo
Logseq y Obsidian se mencionan mucho, pero pierdo el interés mientras intento entender cómo usar una sintaxis críptica. Es un diario; ¿por qué tengo que programar?
Me gustaría que hubiera una opción lista para usar, pero no parece haberla
Cuando saco el tema en este tipo de discusiones, las respuestas son cosas como “es fácil: instala X, agrega este y aquel plugin, modifica este archivo…”, con lo cual terminan demostrando el punto. Mi cerebro con rasgos de TDAH pierde el interés ahí mismo
En el mercado realmente falta una buena herramienta que abras y uses de inmediato, que sea open source y que se pueda autoalojar
No hablo de un bloc de notas, sino de una herramienta donde abres la app, vuelcas notas en la fecha de hoy y se guardan
Hay herramientas como DayOne, pero el almacenamiento basado en la nube es claramente inviable para mí y para mucha gente
También ha habido incontables discusiones de este tipo en Reddit, y la respuesta siempre es más o menos tocar Logseq u Obsidian durante medio día y memorizar la sintaxis
Ambos, en su estado por defecto, son bastante malos, y si la solución es pasar horas ajustándolos, no es una solución real; es más bien un parche
Para que pueda llamarse una herramienta, ese parche no debería ser necesario
Si solo necesitas una GUI para archivos de texto simples, no hace falta ajustar nada, instalar plugins ni aprender una sintaxis nueva
Eso sí, no es open source
Conviene no dejarse engañar ni intimidar por las comunidades de “porno de productividad” que presumen configuraciones elaboradas y flujos de trabajo irreales
Mi regla es esta: si alguien llama a Obsidian un “second brain”, es parte de un culto y puedes ignorarlo
Aun así, recomiendo mucho la app open source definitiva y sin configuración: papel y pluma. Además tiene una excelente retroalimentación táctil
Por ejemplo, en Obsidian puedes quitar todos los plugins salvo Daily Note y simplemente escribir
Puedes ignorar toda la sintaxis salvo quizá las viñetas, e ignorar propiedades, enlaces, seguimiento de hábitos, trucos de bases de datos y el grafo
O también puedes configurar Vim/Neovim para abrir el
journal/YYYY-MM-DD.txtde hoy con un atajo de líderEn mi trabajo actual tengo un documento continuo, y cada día creo una entrada nueva al principio; antes de intentar algo, registro qué voy a hacer y qué avance hubo ese día
Lo útil es que mis colegas y mi jefe pueden encontrar y leer ese documento
A mí también me resulta muy útil, pero además ayuda a que los demás puedan ver en qué estoy sin tener que estarme molestando
grep