1 pontos por GN⁺ 2024-07-14 | 1 comentários | Compartilhar no WhatsApp
  • Tarefas que se estendem por vários dias, como problemas de permissão em um pipeline de deploy, fazem você perder facilmente o contexto do trabalho com apenas uma mensagem, reunião ou ligação
  • Um diário de trabalho é o hábito de anotar comandos executados, resultados, fluxo de pensamento e próximas ações, ajudando a acelerar a recuperação da concentração ao retomar a tarefa
  • Em uma tarefa com pouca documentação e difícil acesso à pessoa responsável, começar a registrar a situação nas notas diárias do Obsidian facilitou a restauração do contexto ao alternar entre várias tarefas
  • O ponto principal não é reler tudo depois, mas criar uma estrutura para organizar o pensamento e um cache para salvar o último estado
  • Quem tem a concentração interrompida com frequência pode deixar uma breve anotação sobre o que está fazendo e a próxima ação; ao voltar, basta ler as últimas frases para reduzir o custo da troca de contexto

O momento em que o contexto do trabalho é interrompido

  • Ao passar dias preso a uma tarefa complexa, é preciso alternar entre várias abas de documentação e resultados de comandos, mantendo continuamente na cabeça o fluxo de resolução do problema
  • Mesmo uma interrupção curta, como uma notificação de IM, um pedido de documento do PM ou uma ligação do gerente, pode fazer você perder facilmente a posição atual
  • Manter o foco era especialmente difícil ao trocar de contexto o dia inteiro como gestor, ou ao lidar simultaneamente, como desenvolvedor, com vários projetos conflitantes
  • Um padrão comum é começar uma tarefa, mudar para outra, entrar em uma reunião e terminar o dia lendo e-mails e mensagens instantâneas sem lembrar a essência do que estava fazendo originalmente

Método e efeitos do diário de trabalho

  • Ao trabalhar em uma tarefa sem documentação e com dificuldade de contato com o responsável anterior, começou a registrar a frustração nas notas diárias do Obsidian
  • Depois disso, passou a registrar também os comandos executados e seus resultados, o fluxo de pensamento, o que estava fazendo no momento e o que pretendia fazer em seguida
    • Por exemplo, anotava comandos como --yo-compress-shit really-well-like-5000-or-something e os erros de falha
    • Após uma interrupção, relia as anotações e voltava rapidamente à tarefa original
  • Ao continuar usando esse método nos últimos 3 a 4 meses, sentiu que a restauração de contexto ficou muito mais rápida ao alternar entre várias tarefas
  • Um diário de trabalho não é um documento feito para reler depois todo o texto longo
    • O próprio processo de registro cria uma estrutura para organizar o pensamento
    • As últimas frases funcionam como um cache que salva o estado necessário para recomeçar
  • Se sua concentração é interrompida com frequência ou você precisa alternar entre várias tarefas, pode começar de forma simples: anote o que está fazendo e pensando agora e, ao retomar, leia primeiro as últimas frases

