Documentação de software no vibe coding: atualize os docs com 23% e não compacte

Documentação de software no vibe coding é atualizar os docs com 23% de contexto e não compactar, para a próxima janela nascer sabendo o que foi feito.

Martin deu essa ordem ao Claude perto dos 57 min de uma live de 66 min. O app é o Fumava, para parar de fumar, receita R$ 0. Ele olhou o medidor da janela. Ainda havia 23%. O resto da sessão ia para registrar o que já tinha sido feito.

Eu não quero que compacte, a gente ainda tem 23% só.

23% de contexto ainda não é hora de compactar

Ele começou pelo corte: "A gente vai acabar a janela de contexto nessa janela aqui." A janela ia fechar. Compactar era o próximo passo óbvio com a janela acabando. Ele mandou o Claude não fazer isso.

O critério estava no medidor: 23% ainda visíveis. O que sobrou ia para a documentação.

O pedido veio na mesma fala:

eu quero que tu atualize toda a documentação, os documentos pertinentes aí, holdmap, tudo que precisa para, enfim, registrar o que a gente fez e me dar os próximos passos aí na sua visão.

"holdmap" é o nome que ele usou, entre aspas, do jeito que saiu. O trabalho é atualizar isso junto com os documentos pertinentes, para registrar o que foi feito, e sair com os próximos passos na visão do assistente. A documentação de software, nesse minuto, era o que ia atravessar o corte da janela.

A documentação de software que a próxima janela vai ler

Feature nova ficou para a conversa seguinte.

qualquer feature nova que eu for fazer, eu vou chamar em uma outra janela

O motivo veio na frase seguinte:

a documentação esteja 100% atualizada para ele já saber o contexto na próxima janela

"Ele" é o Claude da janela seguinte, uma conversa nova, com memória nova. Sem os docs em 100%, a próxima janela abre sem o que esta registrou. Por isso ele pediu a atualização agora, com 23% ainda na tela.

Os 23% desta janela pagam o estado da próxima. O "holdmap", os documentos pertinentes, o registro do que foi feito, os próximos passos: cada item sai do chat e vai para onde a janela nova consegue ler.

Feature nova em outra janela no vibe coding

Esta janela fica com o registro, e feature nova ele chama em outra.

Com o que restava, Martin pediu o registro e a visão dos próximos passos. Gastar 23% numa feature a mais deixa a documentação atrasada, e a janela seguinte herda o atraso. Ele cortou com o número ainda visível.

No vibe coding, a janela seguinte só herda o que está nos arquivos. O assistente não carrega a conversa anterior sozinho. O próximo Claude só sabe o contexto se a documentação de software estiver 100% atualizada. Foi o mesmo caminho de software como serviço.

O Fumava está em R$ 0. A fala dos 57 min pede registro, porque o Claude da próxima janela só vai saber o que estiver escrito. Continuar o build é gravar o estado antes de fechar. Essa é a Lei 2 do movimento aplicada à sessão: quem continua é quem deixou o próximo assistente entrar já informado.

O que fazer com 23% antes de fechar

O teste é o mesmo da live: se o medidor ainda mostra 23%, o resto da janela vai para a documentação de software, o que foi feito nesta sessão, os documentos pertinentes, o "holdmap" do jeito que o seu projeto chama o mapa do trabalho, e os próximos passos na visão do assistente que estava na sala.

Depois abre outra janela. Feature nova vai para lá. A primeira mensagem da janela nova não precisa recontar o projeto se os docs estiverem 100% atualizados.

Dá para assistir à live e ouvir o pedido inteiro, no minuto 57, do jeito que ele falou para o Claude. Amanhã, quando o medidor chegar perto do fim e ainda houver 23%, gaste o resto nos docs e abra outra janela para a feature.