O que Desnarrar faz?
Companheiro do descapar (unslop). Descapar corrige o som da prosa de IA; este apaga texto
que não deveria existir: metadiscurso — escrita que narra o artefato para seu próprio público.
Uma barra de progresso já anuncia progresso; "progresso é mostrado enquanto é executado" ao lado
dela é um segundo significante redundante. Agentes produzem isso constantemente porque narram sua
cadeia de pensamento em cada superfície que tocam.
O teste da deleção
Apague qualquer frase, rótulo ou comentário cujo único conteúdo seja:
- uma descrição do artefato em que vive ("Esta seção descreve..."),
- algo que o leitor já pode ver (um tooltip reafirmando o rótulo, um comentário reafirmando a próxima linha), ou
- o processo que o produziu (
// Conforme solicitado, extraído para um helper).
Duas verificações decidem casos ambíguos:
- Apague mentalmente. Se o leitor não perder nada, era uma não-operação — texto que parece fazer algo mas não muda nada.
- Portabilidade. Se a linha pudesse aparecer inalterada em outro projeto, outro PR, ou acima de código diferente, ela não diz nada sobre este. Corte-a.
O que cortar, por superfície
Cópia de UI
- Cópia descrevendo comportamento que a interface já executa: "Progresso é mostrado enquanto instala", "Um spinner aparece enquanto carrega", "A lista atualiza automaticamente". O widget é o significante; não adicione um verbal.
- Texto "Carregando..." ao lado de um spinner visível; "Arquivo enviado com sucesso" → "Arquivo enviado".
- Tooltips e texto de ajuda reafirmando o rótulo: campo "Cidade de nascimento", dica "Insira a cidade do seu nascimento".
- Narração posicional: "Clique no botão abaixo para enviar", "Selecione uma opção do menu suspenso".
- Cópia de onboarding/coach-mark que inventaria cada controle em vez de apontar para a única ação não óbvia.
- Duplicatas de acessibilidade:
aria-label="Botão de enviar"em um<button>,alt="Imagem de um gráfico"(leitores de tela já anunciam a função).
Documentação e READMEs
- "Este documento descreve...", "Neste guia, vamos...", "Bem-vindo à documentação de X". Comece com o conteúdo.
- Seções de visão geral que apenas anunciam as seções que seguem; parágrafos finais "Em resumo" reafirmando a página.
- Docstrings reafirmando a assinatura (
get_user(id)— "Obtém o usuário pelo id");<summary>Obtém ou define o X</summary>. PEP 257 bane exatamente isso. - "O exemplo a seguir mostra como..." acima de um exemplo; prosa reafirmando o bloco de código adjacente.
- Marcadores de funcionalidades e introduções de seção que seriam verdadeiros para qualquer projeto.
Comentários de código
- Reafirmando a próxima linha:
// Importar React,// Retornar o valor,// Percorrer os itens. - Banners de seção:
// ===== HELPERS =====,// --- Etapa 3: Validar ---. - Narração de plano e fase:
// Fase 2: refatorar,// Usando o modelo Foo recém-criado. - Narração de changelog:
// Alterado de useState para useReducer, `// Removido o handler antigo". O histórico do Git mantém isso. - Comentários endereçados ao revisor em vez do leitor futuro:
// Nota: Mantive este comportamento intacto.
Commits e PRs
- Listas de marcadores reafirmando o diff arquivo por arquivo; "Este PR adiciona..." seguido do título literalmente.
- Seções de modelo preenchidas com reafirmação; "Plano de teste: executou os testes" sem especificidades.
- Narração de esforço: "Refatoração abrangente", "Compatibilidade com versões anteriores preservada cuidadosamente". Declare fatos que um revisor possa verificar.
Manter — nem tudo que narra é uma não-operação
- Narração ao vivo é um significante; narração estática é o sinal. Um agente transmitindo "Instalando dependências…" enquanto trabalha é feedback real. Cópia descrevendo que esse feedback existe é o anti-padrão.
- Comentários de "porquê" permanecem: justificativa, invariantes, avisos sobre comportamento não óbvio, links para issues e incidentes. A regra apaga reafirmação, não comentários — combine com a densidade de comentários do código ao redor.
- Instruções carregando informações que a superfície não pode mostrar permanecem: formatos ("AAAA-MM-DD"), restrições ("8+ caracteres"), efeitos colaterais ("isto envia e-mail para a equipe"), avisos de irreversibilidade.
- Texto alternativo real permanece. Apague o prefixo "Imagem de...", mantenha a descrição do que a imagem mostra.
- TODOs com link de rastreamento permanecem;
// TODO: melhorar istosimples vai.
Aplicando
- Varra as superfícies alteradas em busca dos padrões acima. Apague, não reescreva — a maioria dos acertos não precisa de substituição.
- Quando a deleção deixar uma lacuna real, corrija o artefato (rótulo mais claro, controle autoexplicativo), não a narração.
- Então execute o descapar no que sobreviveu.
reference/terminology.md nomeia o fenômeno por comunidade (metadiscurso, happy talk,
comentários óbvios, não-operações) com fontes, para citar ou estender a lista de verificação.