Seu agent de IA acabou de alterar 40 arquivos... e agora? (Whiteboard)

Autoria: Better Stack · Assistir no YouTube

Vídeo de autoria do canal indicado, não da IANIA; todos os direitos pertencem ao criador. Transcrição, resumo e tradução gerados automaticamente; o conteúdo no idioma original é preservado na versão em idioma original.

Idioma original: inglês

Vídeo original: Your AI Agent Just Changed 40 Files… Now What? (Whiteboard) · Canal: Better Stack · 07:42 · Assistir no YouTube

Tópicos: Agentes de IA, Engenharia de software com IA, Ferramentas de desenvolvimento com IA, Privacidade e proteção de dados

Resumo

Whiteboard é um app open source que ajuda a revisar mudanças feitas por agents de IA, criando diagramas conectados ao código. O vídeo demonstra como instalar e usar a ferramenta para visualizar o fluxo de uma mudança e acessar as funções relevantes. Também explica recursos como o registro de decisões e a busca pelo contexto das conversas que produziram o código. O apresentador alerta que diagramas ainda precisam ser conferidos no código e destaca opções de telemetria, privacidade e armazenamento de transcrições.

Pontos-chave

Whiteboard transforma mudanças feitas por um agent em diagramas interativos com links para o código correspondente.
A ferramenta busca reduzir a chamada dívida cognitiva: escrever código ficou mais barato, mas compreendê-lo ainda exige esforço.
O app pode apresentar diagramas de sequência, fluxos, diffs de pilha de chamadas e blocos de código estruturados.
Whiteboard funciona localmente e usa um agent compatível por meio de um plugin com MCP.
O registro de decisões reúne escolhas feitas pelo agent, enquanto trace archaeology busca explicar o código com base nas sessões que o produziram.
Diagramas são explicações que devem ser tratadas como alegações: é preciso clicar nos links e verificar o código.
A telemetria vem ativada por padrão; desativá-la impede o envio de relatórios de falha, segundo a documentação citada no vídeo.
O armazenamento hospedado de traces pode enviar transcrições completas do agent; recursos opcionais devem ser avaliados antes do uso.
O apresentador recomenda experimentar a ferramenta em branches grandes, mas considera desnecessária para diffs muito pequenos.

Capítulos

Início	Capítulo	Resumo
00:00	O problema da dívida cognitiva	O vídeo apresenta Whiteboard como uma forma de entender mudanças extensas feitas por agents sem depender apenas de diffs ou longas explicações em texto.
02:37	Como Whiteboard organiza a revisão	O apresentador explica os blocos conectados ao código, o visualizador de diff e as diferenças em relação a outras ferramentas e diagramas em Markdown.
04:38	Decisões, traces e verificação	O vídeo descreve o registro de decisões e a busca pelo contexto das sessões, ressalvando que diagramas precisam ser conferidos no código.
06:40	Privacidade, limitações e quando usar	O apresentador aborda opções de observabilidade, requisitos e limitações do app e recomenda usá-lo sobretudo em branches grandes.

Citações

Os agents tornaram barato escrever código. Mas não tornaram barato entendê-lo. — 00:00

Em vez de ler explicações em parágrafos, tenho um mapa e posso verificar aonde ele realmente leva. — 02:37

Um link facilita conferir uma explicação. Mas não a torna automaticamente verdadeira. — 05:09

Não avalio Whiteboard pela aparência do mapa, mas por me ajudar a entender o que estou prestes a integrar. — 07:42

Conceitos e entidades

Whiteboard (ferramenta): App open source apresentado no vídeo que cria diagramas de revisão conectados ao código.
cognitive debt (conceito): Esforço ainda necessário para compreender e revisar código, mesmo quando um agent torna sua produção mais barata.
MCP (conceito): Protocolo usado pelo plugin para conectar o agent ao servidor local do Whiteboard.
decision log (conceito): Registro das decisões que o agent tomou sem pedir confirmação.
trace archaeology (conceito): Recurso que permite perguntar por que um trecho de código existe e consultar as sessões do agent que o escreveram.
Claude Code (ferramenta): Um dos agents mencionados como compatíveis com Whiteboard.
Better Stack (empresa): Canal que publicou o vídeo e empresa citada como opção para observabilidade com OpenTelemetry.
Archify (ferramenta): Ferramenta mencionada como comparação, voltada a mapear um sistema, enquanto Whiteboard revisa mudanças.