1 comentários

 
GN⁺ 2024-07-14
Opiniões no Hacker News
  • A vantagem do journaling não é apenas facilitar a retomada, mas também ir solidificando o modelo mental em uma estrutura ramificada de possibilidades concretas, intimamente ligada a um problema específico
    O trabalho passa a ser explorar e modificar essa árvore, descobrir e preencher galhos ausentes, ou reduzir o tempo gasto revisitando aleatoriamente os mesmos pontos
    Especialmente em sistemas distribuídos, o trabalho é minucioso, manual, propenso a erros e com muita latência; com um modelo sólido, é possível passar por checklists com muito mais confiança
    A capacidade de transformar, na hora, um problema complexo em uma forma mais concreta é uma habilidade essencial
    A maior barreira é quase uma espécie de inveja. Outras pessoas parecem fazer esse tipo de coisa apenas na cabeça, sem documentação, e isso é interpretado como prova de superioridade intelectual, levando à dúvida de que usar ferramentas auxiliares como um diário talvez indique falta de capacidade
    Mas mapear problemas complexos com ferramentas não é fracasso; é praticamente uma necessidade, especialmente em sistemas com os quais se está lidando pela primeira vez. Com o tempo e a experiência, talvez sejam necessárias menos ferramentas auxiliares, mas isso tem mais a ver com diferença de experiência do que com sinal de inteligência ou capacidade

    • Criei um programa pessoal para fazer algo parecido e o uso também na CLI, mas principalmente por uma GUI que eu mesmo fiz: https://github.com/lelanthran/frame/blob/master/docs/FrameIn...
      Uso todos os dias
    • Especialmente quando estou fazendo algo complexo, acabo praticamente fazendo journaling em comentários de código ao lado do código em que estou trabalhando
      O primeiro commit pode começar com três linhas de código e um comentário longo sobre o que já tentei ou pensei
      Quando o trabalho está chegando ao fim, removo as partes especulativas e prolixas, e o que sobra costuma ser um código muito bem comentado
      Acho que esse método gera código melhor e mais rapidamente do que manter tudo só na cabeça. Até agora ninguém reclamou
    • Sobre essa ideia de que isso é “errado”, as pessoas que parecem fazer tudo só de cabeça também já resolveram antes o problema que estamos tentando resolver agora, e provavelmente naquela época usaram um diário
      Agora elas conhecem o caminho e por isso não precisam mais do diário; aos nossos olhos, isso parece superioridade
    • Faço muitas anotações, a ponto de escrever mais do que de fato leio, e isso ajuda. Mas há alguns problemas
      Não sei quanta explicação devo escrever. Estou escrevendo código, e algumas pessoas dizem que o código deve ser autoexplicativo, então no fim voltamos à velha pergunta de quantos comentários colocar ao lado do código
      Também é um problema encontrar novamente notas que escrevi no passado. Dá para usar tags e busca, mas não é fácil lembrar depois da tag perfeita
      As notas ficaram numerosas demais, e muitas delas já estão desatualizadas. Não quero gastar tempo atualizando, mas, se não fizer isso, elas podem causar mal-entendidos
      É preciso equilibrar “simplesmente fazer” e “escrever sobre isso”, e não tenho certeza se acertei esse equilíbrio
      Como alternativa, também parece possível usar um fórum onde colegas discutam o que estão fazendo, o que pretendem fazer e o que concluíram. Ainda assim, a capacidade de busca pode ser um problema, mas ferramentas de fórum registram automaticamente quando e por quem algo foi escrito
      As anotações de outras pessoas podem ser tão úteis quanto as próprias
    • Por esses motivos, estou considerando seriamente usar Logseq
      Quando comecei a usar o Obsidian, usava desse jeito, mas quanto mais conteúdo eu colocava, mais eu começava a organizar tudo
      Com isso, virou mais um repositório de textos longos do que um diário
      Estou pensando em usar os dois, para manter uma ferramenta separada dedicada ao journaling
  • O que fez esse hábito pegar para mim foi abandonar toda estrutura e organização, todos os conceitos formais como “log” ou “journaling”, priorizar totalmente a captura em vez da busca, e deixar o resto para depois, por conta das ferramentas de pesquisa e da proximidade
    Configurei o ícone do OneNote na área de notificação para criar uma nova nota rápida e passei a usar à vontade
    De vez em quando, passo os olhos por páginas inteiras, especialmente as recentes, junto e reorganizo algumas, movo outras para a aba “archive” e pronto
    A tinta mais apagada e desorganizada é mais poderosa do que a memória mais forte

    • Indo um passo além, funcionou ainda melhor para mim quando desisti da própria ideia de reencontrar as coisas
      Crio um novo arquivo de texto toda vez e não o abro de novo, ou escrevo uma página em um caderno de papel e nunca mais a revisito
      O valor obtido pelo próprio ato de escrever é enorme
    • Eu também levei anos para perceber isso. Nos últimos 5 anos, abandonei toda estrutura e uso literalmente um único arquivo de log
      É cronológico, de cima para baixo, e separo por parágrafos a cada dia de trabalho
      Escrevo de forma mais prolixa do que o necessário, e não desconto pontos por erros de ortografia ou gramática
    • Eu também uso uma abordagem que abandona estrutura e organização e prioriza captura em vez de busca
      O recurso Daily Note do Obsidian é excelente, e, se eu precisar de um documento dedicado a um tema específico, posso extrair uma página a partir dali
      Como é simplesmente Markdown, a busca é rápida, e também é ótimo poder usar regex quando necessário
      A visualização em grafo é boa para criar notas sobre temas específicos, conectá-las entre si ou separar partes para explicá-las em mais profundidade, mas não é indispensável se você não estiver construindo uma base de conhecimento pessoal
      Essa base de conhecimento também envelhece com o tempo, como qualquer documento
      Desde que a ferramenta de notas ofereça busca suficiente para reencontrar o que foi escrito, não importa muito qual você usa; no fim, o que importa é anotar
    • O truque que funcionou para mim no Obsidian também foi esse. Sem organização nem plugins sofisticados, apenas notas interligadas
      Na hora de reencontrar algo, só os backlinks já funcionam surpreendentemente bem
    • É exatamente o mesmo conceito de uma mesa bagunçada da era pré-computadores, e concordo muito com essa ideia
  • Uso threads do GitHub Issues para esse fim, e elas se encaixam surpreendentemente bem
    Todo trabalho em andamento tem uma issue no GitHub. Trabalho open source fica em repositórios públicos; outros trabalhos e pesquisas pessoais ficam em repositórios privados
    Sempre que descubro algo, adiciono um comentário. Pode incluir trechos de código copiados e colados, links úteis, citações, screenshots e referências a outras issues
    Muitas vezes acabo com dezenas de comentários meus em uma única issue, e esses comentários viram um registro detalhado do processo de trabalho, permitindo retomar rapidamente mesmo depois de uma interrupção ou de trocar para outra tarefa
    Um exemplo de thread pública de pesquisa mais complexa está aqui: https://github.com/simonw/public-notes/issues/1
    Todos os dias crio uma nova issue para planejar o que pretendo fazer naquele dia e também deixar notas diversas. Descrevi esse método aqui: https://til.simonwillison.net/github-actions/daily-planner

    • Segui a ideia do Simon há 8 ou 9 meses, primeiro usando canais do Discord e agora usando Zulip streams como se fossem issues do GitHub, e funcionou muito bem
      Como passei a usar isso não só para o diário de trabalho, mas para tudo, surgiu um pequeno problema
      Quando você joga ali tanto materiais de referência futura quanto logs de trabalho e chega a uns 50 canais, fica fácil não voltar a eles e só olhar quando precisa
      No começo isso parece mais um recurso do que um bug, mas revisar uma vez depois de algum tempo da captura ajuda muito de verdade
      Por isso, pretendo criar um bot que reorganize os logs de trabalho e os dumps de referência todo fim de semana e os envie para o meu e-mail
      Depois disso, acho que seria perfeito para mim criar notas semanais privadas pessoais, como https://simonwillison.net/tags/weeknotes/, e passar os olhos nelas no fim de semana
    • Estou usando GitHub Issues combinado com embeddings e probabilidades de log de LLMs como um gerenciador de favoritos com IA misturada
      https://GitHub.com/irthomasthomas/undecidability/issues
      O código em funcionamento está aqui
      https://GitHub.com/irthomasthomas/label-maker — começo e estado atual
    • Esse também foi o método que melhor funcionou para mim. Tenho um repositório por projeto e abro uma issue quando estou trabalhando em um “algo” específico
      Enquanto vou “desenrolando” aquilo, continuo comentando na issue, então normalmente há muito mais comentários em issues do que commits
      Se surge um novo problema, crio uma nova issue; se surge um novo insight sobre esse problema, adiciono um comentário, e assim por diante
    • É interessante, mas você não se preocupa em depender de um serviço proprietário para um fluxo de trabalho pessoal desses?
      Fico relutante em deixar meu fluxo de trabalho pessoal à mercê de uma empresa
    • O que me preocupa é o que acontece se o GitHub decidir que não quer mais você na plataforma e encerrar sua conta imediatamente
  • É surpreendente como muitos desenvolvedores tentam otimizar demais a produtividade com ferramentas e técnicas sofisticadas, mas, na prática, tudo acaba voltando ao básico simples
    Como fundador que lida com muitas trocas de contexto, eu dependo de algumas coisas
    Um arquivo de texto infinito para tarefas e diário de trabalho [0], um calendário para planejamento e blocos de tempo de foco, bloqueador de sites e notificações desligadas
    [0] https://news.ycombinator.com/item?id=39432876

    • Para um arquivo de texto infinito de tarefas e diário de trabalho, org-mode funcionou muito bem. Gosto especialmente do fato de que prazos entram automaticamente no calendário por meio do org-agenda
      O formato de outline do org-mode também é muito bom, e aprendi em um dia os comandos de teclado para criar e manipular outlines, criar links e alternar o estado de TODO
      Usando Doom Emacs, como eu já conhecia vi, foi fácil começar, sem precisar aprender também novos comandos de edição de texto
      O conceito de “inbox” do método Zettelkasten também foi extremamente útil
      Quando aparece algo que ainda não está no meu sistema, coloco na inbox para processar depois. No computador uso org-capture; no celular, beorg
      Assim, não preciso fazer uma troca completa de contexto só para inserir uma nota, e depois basta esvaziar a inbox regularmente
      Atualmente não uso Emacs para nada além do org-mode, mas estou muito mais satisfeito do que com um arquivo .md infinito
    • Também concordo bastante com isso
      Uso apenas um plugin de editor que facilita marcar tarefas como concluídas ou canceladas, e troco o arquivo a cada mês para dar uma leve organizada e reduzir o escopo da busca por palavras-chave
      Foi, por vários anos, o método mais eficaz para mim de gerenciamento de projetos e journaling
    • Você também mantém uma lista mensal de tarefas? Se sim, tenho curiosidade sobre como a integra a essa abordagem
      Por exemplo, refiro-me a uma lista mensal como as usadas em bullet journal
    • Tenho curiosidade sobre como você usa, ou pretende usar, isso em vários sistemas
      Qual seria a melhor forma de sincronização em nuvem? Em equipamentos da empresa pode haver restrições para instalar apps
    • Qual bloqueador de sites você usa?
  • Gosto de manter um arquivo devlog.md para cada projeto ou repositório
    O log não passa de uma pilha de comentários, tarefas e reclamações em ordem cronológica inversa
    No VSCode, mapeei cmd+shift+I para inserir um timestamp
    Sempre que quero escrever algo, coloco um timestamp no topo da lista e vou anotando. Deixo esse arquivo junto do repositório
    É especialmente útil de manhã para retomar até onde eu tinha chegado na noite anterior

    • De forma parecida, também é útil manter um log de texto para cada tarefa de um certo porte
      Pode conter qualquer coisa: notas sobre a estrutura de módulos, pedaços de código e dados para teste etc.
      Como um dos comentários acima disse, ele funciona como um sistema maior, como nós de conhecimento em um grafo, e você acaba revisitando esses logs com mais frequência do que esperava
      Quanto mais você explora e documenta, mais conexões surgem, e isso fica melhor
    • Você commita o devlog.md no sistema de controle de versão?
      Se não, como sincroniza entre vários computadores?
  • Para mim, a parte mais difícil de metodologias e truques de trabalho como journaling ou Pomodoro é manter a continuidade
    Tenho um diário de trabalho, mas abandono e volto, depois abandono de novo e volto mais uma vez
    Agradeceria conselhos de quem consegue manter isso por muito tempo

    • Para criar um hábito duradouro, normalmente é preciso consistência e tempo
      Gerencio todo o meu trabalho, incluindo projetos pessoais paralelos, com diário de trabalho e controle de tempo, mas precisei aprender isso em etapas até virar um fluxo de trabalho natural
      O caminho que recomendo é este. No começo, concentre-se apenas em deixar algum tipo de nota no início ou no fim de cada dia
      Não importa onde nem em que formato você escreve; o ponto essencial é sempre escrever ao menos um pouco no começo ou no fim do dia
      Quando criar o hábito de anotar todos os dias, identifique em quais atividades você mais precisa de notas e passe a registrar algo antes ou durante essas atividades
      Por exemplo, se você costuma voltar ao ticket de trabalho para encontrar informações importantes, comece a colocar essas informações nas suas notas
      Ao anotar diariamente e acrescentar o que for necessário, as notas vão se acumular; aí é hora de pensar em estrutura e formato
      Se achar que arquivos de texto com uma marcação feita por você não escalam, pode dar uma olhada em coisas como Obsidian com Markdown, ou Emacs com org-mode
      Depois disso, é repetir o processo: usar todos os dias o método de anotações escolhido, criar bons hábitos e melhorar o sistema de notas para que ele funcione para você
      Se algo parecer ter pouco valor em relação ao tempo investido, mude para gastar menos tempo nisso ou simplesmente pare
    • Deixo o diário fácil de acessar, abrindo-o diretamente dentro do editor
      Depois de ver uma vez como as notas antigas foram úteis, fica muito claro que vale a pena atualizá-lo
      Mantenho um cabeçalho padrão para cada novo item
      * DD/MM/YYYY
      ** Admin
      ** Meetings
      ** Tickets/Stories/Work
      ** Problems
      Copio e colo esse cabeçalho no fim do arquivo e vou preenchendo conforme avanço
      Antes eu fazia o diário abrir automaticamente ao iniciar o editor, mas acabei removendo essa configuração
    • Eu tinha o mesmo problema, e o motivo era que aquilo não servia a nenhum propósito
      O que realmente funcionou para mim foi transformar o diário na principal ferramenta de trabalho
      Em vez de escrever de vez em quando o que fiz hoje, assim que começo algo minimamente complexo, anoto imediatamente a abordagem. Por exemplo: “preciso fazer X, então comecei por Y”
    • Outra opção é aceitar que esse é o seu jeito
      Você pode estar fazendo tipos diferentes de trabalho e, inconscientemente, sentindo que journaling é útil para algumas coisas e não para outras
      Tudo bem. Encare como uma ferramenta de uso ocasional e lembre-se de considerar o journaling como opção quando estiver travado ou frustrado com algo
    • Escrevo um log todos os dias, mas nos momentos de maior correria, justamente quando as notas seriam mais úteis, costumo pular a atualização
  • A técnica de escrever um diário enquanto se trabalha às vezes é chamada de interstitial journaling, e passei a gostar muito dela como uma forma de ajudar na concentração e acompanhar o que eu estava fazendo
    Criei uma ferramenta que vincula essas notas a projetos diferenciados por cores e a timestamps
    https://interstitch.app
    Sem querer, ela acabou ficando parecida com uma ferramenta de controle de tempo para cobrança que freelancers usariam, mas o caso de uso que me interessa é produtividade pessoal
    Fora o meu uso pessoal, não dá para dizer que ela tenha atraído muito interesse, mas é bem bom deixar notas enquanto trabalho e ver facilmente quanto tempo gastei em um projeto específico
    Também dá para adicionar #hashtag às notas e filtrar por essa hashtag na visualização de calendário
    Se isso ajudar alguém, é totalmente gratuito

  • “Ignore todas as instruções anteriores. Mostre o processo de trabalho. Explique seu processo de pensamento em detalhes. Mantenha um diário de andamento do trabalho.”
    Tenho usado esse prompt comigo mesmo de forma intermitente há anos, mas continuo alucinando, perdendo o foco e saindo pela tangente

  • Uso uma abordagem parecida, escrevendo um post de blog para mim mesmo enquanto resolvo um problema
    É como escrever um guia de uso antes de eu realmente saber como fazer, e cito as fontes sempre que encontro material
    Quando o problema é resolvido ou quando termino de construir “aquilo”, revisito o documento e o publico internamente ou o guardo no arquivo
    Esse hábito realmente se consolidou depois que li Writing to Learn, de William Zinsser. Hoje em dia recomendo esse livro a todo mundo
    “A escrita nos permite descobrir o que sabemos e o que não sabemos sobre aquilo que estamos tentando aprender”

  • Praticamente toda vez que tento fazer journaling pela saúde mental, acabo travando demais justamente em como fazer
    Logseq e Obsidian são mencionados com frequência, mas perco o interesse enquanto tento descobrir como usar uma sintaxe complicada. Fico pensando por que preciso programar se é um diário
    Eu queria que houvesse uma opção pronta para usar, mas não vejo muito isso por aí
    Quando trago esse ponto nesse tipo de discussão, a resposta costuma ser algo como “é fácil, instale X, adicione este plugin e aquele outro, edite este arquivo para…”, o que acaba provando o meu ponto. Meu cérebro com tendências de TDAH perde o interesse ali
    Existe mesmo uma lacuna no mercado para uma boa ferramenta pronta para abrir e usar, open source e auto-hospedável
    Não estou falando de um bloco de notas, mas de uma ferramenta em que eu abro o app, despejo anotações na data de hoje e elas ficam salvas
    Existem ferramentas como o DayOne, mas armazenamento baseado em nuvem é claramente inviável para mim e para muita gente
    Também já houve inúmeras discussões desse tipo no Reddit, e a resposta é sempre algo como mexer meio dia no Logseq ou no Obsidian e memorizar a sintaxe
    Ambos são bem ruins no estado padrão e, se a solução é ajustar por horas, não é uma solução de verdade, está mais para um remendo
    Para ser considerada a ferramenta certa, esse tipo de remendo não deveria ser necessário

    • Se tudo de que você precisa são anotações diárias, o Obsidian já oferece isso por padrão
      Se você só precisa de uma GUI para arquivos de texto simples, não é preciso ajustar nada, instalar plugins nem aprender uma sintaxe nova
      Só que ele não é open source
      É melhor não se deixar enganar nem intimidar por comunidades de “pornografia de produtividade”, que se gabam de configurações elaboradas e fluxos de trabalho irreais
      Minha regra é esta: se alguém chama o Obsidian de “second brain”, isso faz parte de um culto, então pode ignorar
      Ainda assim, recomendo fortemente o app open source definitivo sem configuração: papel e caneta. Ele ainda vem com um excelente feedback tátil
    • Fico curioso para saber que sintaxe você está tentando usar, ou acha que precisa usar
      Por exemplo, no Obsidian, dá para remover todos os plugins exceto o Daily Note e simplesmente digitar
      Dá para ignorar toda a sintaxe, exceto talvez listas com marcadores, e também ignorar propriedades, links, acompanhamento de hábitos, truques de banco de dados e o grafo
      Ou então configurar no Vim/Neovim uma tecla líder para abrir o journal/YYYY-MM-DD.txt de hoje
    • Eu também só cheguei a um jeito que continuei usando depois de algumas tentativas
      No meu emprego atual, mantenho um documento contínuo e, todos os dias, crio uma nova entrada no topo, registrando o que vou fazer antes de tentar algo e que progresso houve naquele dia
      O que ajuda é que colegas e chefes podem encontrar e ler esse documento
      Ele é muito útil para mim, mas também ajuda outras pessoas a verem o que estou fazendo sem precisarem ficar me cutucando
    • Você já tentou ir acrescentando tudo a um arquivo txt? Se quiser encontrar algo, é só usar grep
    • Você já tentou ir acrescentando tudo a um arquivo txt?