Olá Zora! (ou como enfrento o caos, e o TDAH, diariamente)

Apresentada na Python Brasil 2026
Tenho mais chapéus do que é saudável a uma pessoa só: executivo de uma consultoria pequena, dev sênior em uma empresa internacional, voluntário e líder de uma comunidade open source, filho, pai, marido e com diversos boletos para pagar.
Cada papel tem seu vocabulário, prazos, urgências e seu próprio modo de me consumir. Some a isso TDAH, os diversos interesses e hobbies, e o resultado é caótico.

Nessa apresentação eu conto como cheguei num workflow que parece funcionar pra mim:

- Notas em markdown como ponto de partida — uma forma de externalizar memória de trabalho e ancorar contexto entre janelas de atenção que duram pouco.
- Um agente de IA pra programação como catalisador: processos informais que eu carregava na cabeça viraram Skills e subagentes reutilizáveis.
- Zora, um assistente pessoal construído em cima disso, que cuida das tarefas chatas e repetitivas — documentar código, contabilizar horas, gerar relatórios, organizar burocracia — me deixando livre pra explorar as muitas ideias novas que aparecem no caminho.

Não é tutorial nem manifesto. É um relato pessoal, honesto, com o que custou caro descobrir, o que ainda não funciona, e por que essa é a MINHA solução — provavelmente não a sua, mas talvez possa ser a semente da sua automação

Transcript