Tradução completa (pt-BR)

00:00 Seu agent acabou de alterar 40 arquivos. Você está prestes a aprovar o pull request, mas conseguiria explicar o que ele fez? Espero que a maioria de nós revise o código, mas há uma maneira melhor de fazer isso. Este é o Whiteboard, um novo app open source que faz seu agent desenhar um mapa dessas alterações e criar links diretos para o código. Então, como isso funciona e onde se encaixa? Vamos descobrir. O verdadeiro problema que os criadores chamam de dívida cognitiva. Os agents tornaram barato escrever

00:32 código. Mas não tornaram barato entendê-lo. Ainda pagamos por essa parte em cada revisão. Abrimos o diff e encontramos testes, documentação e lógica misturados. Pedimos ao agent que explique, e agora estamos lendo um paredão de Markdown. Sim, claro. Tudo bem. Mas pode ser trabalhoso e demorado. Talvez só precisemos de algo simples: quem chama o quê. O que mudou no atalho para chegar à linha exata? Deixe-me mostrar. Se você gosta de ferramentas de programação que aceleram seu workflow, não se esqueça de se inscrever. Temos vídeos novos o tempo todo. Certo, chegamos aqui. Você baixa o

01:03 app para Mac, abre e clica em Conectar ao Claude. Ele instala uma CLI pequena e fornece dois comandos para adicionar ao plugin. Este aqui é o primeiro plugin, e este é o segundo. Ambos são do Whiteboard. Então, cole esses comandos no terminal. Recarregue o Claude Code, como fazemos com qualquer plugin novo. Pronto, agora está instalado. Deixe o app Whiteboard aberto. Esse é o servidor local com o qual o plugin se comunica. Antes de abrir um repo privado, desative a telemetria. Configurações. Desativar. Compartilhamento anônimo de dados de uso. Já volto a explicar o motivo daqui a pouco. Agora, em um repo de verdade, você pode fazer uma pergunta ao Claude. Vou enviar a pergunta aqui: “Revise minha branch atual em relação à main atualizada. Abra o resultado no Whiteboard. Percorra o fluxo da requisição como um diagrama de sequência e coloque o código relevante ao lado de cada etapa.” Agora vamos executar. Na tela, você pode manter a linha curta, se preferir.

01:33 Eu fiz uma mais longa. Se quiser dizer “Revise a branch em relação à main”, use o Whiteboard. Ele simplesmente identifica o Whiteboard, certo? Aprove as chamadas de ferramenta. Não aprove alterações. Esta revisão é somente para leitura. Agora observe a tela aqui. Um diagrama de sequência do fluxo da requisição aparece, junto com o código ao lado de cada etapa. Isso não é um bloco Mermaid no Claude. O Claude está criando uma revisão no servidor local do Whiteboard. Clico em uma etapa e ele me leva até essa função. Agora posso acompanhar a explicação e conferir o código sem ter que procurar pelos arquivos. Mude para o diff. Os testes e a documentação

02:04 ficam recolhidos. Funções grandes são resumidas como pseudocódigo. O que resta é a lógica que realmente mudou. Em vez de ler instruções em um parágrafo, tenho um mapa e posso verificar aonde ele realmente leva. Essa possibilidade de clicar e ir direto à função é essencial para tudo isso. O Whiteboard é um fork do VS Code Code OSS, executado no Electron. Nosso agent se comunica com ele por meio de um servidor MCP instalado como plugin do Claude Code. E o agent não desenha simplesmente o que quiser. Ele preenche blocos tipados,

