Ideia principal

Quando você trabalha em um assunto longo com o Claude Code e deixa o assistente escrever em um arquivo Markdown, a pergunta que acaba aparecendo não é o tamanho do arquivo, é para quem ele está arrumado.

Um assistente precisa de pontos de retomada: onde o trabalho parou, que decisões foram tomadas, onde encontrar uma fonte. Ele precisa de seções estáveis, de identificadores, de estados. Um product manager que relê o mesmo arquivo procura outra coisa: agregar a informação, validá-la, recortá-la de novo por tema ou por nível de risco para decidir. Não são duas apresentações de uma mesma estrutura, são duas estruturas.

Manter as duas em um único arquivo não produz, então, um meio-termo, e sim um documento que cada um dos dois leitores precisa atravessar ignorando metade. Duplicar o arquivo — um para o assistente, outro para o humano — empurra o problema sem resolvê-lo: os dois incham, e cada um acaba contendo um pouco de tudo, fontes, decisões, hipóteses e diretrizes misturadas no mesmo fluxo. O recorte que se sustenta não é feito por destinatário, é feito por natureza de conteúdo.

Por que isso importa

Isso identifica a etapa que pulamos ao passar do arquivo único para um sistema de arquivos. Primeiro achamos que temos um problema de volume, depois achamos que temos um problema de público; na verdade é um problema de tipos de objetos, e enquanto não vemos isso, multiplicamos arquivos que voltam todos a ser um depósito de tudo.

Isso também dá um critério simples de releitura para um documento de trabalho compartilhado com um assistente: perguntar a quem serve cada seção, e contar quantas servem a dois.

Nuances e limites

Um documento curto escapa da regra. Enquanto um arquivo puder ser lido inteiro em um minuto, a desordem não custa nada, e impor uma estrutura custa mais do que rende.

E a separação tem um preço: duas estruturas a manter se dessincronizam, e uma delas acaba não sendo mais relida.

Questões em aberto

• Como verificar que a versão destinada ao humano não ficou para trás daquela que o assistente atualiza a cada sessão?