1. > zora start-presentation --event pythonbrasil-2026 Olá Zora! ou como enfrento o caos, e o TDAH, diariamente Érico Andrei Python Brasil 2026 - Florianópolis - SC - 2026-10-16 NCC-1031
2. PYTHON BRASIL 2026 Alinhando expectativas O que esta palestra não é 0 1 Não é um tutorial. Não tem repositório para clonar nem passo a passo para reproduzir. 0 2 Não é propaganda. Cito ferramentas, mas a tese é sobre princípios, não sobre "use X". 0 Não é "IA resolve tudo". O tom é pragmático e sinceramente 3 fala mais sobre meu TDAH do que sobre a tecnologia 0 4 Não é receita universal. Acredito, fortemente, que cada pessoa tem seu próprio jeito de se organizar. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
3. PYTHON BRASIL 2026 Para quem é esta conversa Levante a mão se você…  …é dev (de qualquer nível) e tem curiosidade sobre agentes em fluxos pessoais.   …é neurodivergente e quer adaptar as ferramentas ao seu jeito, não o contrário.  …acumula papéis profissionais em conflito e sente o custo de trocar de chapéu. …já testou várias soluções de produtividade e abandonou todas. Qualquer uma abandonada conta. Pré-requisitos: terminal, markdown, algum uso de assistentes de IA. Nada de internals de LLM. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
4. PYTHON BRASIL 2026 O cenário · Chapéu 1 de n Família  Filho, pai, marido. O chapéu que não tem sprint, não tem issue tracker e não aceita "depois eu documento". Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
5. PYTHON BRASIL 2026 O cenário · Chapéu 2 de n Trabalho  Simples Consultoria CxO, DevOps, dev, instrutor. kitconcept dev sênior, DevOps. Duas empresas, vários fusos, vários fluxos, dois vocabulários — e o mesmo teclado. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
6. PYTHON BRASIL 2026 O cenário · Chapéu 3 de n Comunidade  Plone coisas demais. Brasil PloneGov-BR, Python Brasil. O chapéu que ninguém paga e que, por isso mesmo, é fácil deixar escapar. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
7. PYTHON BRASIL 2026 O cenário · Chapéu 4 de n Todo o resto  Star Trek, retrocomputação (MSX), Juventus, basquete, programação criativa. Cada papel tem o próprio vocabulário, os próprios prazos e as próprias ansiedades. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
8. O problema E um pouco de tempero: TDAH Memória de trabalho vaza Trocar de contexto custa caro O que não está escrito em algum lugar confiável simplesmente some. Cada chapéu novo é um reboot mental — e são muitos reboots por dia. Trello Pomodoro GTD E-mails Calendários Bullet journal Todos falharam pelo mesmo motivo: exigiam que eu fosse organizado. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
9. > zora history --since 2023 Do zero até agora: Uma evolução, não um plano 2023 2026-03 2026-03-25 2026-04 2026-05 Notas em Markdown no Obsidian Claude Code; config no git Nasce o pacote zora Sessões, Menu bar e reuniões, log de memórias horas Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br 2026-07 2026-09 Issues e PRs em Config, Nix, qualquer forge Linux 2026-10 A Zora trabalha sozinha às 5h
10. PYTHON BRASIL 2026 2023 · A fundação Notas em Markdown com Obsidian     Simples o bastante para eu não abandonar depois de duas semanas — já são 3 anos. Aos poucos, organizando as coisas em pastas. Dropbox para sincronizar (na prática, backup). Uma memória de trabalho que eu consigo externalizar e confiar. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
11. PYTHON BRASIL 2026 Março de 2026 · O agente Claude Code como agente de programação     Em uso para código desde o Bucharest Sprint Uma estrutura no vault do Obsidian para cada codebase. Processos informais que eu carregava na cabeça viraram skills, subagentes e arquivos versionados. Workflows que não moravam em lugar nenhum agora são grep-áveis. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
12. PYTHON BRASIL 2026 22 de março de 2026 · O desvio Configuração versionada no git repositório make install /commit-claude-config agentes · comandos · skills · CLAUDE.md Makefile reconstrói tudo Cada codebase cuida do seu CLAUDE.md Tudo o que define como eu trabalho com o agente, em um único repo.  Troca o conteúdo de ~/.claude por symlinks para o repo. Máquina nova? Um comando. Uma skill força os outros projetos a commitar as próprias mudanças de configuração. Já fiz isso para outras coisas antes — tentei Nix, Ansible. O objetivo é um só: ser repetível. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
13. 25 de março de 2026 · A assistente Zora Uma assistente pessoal em Python + Typer (e muitos pacotes do PyPI), construída em cima das notas e do agente.  Batizada em homenagem ao computador da Discovery — referência a Star Trek (vem mais por aí).  Depende fortemente do meu jeito de documentar as coisas.  Me libera para correr atrás da próxima coisa interessante. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br  E, claro, tem uma "GUI" de verdade no macOS.
14. PYTHON BRASIL 2026 Como a Zora é feita Quatro regras de design Uma CLI em Typer que fica entre o Claude Code e todo o resto: o timer de sessões, o vault, GitHub e GitLab, Google Calendar. O Claude faz uma chamada zora <comando> e recebe JSON estruturado de volta. JSON para agentes, Rich para humanos Erros são dados Se stdout não é um TTY, sai JSON. No terminal, tabelas, painéis e links clicáveis para as notas. Uma falha devolve {"status": "error", "message": …}, não um traceback. O agente consegue lidar com isso. Uma chamada, tudo o que precisa O vault é a fonte da verdade zora session start devolve a nota da sessão, a sessão anterior, a config, o estado do git e as memórias do codebase em um só payload. Metadados de cada codebase vivem na nota Overview, no Obsidian. O CLAUDE.local.md do repo é um symlink para o vault: sobrevive a re-clone e máquina nova. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
15. PYTHON BRASIL 2026 Sete meses depois Zora em números 269 19,9 mil 1.243 ~100 commits desde 22 de março linhas de Python testes, em 46 arquivos comandos, em 17 grupos 122 1.160 1.508 h 212 codebases no vault sessões de código registradas de tempo ativo medido dias com pelo menos uma sessão Números do repositório e do log de sessões em 13/10/2026. O log começa antes da Zora porque sessões antigas foram importadas. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
16. PYTHON BRASIL 2026 Mês a mês Nada disso foi planejado mar · 2026 abr mai · jun jul Nasce o pacote zora Sessões e reuniões Menu bar e memórias Issues em qualquer forge Um repo para versionar a config do Claude Code; três dias depois, a CLI. Saída JSON ou Rich conforme o TTY. pause/resume/break, notas de reunião, zora day e o log de sessões em JSONL + SQLite. App na barra do macOS, consolidação de memórias, e a config dos codebases muda para o vault. zora issue sobre GitHub e GitLab, identidades git, contatos e snapshots de recuperação. ago set out PRs e os primeiros passos fora do macOS Config, Nix e renomes Relatórios agendados ~/.zora/config.json, um flake Nix, e a Zora instalada no servidor de casa. zora report, notas diárias preparadas com antecedência, e o servidor roda tudo às 5h. zora pr, timers systemd, imagem Docker para os testes no Linux. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br Cada mês resolveu a dor do mês anterior. Nenhuma feature veio de um roadmap.
17. PYTHON BRASIL 2026 Delegando a agentes O que a Zora tira da minha frente    Issues e PRs Contagem de horas Relatórios Criar issues, comentar em issues, abrir PRs — no GitHub ou no GitLab, sem eu lembrar qual. As sessões do dia viram horas por cliente e projeto. Eu não preciso lembrar. Do dia, da sessão, da semana — para mim, para o time, para o cliente. Regra: só delego o que é repetitivo e que eu consigo conferir depois. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br  Documentação de código Cada sessão de código termina com uma nota no vault, sem eu escrever.
18. PYTHON BRASIL 2026 A ideia mais interessante O ciclo de melhoria 1 · /session-end 2 · memórias Revisão kaizen Lições viram memórias A sessão termina com uma revisão: ferramenta mal usada, documentação faltando, contradições. Cada codebase guarda o que aprendeu com os próprios erros. 3 · /consolidatememories 4 · próxima sessão Em todos os codebases O que se repete sobe Um agente lê todas as memórias e propõe: regra global, skill, ou descartar. Eu aprovo. Uma lição aprendida em um projeto chega a todos os outros 121. 4 agentes 13 slash commands 15 skills codebase-init, obsidian-scribe, memoryconsolidator, codebase-doctor /session-start, /session-end, /meetingcreate, /doctor-codebases… zora, kaizen, plonista, pytest, py5, gh, glab, towncrier, social-media-marketer… Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
19. $ zora a ferramenta Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
20. $ zora meeting create a ponte entre calendários e Obsidian Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
21. $ zora day sessions as sessões de trabalho do dia Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
22. $ zora codebase info · set-identity tudo o que a Zora sabe sobre um codebase Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
23. $ zora session report o relatório de uma ou mais sessões Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
24. relatório de sessão de código a nota de sessão no vault do Obsidian Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
25. PYTHON BRASIL 2026 O que a contagem de horas me mostrou Para onde foram 1.508 horas Horas de sessão ativa por mês 247 236 144 Por chapéu 139 249 148 105 mar* abr mai jun jul ago Plone (core, add-ons, comunidade) 42% Simples Consultoria 21% Pessoal 20% kitconcept 17% 241 set out* Em outubro, 45 codebases diferentes em menos de duas semanas — mais do que qualquer mês inteiro antes. * mês parcial. Minutos contados por sessão: sessões em codebases diferentes rodam em paralelo, então um dia pode somar mais do que o relógio. Fonte: Sessions.jsonl, 13/10/2026. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
26. PYTHON BRASIL 2026 12 de outubro de 2026 · A feature mais recente Às 5h da manhã, a Zora trabalha sozinha javari é uma caixinha sempre ligada em casa, rodando NixOS. Um timer do systemd dispara todo dia às 05:00 e roda: zora day prepare --days 7 cria as notas diárias de hoje e dos próximos seis dias, sem sobrescrever nenhuma. zora report --date … dia, mês e ano, de hoje e de ontem. É o "ontem" que fecha o mês no dia 1º. Quando eu acordo, a nota do dia e os relatórios já estão no Obsidian. Ninguém abriu um terminal. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br Por que é seguro      Um único escritor. O vault sincroniza via Dropbox; só o javari agenda esses jobs, o Mac nunca. Zero cópias conflitantes. Sem credenciais. Nada de Claude, gh, glab ou Google: só arquivos do vault e um cache SQLite local. Idempotente. Só as tabelas e propriedades da própria Zora são reescritas; texto escrito à mão sobrevive. Pula, não falha. Se o disco cifrado com o vault não está montado, o run é pulado. Declarativo. Pacote Nix construído do flake, com a suíte de testes; o timer é um módulo NixOS.
27. > zora demo --live --where hallway-track Não é teoria. Me procure durante o evento e eu mostro, ao vivo, como o meu workflow funciona. O que dá para ver em cinco minutos zora day uma sessão de código, do início ao fim zora issue mine  o seu caso — traga o seu caos Vou estar por aí nos corredores — ou me chame: @ericof · @ericof.com · @ericof@pynews.com.br
28. Análise crítica O que não funciona (ainda) falha 01 Só funciona se eu documentar A Zora depende das minhas notas. Semana sem notas = assistente cega. [exemplo real] falha 02 Manutenção constante Skills reescritas toda semana. Modelos mudam, ferramentas mudam, eu mudo. [exemplo real] falha 03 Confiança demais Relatório bonito não é relatório certo. Quando eu parei de conferir, [o que aconteceu]. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br Instrução não foi clara o bastante, ele se recusou a até mesmo commitar.
29. ALERTA VERMELHO Análise crítica Os limites da automação pessoal O que eu ganho O que eu pago Onde traço a linha Memória de trabalho externa e confiável Disciplina diária de escrever Nada entra na Zora que não esteja escrito Menos custo para trocar de chapéu Tempo cuidando do sistema em vez do trabalho Se cuidar custa mais do que fazer, a peça morre Burocracia some da minha frente Risco de aceitar erro sem olhar Tudo que sai para outra pessoa, eu leio antes Diversão em tarefas chatas Custo financeiro e dependência de serviço [seu limite aqui] Automação pessoal não remove o trabalho. Ela troca o tipo de trabalho — e a troca tem que valer para você. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
30. PYTHON BRASIL 2026 A tese Por que isso funciona 01 02 03 Não é porque a tecnologia é boa Eu construí para mim Cada peça é descartável E eu gosto de me divertir fazendo coisas chatas. Isso sustenta o hábito. Skills são reescritas toda semana. Subagente que não paga o aluguel é despejado. A tecnologia é ok. Ela não é o protagonista desta história. O sistema se dobra ao meu caos, em vez de me pedir para me dobrar à ordem dele. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
31.  Permissão para construir o seu Não estou vendendo a Zora — você não consegue usá-la. Ela serve a uma pessoa. Muita gente nesta sala já sabe que sistemas "tamanho único" não servem. As ferramentas estão baratas. A parte difícil é admitir o que você realmente precisa.
32. PYTHON BRASIL 2026 Referências Para continuar a conversa Obsidian Claude Code obsidian.md docs.claude.com/en/docs/claude-code Typer Plone · PloneGov-BR typer.tiangolo.com plone.org · plonegov.org.br Zora, computador da USS Discovery memory-alpha.fandom.com/wiki/Zora Érico Andrei · Simples Consultoria · kitconcept Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br
33. > zora end-transmission "Zora, encerrar transmissão." Obrigado. As melhores conversas acontecem no corredor. Érico Andrei - @ericof - @ericof.com - @ericof@pynews.com.br