02:37 diagramas de sequência, diagramas de fluxo, diffs de pilha de chamadas, prévias de código e até uma visualização de banco de dados. Pense em formulários, em vez de uma página em branco. Cada bloco tem uma estrutura definida e se conecta ao código real. O visualizador de diff tem seu próprio mecanismo, escrito em Rust. Ele lê a estrutura do código, a árvore sintática, não apenas as linhas de texto. É assim que ele separa tudo. Agora, se você assistiu ao vídeo que fiz recentemente sobre Archify, provavelmente está pensando: “Não acabei de falar disso?” Bem, mais ou menos, mas não exatamente. O Archify mapeia seu sistema. O Whiteboard revisa uma alteração. A equipe do Whiteboard começou com artefatos HTML, mas depois migrou para o VS Code, porque era difícil conectar diagramas ao código em HTML puro. Diagramas Mermaid são ótimos para documentação. Eles ficam no Markdown e no Git, mas você não consegue clicar em uma caixa e ir até uma função. E sim, o CodeRabbit ou o Graphite são bots na nuvem que comentam no seu pull request. O Whiteboard roda na sua máquina, usa seu próprio agent e não publica

03:07 nada no GitHub. Ele oferece suporte a Claude Code, Codex, Cursor, OpenCode, Pi, Oh My Pi e outras ferramentas. Tem licença MIT e é de uma empresa da turma de inverno de 2026 da YC. Mas entender o que mudou nos leva a outra pergunta: por que o agent escolheu fazer desse jeito? O Whiteboard tem um registro de decisões integrado, uma lista contínua das escolhas que o agent fez sem perguntar a você ou a mim. É o tipo de coisa que muitas vezes nunca chega à mensagem do commit. Depois, há o que eles chamam de arqueologia de rastros — não tem a ver com dinossauros. Certo, é sobre código. Aponte para um trecho de código e pergunte por que ele existe. A ideia é que ele responda usando as sessões do agent que o escreveram. Pense em algo como o git blame, mas para a conversa por trás do commit. Não testei esse recurso. A captura de rastros vem desativada por padrão, e os rastros podem ficar armazenados localmente ou no serviço hospedado deles. Confira qual opção você selecionou, porque isso vai ser importante dependendo de como tudo isso se desenrolar. Agora, de volta à primeira pergunta: quem confere o mapa? Alguns desenvolvedores perceberam que a demonstração de lançamento mostrava um fluxo que não estava realmente no código. O criador do Whiteboard disse que os diagramas reais são vinculados ao código, então alucinações não acontecem na prática. Mas, bom, a IA alucina, sim. De novo, isso é apenas o que diz o criador; então, teste você mesmo. Um link facilita conferir uma explicação. Mas não torna a explicação automaticamente verdadeira. Portanto, trate qualquer diagrama como uma afirmação. Clique nos links e leia o código relevante. Algumas pessoas também temiam que isso se tornasse mais uma fonte da verdade que, aos poucos, acaba abandonada, certo? Por isso, eu não trataria isso como se fosse a resposta. Você ainda precisa ler o código. Eu uso a ferramenta para me orientar pelo código. Ela serve para ajudar justamente nisso. E, voltando ao assunto, eis por que talvez você queira desativar a telemetria. A telemetria anônima vem ativada por padrão. A documentação de privacidade deles é clara sobre os relatórios de falha. Os relatórios de falha do Electron podem conter a memória do processo, inclusive texto-fonte que você abriu. Esses relatórios são desbloqueados na próxima inicialização e mantidos

03:37 por 30 dias. Desative a telemetria nas configurações ou defina “não rastrear”. A documentação diz que, com a telemetria desativada, os relatórios de falha são excluídos sem serem enviados. Faça isso antes de abrir um repo privado. Há também dois recursos opcionais que você deve entender antes de usá-los. Se ativar o armazenamento de rastros hospedado, ele envia as transcrições completas do agent, e a DevFast pode descriptografá-las. Além disso, o login com GitHub solicita acesso ao repo. O Whiteboard roda na sua máquina. Mas isso não significa que todos os recursos opcionais mantenham seus dados na sua máquina. Se ainda quiser observabilidade, não ative a telemetria deles. Aponte o OpenTelemetry do seu código para o Better Stack. Seu código-fonte, seu token, sua conta. Você terá dados de custos, uso e falhas. Os relatórios de falha e as transcrições descriptografadas ficam fora da tela do Whiteboard. Deixe o registro de prompts desativado, a menos que também queira enviá-los. Agora, o download para Mac tem 340 megabytes e funciona apenas em Macs com Apple Silicon. Por baixo, é VS Code, mas você não pode editar arquivos nele. O rastreador de issues tem 13 issues abertas, incluindo uma falha na inicialização do Codex, um erro no diagrama de fluxo e pedidos de suporte a Macs Intel, Copilot e GitHub Enterprise. Hoje, enquanto estou gravando, o Whiteboard é gratuito, open source e local, mas quem sabe? Com esses projetos, isso pode mudar ou virar um recurso pago. A licença MIT também é importante. Uma nova mudança de rumo não tira de você o código que já tem. Certo. Para branches grandes escritas por agents, que realmente precisam ser entendidas em mais detalhes, sim, eu usaria isso. Gosto desse tipo de ferramenta. Experimente em uma revisão de verdade. Clique nas partes importantes. Para um diff de 10 linhas? Ah, vamos lá. Simplesmente ignore isso.

