Programadores
Dita o prompt.Escreve o código.
O teclado não deixou de importar. O que mudou foi o que passa por ele. Um programador a trabalhar com um agente de código escreve hoje mais frases do que código num dia, e as frases são a parte que a voz faz mais depressa.
A resposta curta
Sim, o ditado compensa para quem programa, e não é para o código. É para a prosa à volta do código, que é agora a maior parte do dia: o prompt para o agente, a descrição do pull request, a mensagem de commit, o comentário na issue, a resposta no Slack. Dita tudo o que tenha mais de uma linha e continua a escrever à mão identificadores, caminhos e comandos. Os nomes de funções ditos em voz alta voltam como palavras normais, e o agente que os lê percebe quase sempre qual era a função.
Onde a voz ganha
Cinco coisas que escreves todos os dias, e de que lado da linha fica cada uma.
Escrever à mão é barato para uma linha e caro para um parágrafo, por isso uma mensagem escrita sai curta quer curto fosse o tamanho certo quer não. Falar é barato para um parágrafo. Essa diferença decide todas as linhas abaixo.
| O texto | Escrito, normalmente | Ditado |
|---|---|---|
| Um prompt para um agente de código | Três linhas secas, porque escrever um parágrafo dá trabalho. O agente preenche os buracos com palpites e os três turnos seguintes vão para corrigir os palpites. | Quarenta segundos de contexto: o que já tentaste, o que viste, o que não pode mudar. Um prompt melhor sem custo nenhum, porque dizer é mais fácil do que escrever. |
| A descrição de um pull request | O título, e "ver commits". | Porque é que a alteração existe, o que mudou e por onde começar a ler. Dito uma vez, em menos tempo do que o revisor gasta no diff. |
| Uma mensagem de commit | "fix", "wip", "address comments". | A frase que dirias ao colega do lado, que é o que uma mensagem de commit sempre devia ter sido. |
| Um bug report ou um comentário numa issue | Mais curto do que o problema. Os passos para reproduzir são a parte que fica de fora. | Passos, esperado, obtido, enquanto ainda está fresco. A parte que ficava de fora é a parte que vale a pena ter. |
| O código em si | Sim. | Não. Sintaxe, identificadores e caminhos escrevem-se à mão. As ferramentas de ditado são ferramentas de prosa, e esta página diz isso com clareza porque a ferramenta que vende é uma delas. |
A linha não está entre trabalho e conversa. Está entre texto que tem sintaxe e texto que não tem. Um prompt não tem, por isso dita-se. Um caminho tem, por isso escreve-se.
A lista real
O que corre mesmo mal quando um programador dita.
Os identificadores voltam como palavras
Dizes getUserById e a transcrição lê "get user by ID". O snake case perde os underscores, um caminho de ficheiro perde as barras, e uma sigla que ninguém fora da equipa publicou perde para a palavra comum que soar mais parecido. Reconhecer é prever, e um nome que o modelo nunca viu não tem nada que o segure.
Os símbolos dizem-se, não se escrevem
A pontuação falada funciona: ponto, vírgula, novo parágrafo. Uma flag de comando falada não. Diz "dash dash force" e recebes essas três palavras, porque não existe gramática de ditado para código e nenhuma empresa pequena a vai inventar. Tudo o que tem sintaxe pertence ao teclado.
A ferramenta fixa uma língua e a frase tem duas
A frase técnica de quem programa em Portugal já é bilingue: os verbos são portugueses e os substantivos são ingleses. Uma ferramenta que decide a língua por ditado empurra a metade minoritária para a maioritária, por isso "fazer deploy" volta como uma palavra portuguesa parecida com deploy, e "o merge" volta como outra coisa qualquer. O sotaque nunca foi o problema. A fixação é.
O passo de limpeza arruma as coisas erradas
Tudo o que transforma uma transcrição crua em texto limpo é um modelo de linguagem, e um modelo de linguagem com liberdade para reescrever expande "repo" para "repositório", traduz o "commit" que disseste em inglês, e transforma uma nota rápida para um agente num memorando. A prosa técnica só sobrevive a um passo de limpeza que esteja proibido de mudar as palavras.
Os dois primeiros pertencem ao modelo de voz e à ausência de uma gramática para código. Nenhuma aplicação pequena muda isso. Os dois últimos são decisões de produto, e são os que valem a pena na hora de escolher.
A solução
Como ditar para um agente de código.
Cinco hábitos, cinco minutos, em qualquer ferramenta de ditado. Nenhum pede para falar código. Põem a linha no sítio certo e deixam o agente fazer a parte que um modelo de voz não consegue.
- 01
Põe a linha na caixa do prompt
Dita para a caixa do agente, para o formulário do pull request, para a mensagem de commit, para a issue, para o Slack. Escreve à mão no editor. As mãos estão no teclado de qualquer forma, por isso o identificador não custa nada a escrever e custa muito a dizer.
- 02
Descreve o símbolo em vez de o soletrar
Diz "a função que carrega o utilizador a partir da sessão", não "get user by ID". Um agente de código liga uma descrição ao símbolo certo com muito mais fiabilidade do que um modelo de voz liga um som a camel case. A coisa em que o ditado é pior é a coisa em que o agente é melhor.
- 03
Diz a forma em voz alta
"Novo parágrafo", e depois "primeiro, segundo, terceiro". Um bom passo de limpeza transforma uma enumeração falada numa lista e uma mudança de assunto num parágrafo, e um prompt com estrutura recebe uma resposta melhor do que as mesmas palavras num bloco só.
- 04
Corrige-te em voz alta e continua
"O vermelho, quer dizer, o azul." "Esquece isso." Um passo de limpeza que resolve correções faladas fica só com a versão que querias. Parar para apagar é o hábito que faz o ditado parecer lento, e é um hábito de teclado, não de fala.
- 05
Corrige os três nomes no fim e envia
Deixa os identificadores sair errados enquanto falas. Quando a transcrição chega, a hesitação e os arranques falsos já lá não estão, por isso só restam dois ou três nomes para emendar. Trinta segundos, e o prompt continua a ser três vezes mais longo do que o que terias escrito.
Se depois do quinto passo o resultado ainda parece uma transcrição, o problema é o passo de limpeza da ferramenta, e essa é a única coisa desta lista que um hábito não resolve.
O que construímos
Carrega numa tecla, fala com o agente.
O Sonira cola onde está o cursor. É essa a integração toda: o terminal onde corre o Claude Code, o painel de conversa do Cursor, a caixa do pull request no GitHub, o editor da mensagem de commit, o Slack. Não há lista de aplicações suportadas nem plugin para instalar, porque colar é a única coisa que todas as aplicações já aceitam.
O passo que limpa a transcrição está escrito para fazer uma lista curta de coisas e parar. Pontuação. Muletas e arranques falsos fora. "Esquece isso" e "quer dizer" resolvidos para a versão que querias. "Novo parágrafo" e uma enumeração falada transformados num parágrafo e numa lista. Nada traduzido, nada reescrito, nada formalizado, por isso "repo" fica "repo" e uma frase com duas línguas fica com as duas.
O que não faz: ainda não há vocabulário próprio, por isso um identificador sai como palavras à primeira e corrige-se à mão. Não há modo de código e não vai haver. E a leitura em voz alta lê uma seleção de texto real, por isso um painel de terminal que desenha a própria seleção, o Claude Code dentro do tmux por exemplo, não lhe dá nada para ler.
Nota honesta: a versão que está neste site é a atual. A leitura em voz alta está lá.
Carregar numa tecla. Falar. As palavras aparecem onde está o cursor.
O agente é o corretor
A falha mais antiga do ditado encontrou o único leitor a quem não faz diferença.
O reconhecimento de voz sempre perdeu nos nomes, e durante vinte anos a solução foi parar e escrevê-los. Um agente de código muda as contas. Lê "get user by ID" contra o código e encontra getUserById, porque ligar uma descrição solta a um símbolo exato é o trabalho dele. A palavra errada deixa de ser um erro e passa a ser uma pesquisa.
O que o agente não consegue reparar é um prompt magro. Só trabalha com o contexto que lhe deste, e o contexto escrito à mão é magro porque escrevê-lo dá trabalho. O ditado engorda o prompt de graça. É esse o argumento todo para ditar a um agente, e não tem nada que ver com o código.
Rever de ouvido
Uma resposta longa de um agente é uma parede de prosa plausível, e plausível é exatamente aquilo por onde o olho passa a correr. Seleciona-a no browser ou no editor e manda ler em voz alta. O passo errado que terias deixado passar a ler costuma soar errado, e é uma das razões por que construímos voz para fora além de voz para dentro.
Convém saber
Perguntas, respondidas.
- 01É possível escrever código por voz?
- Não com uma aplicação de ditado, e não bem com mais nada. O ditado é para prosa: o prompt, o pull request, a mensagem de commit, a issue, a mensagem para um colega. O código tem sintaxe e um modelo de voz não tem gramática para ela. Põe a linha aí e o ditado deixa de desiludir.
- 02Funciona dentro do terminal?
- Sim, se a ferramenta colar no cursor em vez de escrever numa aplicação específica. O Sonira cola, por isso o Terminal, o iTerm e o prompt de um agente de código a correr lá dentro recebem o texto. Um ditado longo chega como uma colagem única, que algumas ferramentas de terminal mostram como um bloco colado até o enviares.
- 03Vai acertar nos nomes das minhas funções?
- À primeira, não. Um nome que o modelo nunca viu volta como as palavras comuns mais próximas, e o Sonira ainda não tem vocabulário próprio. Descreve a função em vez de a nomear e deixa o agente resolver, ou emenda os dois ou três nomes depois de a transcrição chegar.
- 04As minhas frases estão cheias de termos em inglês. Isso estraga alguma coisa?
- Só numa ferramenta que fixa uma língua por ditado. O Sonira não fixa nada e deixa cada parte da frase na língua em que foi dita, por isso "fazer deploy" e "o merge" ficam exatamente assim, e "fazer push" não vira "empurrar". Há um guia à parte sobre frases que carregam duas línguas.
- 05Reescreve o meu prompt pelo caminho?
- Não. O passo de limpeza está proibido por escrito de traduzir, reescrever ou formalizar. Tira a hesitação e os arranques falsos, resolve correções faladas, aplica a formatação dita, e pára. Um prompt lê-se como foi dito, com pontuação.
- 06Porque não o ditado grátis que já vem no Mac?
- Experimenta-o primeiro. É grátis e para uma mensagem curta chega. A transcrição crua imprime a hesitação, e um prompt de quarenta segundos tem muita. Um passo de limpeza que tira as muletas sem tocar nas palavras é a diferença entre uma transcrição e uma mensagem, e é a coisa principal que uma ferramenta paga acrescenta.
Dita o prompt. Escreve o código.
Grátis enquanto estamos em beta.
Quando a própria frase carrega duas línguas
Ditas em inglês com sotaque? Lê o guia do sotaque.
Nunca ditaste? Começa pelo guia do Mac.