Falar para um agente não é falar para você mesmo

Quando você grava uma ideia para documentar ou comunicar, o texto que volta é rascunho: você vai reler e arrumar. Quando você grava para entregar a um agente — uma sessão de código, um assistente que vai executar —, o texto que volta é a instrução. Ninguém relê no meio. O que você falou vira o que vai acontecer.

Isso muda a forma de falar, e demorei a perceber que muda.

Três coisas que a fala solta perde, e que a instrução precisa

A restrição sai como aparte, e aparte se perde. Falando, a gente enuncia o objetivo com clareza e deixa o que não pode acontecer no meio de uma frase lateral — "ah, e sem mexer no banco, né". Para você mesmo, isso basta: você sabe. Para quem vai executar, a restrição dita de passagem tem o mesmo peso de qualquer outra frase. Diga a restrição como frase inteira, e diga antes do objetivo. É a parte que, se sumir, você só descobre depois de pronto.

O nome da coisa muda três vezes no mesmo parágrafo. Falando, você chama a mesma coisa de "o arquivo", "aquilo lá", "a configuração", e ninguém estranha — quem escuta acompanha pelo contexto. Só que agora o ouvinte trata cada nome como possivelmente outra coisa. Escolha o nome uma vez e repita ele, mesmo soando burro. Repetição que incomoda no ouvido é exatamente o que remove ambiguidade no texto.

Fala não tem estrutura visível, e você não pode contar com a formatação. No papel, "primeiro, segundo, terceiro" aparecem como lista. Na fala, viram entonação — e entonação não sobrevive à transcrição. Se a ordem importa, diga a ordem em voz alta. "São três coisas. A primeira é…" É feio e funciona.

O que não muda, e é o motivo de falar ainda valer a pena

Nada disso desfaz a vantagem. Falar continua sendo o jeito de despejar contexto denso sem parar para escolher palavra — e contexto denso é justamente o que um agente precisa e o que dá mais preguiça de digitar. As três correções acima custam segundos cada uma. Digitar a mesma quantidade de contexto custa a tarde.

Um caso meu, e a metade dele que não era culpa da fala

Gravei a descrição de uma jornada de uso: o que a pessoa faria, o que deveria aparecer em cada tela. No meio da gravação eu decidi em voz alta — mudei a ordem dos passos, escolhi que detalhe ficava em cada parte. O que voltou tinha coisa na tela errada e, de brinde, um recurso que eu frisei simplesmente não feito.

Metade disso são os três pontos acima me cobrando: deliberar em voz alta chega do outro lado como instrução — ninguém sabe qual versão da ordem venceu — e "frisar" é entonação, que não sobrevive à transcrição.

A outra metade não era a fala, e demorei a admitir: a sessão estava carregando assuntos demais ao mesmo tempo. Instrução boa entregue num lugar sobrecarregado se perde do mesmo jeito. Foi o que me fez separar duas coisas que eu tratava como uma:

Quanto contexto a fala precisa carregar depende do momento do projeto. No começo eu explico os gotchas e dou contexto longo. Mais adiante eu falo por referência — "como a gente fez naquela tela" — e a mesma instrução cabe em menos tempo de fala. É igual a explicar para alguém que entrou no projeto ontem e para alguém que está nele há um mês.

Um assunto por sessão. Quando execução, revisão e decisão de frentes diferentes disputam a mesma conversa, nenhuma técnica de fala compensa — e o custo aparece em rodadas extras até acertar. Falar bem não conserta ouvinte sobrecarregado.

Onde isso não funciona

Se a tarefa tem forma exata — nome de arquivo, caminho, comando, número — falar é mais lento e mais arriscado do que digitar. O ganho de falar está no contexto, na intenção, no porquê. A parte literal você digita, e digita depois.

E há um limite que nenhuma técnica de fala resolve: se você ainda não decidiu o que quer, falar não decide por você. Instrução vaga falada com clareza continua sendo instrução vaga. O agente vai executar a sua indecisão com muita eficiência.