04:08 De qualquer forma, continue usando seu editor. Um diagrama não resolve o problema só por parecer convincente. Ele ajuda quando você pode acompanhar a explicação, conferir o código e explicar a alteração por conta própria. É assim que avalio o Whiteboard. Não pela aparência do mapa, mas por eu entender o que estou prestes a integrar. Se você gosta de dicas e truques de programação como este, não deixe de se inscrever no canal Better Stack. Até o próximo vídeo. [música]

04:38 arqueologia, não a coisa dos dinossauros. Certo, agora estamos falando de código. Aponte para um trecho de código e pergunte por que ele existe. A ideia é que a resposta use as sessões do agent que o escreveram. Pense nisso como um git blame, mas para a conversa por trás do commit. Não testei este recurso. A captura de traces vem desativada por padrão, e eles podem ficar armazenados localmente ou no serviço hospedado. Confira qual opção você selecionou, porque isso vai importar dependendo de como esse recurso funciona. Agora, voltando à primeira pergunta: quem confere o mapa? Alguns devs realmente

05:09 perceberam que a demonstração de lançamento mostrava um fluxo que, na verdade, não estava no código. O criador do whiteboard disse que os diagramas reais são vinculados ao código. Então, na prática, não acontecem alucinações. Mas, bem, com IA, elas acontecem, sim. De novo, isso é só o criador falando sobre a própria ferramenta, então teste você mesmo. Um link facilita a verificação de uma explicação. Mas não torna a explicação automaticamente verdadeira. Portanto, trate qualquer diagrama como uma afirmação. Clique nos links e leia o código relevante. Algumas pessoas também se preocuparam com a possibilidade de isso se tornar mais uma

05:39 fonte da verdade que aos poucos acaba sendo abandonada, certo? Por isso, eu não trataria isso como se fosse a resposta definitiva. Você ainda precisa ler o código. Eu uso a ferramenta para me orientar pelo código. Ela serve para ajudar justamente nisso. E, voltando ao assunto, eis por que talvez você queira desativar a telemetria. A telemetria anônima vem ativada por padrão. A documentação de privacidade deles é clara sobre as falhas. Os relatórios de falha do Electron podem conter a memória do processo, inclusive o texto-fonte que você abriu. Esses relatórios são desbloqueados na próxima inicialização e mantidos

06:10 por 30 dias. Desative a telemetria nas configurações ou defina “não rastrear”. A documentação deles diz que, com a telemetria desativada, os relatórios de falha são excluídos sem serem enviados. Faça isso antes de abrir um repo privado. Também há dois recursos opcionais que você deve entender antes de usá-los. Se ativar o armazenamento hospedado de traces, ele envia as transcrições completas do agent, e a DevFast pode descriptografá-las; a autenticação pelo GitHub solicita acesso ao repo. O whiteboard é executado na sua máquina. Mas isso não significa que todos os recursos opcionais mantenham seus dados na sua

