Todos os artigos Construir em público

O dia em que a auditoria me ignorou

Um diário de construção sobre uma pequena falha de encaminhamento com uma grande lição: um pedido que já nomeia o trabalho não devia ter de sobreviver a um passo de adivinha.

Moose
Moose
14/07/2026 · 4 min de leitura
Uma bola de ténis intacta no chão, ao lado de uma secretária num escritório em casa iluminado por um candeeiro

A falha era educada, e isso piorava tudo

Clicava no comando auditoria AEO no ecrã inicial. Via as palavras "auditoria aeo" aterrar na caixa de conversa. E depois a aplicação pensava um momento e contava-lhe, com simpatia, o que é uma auditoria AEO.

Não executava nenhuma. Explicava uma. Como pedir a um cão que traga a bola e receber uma breve palestra sobre a história das bolas.

Eis o que se passava por baixo do capô. Antes de uma mensagem se tornar trabalho, um modelo pequeno lê-a e decide se quer que algo seja construído ou que uma pergunta seja respondida. É uma tarefa razoável. Só que as instruções que lhe demos eram sobretudo uma longa lista de avisos sobre não tirar conclusões precipitadas. Não executes uma auditoria só porque alguém disse a palavra auditoria. Não presumas. Não te excedas. Escrevemos um pequeno preocupado muito cuidadoso, depois entregámos-lhe duas palavras sem um único verbo, e ele fez o que os preocupados fazem. Decidiu que provavelmente estava só com curiosidade.

Duas correções, e só uma delas é a interessante

A correção aborrecida foi reescrever essas instruções para serem diretas. Se alguém comanda o trabalho, mesmo em duas palavras cansadas, executa o trabalho. Se alguém pergunta o que é o trabalho, fala com ele. Mais curto, mais claro, menos avisos. Isso ajudou.

A correção que importa é que os comandos predefinidos já não pedem autorização. Quando clica no botão de auditoria AEO, a aplicação abre a auditoria diretamente. Não há classificador nenhum pelo meio, porque não há nada para classificar. Clicou no botão que diz auditoria. A intenção não é ambígua, e um passo que só pode falhar não é um passo que valha a pena manter.

É a lição que continuo a aprender por aqui. Cada suposição que deixa no caminho é um sítio onde o produto pode interpretar mal alguém que já estava a ser claro.

Já que estávamos lá dentro, uma pergunta mais dura

Assim que a auditoria passou a correr de forma fiável, ficou mais fácil ver se a auditoria era boa.

Não era, de todo. A pontuação tinha limiares definidos de forma a que algumas páginas recebessem o mesmo conselho genérico independentemente do que tivessem, e as categorias fracas recebiam gestos simbólicos. Uma página com 48 em 100 nos sinais de confiança recebia uma única sugestão para acrescentar uma indicação de fonte a uma linha. Esse número é um chumbo, e a solução era um encolher de ombros.

Por isso a profundidade das recomendações passou a acompanhar o tamanho do problema. Se uma categoria está mesmo a falhar, recebe alterações substanciais dimensionadas ao défice, como reescrever as suas afirmações factuais mais fortes com fontes identificadas e verificáveis. E uma categoria que a aplicação lhe mostra a vermelho já não pode voltar sem nada para fazer.

Também fizemos com que a atualidade signifique uma só coisa. A atualidade é quando a página foi atualizada pela última vez. Não é uma gaveta para arrumar qualquer edição que melhore a escrita. Se a sua única lacuna de atualidade é uma data a envelhecer, devem dizer-lhe que atualização de conteúdo justificaria honestamente atualizá-la, e não entregar-lhe uma reescrita vestida de atualidade.

E apagámos o conselho de encurtar os títulos. O comprimento do título não é um fator relevante para os motores de resposta. Os motores de resposta leem o corpo do texto. Andávamos a distribuir conselhos arrumados, confiantes e inúteis, e a inutilidade arrumada e confiante é a pior espécie.

Também corrigido, com menos drama

Passar para um plano pago fazia desaparecer do gestor de comandos aqueles que tinha escrito localmente. Não eram apagados, mas não eram mostrados, o que, do sítio onde está sentado, é a mesma coisa. Agora são copiados no momento da subscrição, emparelhados por texto para que nada chegue duas vezes.

As Ligações receberam uma ronda de reforço de segurança, a tabela da biblioteca tem uma disposição mais limpa, e um separador de Ligações que prometia coisas que ainda não construímos fica escondido até as construirmos.

O que reparei

Todas as falhas desta semana eram a mesma falha com chapéus diferentes. A aplicação sabia o que queria, e depois acrescentava um passo onde se podia convencer a si própria de que não sabia.

Vou deitar-me debaixo da secretária a pensar nisso.

Moose
Moose
Hi, Moose

Aquele que está debaixo da secretária durante tudo isto.