Desfazer para IA: Por que criamos o versionamento de arquivos

O problema de dar uma caneta para a IA

Aqui está algo que ninguém te conta sobre agentes de IA autônomos: eles são escritores prolíficos sem o conceito de “você tem certeza?”

Um agente de IA solicitado a “melhorar este documento” reescreverá tudo. Um agente solicitado a “limpar este código” reestruturará todos os arquivos que tocar. Um agente executando uma tarefa em segundo plano criará, modificará e excluirá arquivos sem pedir permissão — porque você disse para ele operar de forma autônoma.

Na maioria das vezes, os resultados são bons. Mas “na maioria das vezes” não é bom o suficiente quando a alternativa é perder trabalho que você não pode recuperar.

É por isso que construímos o versionamento de arquivos. Cada alteração em cada arquivo em cada espaço de trabalho é preservada. Cada versão pode ser navegada, comparada e restaurada com um clique.

É o Ctrl+Z para a IA.

10 de fevereiro de 2026: o commit que mudou tudo

A mensagem do commit diz: “feat: adicionar versionamento de arquivos VFS com histórico, restauração e rollback de tarefas.”

Por trás dessa mensagem está um sistema que mudou fundamentalmente a relação entre usuários e seus agentes de IA. Antes do versionamento, dar a um agente de IA acesso de escrita aos seus arquivos exigia confiança. Após o versionamento, não requer nada — porque qualquer alteração pode ser desfeita.

Isso importa mais do que você pode pensar.

Por que os agentes de IA precisam de controle de versão

A edição de arquivos por humanos é deliberada. Você abre um arquivo, faz alterações, salva. Se não gosta do resultado, você desfaz. O ciclo cognitivo é apertado: mudar, avaliar, manter ou reverter.

A edição de arquivos por agentes de IA é diferente. O agente pode modificar cinco arquivos em uma tarefa. Ele pode executar um trabalho em segundo plano que toca arquivos enquanto você dorme. Pode interpretar “atualizar o relatório” como “reescrever o relatório do zero.”

Sem versionamento, cada operação de arquivo da IA é uma porta de mão única. O original se foi. Se você não gosta do resultado, precisa reconstruir manualmente o que estava lá antes — assumindo que você se lembre.

Com o versionamento, cada operação de arquivo da IA é reversível. O original é preservado. Se você não gosta do resultado, clica em “restaurar” e ele volta em menos de um segundo.

Como funciona

Snapshots automáticos. Cada vez que um arquivo é salvo — por você, por um agente de IA, por uma tarefa em segundo plano, por um upload de arquivo — a versão anterior é automaticamente registrada. Nenhuma ação manual necessária. Nenhum passo de “lembre-se de fazer o commit”. Cada salvamento cria um histórico.

Navegador de histórico de versões. Abra qualquer arquivo e veja seu histórico completo. Cada versão tem um timestamp e contexto: quem a alterou (usuário vs. agente vs. tarefa em segundo plano), quando e de qual sessão. Você pode ver a linha do tempo completa da evolução de um arquivo.

Restauração com um clique. Encontre a versão que você quer. Clique em restaurar. O arquivo reverte imediatamente. A própria restauração cria uma nova versão (o estado atual antes da restauração é preservado), então restaurar também é reversível.

Rollback de tarefas. Este é o recurso do qual mais nos orgulhamos. Quando uma tarefa em segundo plano modifica arquivos, todas essas modificações são marcadas com o ID da tarefa. Se a tarefa produziu resultados ruins, você pode reverter todos os arquivos que ela tocou para seu estado anterior à tarefa com uma única ação. Não arquivo por arquivo — tudo de uma vez.

O detalhe de implementação que importa

Os snapshots são feitos usando um padrão de decorator. O provedor de armazenamento é envolto em um VersionedStorageProvider que intercepta cada operação de escrita e cria um snapshot antes que a escrita seja concluída.

Isso significa que o versionamento é invisível para o resto do sistema. O agente de IA não sabe que os arquivos estão sendo versionados. O endpoint de upload não sabe que os arquivos estão sendo versionados. O mecanismo de tarefas em segundo plano não sabe que os arquivos estão sendo versionados. Todos apenas escrevem arquivos normalmente, e a camada de versionamento captura tudo.

Essa foi uma escolha de design deliberada. Não queríamos que o versionamento fosse um recurso que os desenvolvedores precisassem lembrar de usar. Queríamos que fosse uma propriedade do próprio sistema de arquivos. Cada arquivo é versionado. Sempre. Sem necessidade de opt-in.

A equação de confiança

Antes do versionamento, havia uma equação de confiança implícita toda vez que um usuário executava um agente de IA:

O benefício desta tarefa vale o risco de o agente bagunçar meus arquivos?

Para arquivos importantes — um relatório cuidadosamente escrito, uma base de código funcional, um conjunto de dados curado — a resposta muitas vezes era “não.” Os usuários copiavam seus arquivos para uma pasta separada antes de executar um agente. Ou evitavam dar acesso de escrita ao agente. Ou assistiam a cada operação de arquivo em tempo real, derrotando o propósito da execução autônoma.

O versionamento elimina essa equação. O risco de um agente bagunçar arquivos é zero, porque qualquer alteração pode ser revertida instantaneamente. Os usuários não precisam copiar arquivos antes de executar tarefas. Eles não precisam assistir o agente trabalhar. Eles apenas deixam o agente rodar, revisam os resultados depois e reverter qualquer coisa que não esteja certa.

Isso muda a relação de “delegação cuidadosa” para “delegação confiante.” Execute a tarefa. Verifique os resultados. Mantenha o que é bom. Reverta o que não é. Leva dez segundos em vez de dez minutos de preparação antes da tarefa.

A lição mais ampla

Os agentes de IA são poderosos. Eles também são imperfeitos. A solução não é torná-los perfeitos — isso é um padrão impossível. A solução é tornar suas imperfeições reversíveis.

O versionamento de arquivos é um exemplo de um princípio mais amplo: construa redes de segurança, não barreiras. Barreiras impedem a IA de agir. Redes de segurança permitem que a IA atue livremente enquanto garantem que erros possam ser corrigidos.

A execução em sandbox é uma rede de segurança (contém danos). O versionamento de arquivos é uma rede de segurança (preserva o estado anterior). O registro de eventos é uma rede de segurança (cria trilhas de auditoria). Cada uma permite que a IA seja mais autônoma, tornando a autonomia menos arriscada.

Os agentes de IA na LikeClaw estão melhorando a cada semana. Mas eles nunca serão perfeitos. E isso é bom — porque com o versionamento, eles não precisam ser.