06:40 máquina. Se ainda quiser observabilidade, não ative a telemetria deles. O Pointcloud codifica a OpenTelemetry no Better Stack. Seu código-fonte, seu token, sua conta. Você tem acesso ao uso de custos e às falhas. Os relatórios de falha e as transcrições descriptografadas ficam fora do canvas do whiteboard. Deixe o registro de prompts desativado, a menos que você queira enviá-los também. Agora, o download para Mac tem 340 megabytes e só funciona com Apple silicon. Ele usa o VS Code por baixo, mas você não pode editar arquivos nele. O rastreador de issues tem 13 issues abertas, incluindo uma falha na inicialização do Codex, um erro no diagrama de fluxo e pedidos de suporte para Intel Mac, Copilot e GitHub Enterprise.

07:11 Hoje, enquanto estou gravando isto, o whiteboard é gratuito, open source e local, mas quem sabe? Com esses projetos, isso pode mudar ou passar a exigir pagamento. A licença MIT também importa. Uma mudança de rumo não tira o código que você já tem. Certo. Agora, para branches grandes escritas por agents, que realmente precisam ser entendidas em mais detalhes. É, claro. Eu usaria isso. Gosto desse tipo de ferramenta. Teste em uma revisão de verdade. Clique nos trechos importantes. Para um diff de 10 linhas, fala sério. Pode pular isso.

07:42 De qualquer forma, continue usando seu editor. Um diagrama não resolve o problema só por parecer convincente. Ele ajuda quando você consegue acompanhar a explicação, conferir o código e explicar a mudança por conta própria. É isso que uso para avaliar o whiteboard. Não o quanto o mapa parece bom, mas se entendo o que estou prestes a integrar. Se você gosta de dicas e truques de programação como este, inscreva-se no canal Better Stack. A gente se vê em outro vídeo. [música]

Transcrição original

[00:00] Your agent just changed 40 files. You’re about to approve the poll request, but could you actually explain what it did? I’m hoping most of us review it, but there’s a better way to do just that. This is Whiteboard, a new open- source app that makes your agent draw a map of those changes and link straight into the code. So, how does this work and where does it fit? Let’s find out. The real issue the creators of this call is cognitive debt. Agents made writing

[00:32] code cheap. They didn’t make understanding that though. We still pay for that part in every review. We open the diff and its tests, docs, and logic mixed together. Ask the agent to explain and now you’re reading a wall of markdown. Yeah, sure. That’s fine. But it can be cumbersome and long. We might just need a pretty simple who calls what. What changed in the shortcut to the exact line? Let me show you. If you enjoy coding tools to speed up your workflow, be sure to subscribe. We have videos coming out all the time. All right, now here we are. You download the

[01:03] Mac app, open it, and click connect cla. It installs a small CLI and gives you two commands to add to the plugin. Right here is the first plugin, and here’s the second one. Both of these are for whiteboard. So, you’ll paste those in your terminal. Reload cloud code as we do with any new plugin. Now, we have it. Leave the whiteboard app running. That’s the local server the plugin talks to. Before opening a private repo, turn telemetry off. Settings. Disable. Share anonymous usage data. I’m going to

[01:33] circle back to that why in a moment. Now, in a real repo, you can ask claw a question. I’m just going to fire off the question here. Review my current branch against up-to-date main. Open the result in whiteboard. Walk the request flow as a sequence diagram and put the relevant code next to each step. Now we’re going to run it and on screen you can keep the short line if that’s what you want. Okay, I did a longer one. If you want to say review the branch against main, use whiteboard. It just picks up whiteboard, right? Approve the

[02:04] tool calls. Don’t approve rights. This pass is review only. Now watch the canvas here. A sequence diagram of the request flow streams in in the code next to each step as well. That’s not a mermaid block in Chad. Claude is authoring a review on the local whiteboard server. I click a step and it takes me into that function. Now I can follow the explanation and check it out without hunting through the files. Switch to the diff. Tests and

[02:37] docs are folded away. Big functions are summarized as pseudo code. What’s left is the logic that actually changed. Instead of reading directions in a paragraph, I have a map and I can check where it actually leads to. That click into the function is key to really all this really. Whiteboard is a fork of VS Code Code OSS that is just running on Electron. Our agent talks to it through an MCP server installed as a clot code plugin. And the agent doesn’t just draw whatever it wants. It fills in typed

[03:07] blocks, sequence diagrams, flow diagrams, call stack diffs, code peaks, even a database lens. Think of forms instead of a blank page. Each block has a defined structure and connects to real code. The diff viewer has its own engine that’s actually written in Rust. It reads the code’s structure, the syntax tree, not just the lines of text. That’s how it separates everything out. Now, if you watched the video I did on Archifi recently, you’re probably thinking, “Didn’t I just cover that?” Well, kind

[03:37] of, but not quite. Archify maps your system. Whiteboard reviews a change. Whiteboard’s team actually started with HTML artifacts, then moved to VS Code because connecting diagrams to code was difficult and pure HTML. Mermaid Diagrams are great for docs. They live in Markdown and Git, but you don’t get that click from a box into a function. And sure, code rabbit or graphite, those are cloud bots commenting on your pull request. Whiteboard runs on your machine, uses your own agent, and posts

[04:08] nothing into GitHub. It supports cloud code, codeex, cursor, open code, pi, oh my pi, all that stuff. It is MIT licensed from a company in YC’s winter 2026 batch. But understanding what changed throws us another question to be answered. Why did the agent choose to do it in that way? Whiteboard has a decision log built in, a running list of choices the agent made without asking you or I. That’s the stuff that often never reaches a commit message. Then there is what they call trace

[04:38] archaeology, not the dinosaur stuff. Okay, this is the code stuff. Point at a piece of code and ask it why it exists. And it’s meant to answer using the agent sessions that wrote it. Think uh get blame but for the conversation behind the commit. I haven’t tested this one. Trace capture is off by default and traces can live locally or in their hosted store. Check which one you’ve selected because that is going to matter depending on how this kind of plays out. Now back to the first question here. Who checks the map? Now some devs actually

[05:09] noticed the launch demo showed a flow that wasn’t actually in the code. The creator of whiteboard said real diagrams are linked to code. So hallucinations don’t really happen in practice, but AI, okay, they do happen. Again, that’s just the creator of this talking, so test it out. A link makes an explanation easier to check. It doesn’t make the explanation automatically true, though. So, treat any diagram as a claim. Click through and read the relevant code. Some also worried this would become one more

[05:39] source of truth that just slowly dies off, right? That’s why I wouldn’t treat it as this is the answer. You still have to read through it. I use it to find my way through the code. This is a tool to help with just that. And circling back again, here’s why you may want to turn telemetry off. Anonymous telemetry is on by default. Their privacy dock is clear about crashes. Electron crash dumps can contain process memory, including source text that you have opened. Those dumps get unlocked on the next launch and kept

[06:10] for 30 days. Turn telemetry off in settings or set do not track. Their docs say that with telemetry off, crash dumps are deleted without being uploaded. do that before opening a private repo. There are also two optional features to understand before using them. If you turn on the hosted trace store, it uploads full agent transcripts and DevFast can decrypt them and GitHub sign on asks for repo scope. Whiteboard runs on your machine. That doesn’t mean every optional feature keeps your data on your

[06:40] machine though. If you still want observability, don’t turn on their telemetry. Pointcloud codes open telemetry at better stack. your source, your token, your account. You get cost usage and failures. Crash dumps and decryptical transcripts stay out of the canvas whiteboard. Leave prompt logging off unless you mean to send that, too. Now, the Mac download is 340 megabytes and Apple silicone only. It’s VS Code underneath, but you can’t edit files in it. The issue tracker has 13 open issues, including a Codeex startup

[07:11] crash, a flow diagram error, and requests for Intel Max, Copilot, and GitHub Enterprise. Today, as I’m filming this, whiteboard is free, open source, and local, but who knows with these projects that may change or get paywalled. The MIT license matters, too. Another pivot doesn’t take away the code you already have. Okay. Now, for big agent written branches that actually need understood in more detail. Yeah, sure. I’d use this. I like these kind of tools. Try it on a real review. Click through the important parts. For a 10-line diff, come on. Just skip this.

[07:42] And either way, keep your editor. A diagram doesn’t solve that just by looking convincing. It helps when you can follow the explanation, check the code, and explain the change yourself. That’s what I judge whiteboard on. Not how good the map looks, but whether I understand what I’m about to merge. If you enjoy coding tips and tricks like this, be sure to subscribe to the Better Stack channel. We’ll see you in another video. [music]