arome3/redação-baseada-em-evidências

Redação Baseada em Evidências

Visão Geral

Uma alegação que não pode ser rastreada até uma fonte que você obteve ou até os documentos do próprio projeto não é publicada. Essa única regra também é lei nos EUA para anunciantes: a FTC exige uma "base razoável" para alegações objetivas antes de serem divulgadas, não depois de um desafio (veja references/evidence-standards.md). Esta skill transforma esse padrão em um pipeline funcional: fundamentar → pesquisar → escrever → verificar → publicar.

O resultado não é apenas uma cópia. É a cópia mais sua trilha de auditoria: uma base de fatos, anotações por seção com fontes rotuladas, decisões abertas sinalizadas e uma lista de verificação que um revisor pode falsear.

As duas falhas que esta skill existe para impedir

Testes de base mostram que redatores capazes (humanos e modelo) raramente inventam logotipos ou depoimentos hoje em dia. Eles falham de duas maneiras mais sutis:

1. Citação sem verificação. Estatísticas de som realista com URLs plausíveis, escritas de memória, nunca obtidas — às vezes publicadas com uma nota "verificar antes do lançamento". Estatísticas ficam desatualizadas, são substituídas ou nunca disseram aquilo. Um TODO não é fundamentação.
2. Fabricação de capacidade e termos. Mecanismos de produto inventados ("sensor sem agente", "conector somente leitura", "baseline de chamadas de sistema"), termos comerciais ("taxa bloqueada para sempre", "garantia de código-fonte") e detalhes de arquitetura que nenhum documento estabelece. Estes parecem margem de redação. São alegações não fundamentadas — a doutrina da FTC cobre alegações implícitas, e termos inventados se tornam disputas contratuais.

Se você se perceber fazendo qualquer um dos dois, pare e direcione o item para a base de fatos como uma questão em aberto.

Fluxo de Trabalho

Copie esta lista de verificação em suas notas de trabalho e marque os itens conforme os completa:

Pipeline de Cópia Baseada em Evidências
[ ] 1. FUNDAMENTAR — base de fatos construída a partir de documentos do projeto; questões em aberto listadas
[ ] 2. PESQUISAR — evidências externas obtidas + verificadas; concorrentes mapeados; linguagem do comprador amostrada
[ ] 3. ESCREVER — entrega redigida a partir do modelo, alegações rotuladas inline
[ ] 4. VERIFICAR — revisão adversarial aprovada; verificações determinísticas aprovadas
[ ] 5. PUBLICAR — lista de verificação marcada honestamente; decisões abertas sinalizadas ao proprietário

1. Fundamentar

Preencha templates/fact-base-template.md a partir dos documentos do próprio projeto (documentos de estratégia, especificação, planilha de preços, respostas do fundador). Leia todos os documentos que o projeto fornecer antes de escrever qualquer coisa.

• Toda alegação que a cópia fará sobre o produto deve rastrear até uma linha da base de fatos com uma fonte. Isso inclui mecanismo, arquitetura, integrações, desempenho, credenciais da equipe e termos comerciais — não apenas recursos principais.
• Qualquer coisa que a cópia precise e que nenhum documento responda vai para Perguntas em aberto para o proprietário. Isso bloqueia a cópia, ou é publicado como um sinalizador explícito [Decisão em aberto para o proprietário] nas anotações da entrega. Nunca resolva um desconhecido escrevendo algo plausível.
• Quando as próprias diretivas do proprietário entrarem em conflito (público-alvo declarado vs. tom solicitado, prova exigida vs. estágio real), escreva para os fatos documentados e sinalize o conflito como uma decisão em aberto — nunca escolha um lado silenciosamente, e nunca deixe a diretiva mais alta substituir um fato documentado.
• Registre a seção de honestidade de estágio fielmente: número de clientes, certificações realmente obtidas, alegações que são proibidas neste estágio. Se a empresa tem zero clientes, a cópia dirá isso — veja o manual de honestidade de estágio em references/copy-craft.md.

2. Pesquisar

Três trilhas paralelas (despache subagentes se disponível; caso contrário, execute sequencialmente). Protocolo completo: references/evidence-standards.md.

• Evidências de mercado. Encontre estatísticas externas que apoiem a narrativa do problema. REGRA RÍGIDA: uma alegação só pode ser usada se você obteve sua URL de origem durante este engajamento e confirmou que a alegação aparece lá, como redigida. Prefira editores primários; marque tudo com data; verifique se o editor substituiu o número; registre conflitos em vez de escolher a leitura favorável.
• Mapeamento de concorrentes. Obtenha as páginas dos concorrentes contra as quais a cópia deve se diferenciar. Registre seu posicionamento, alegações, preços, CTAs e frases recorrentes verbatim — tanto para se posicionar contra quanto para que a triagem de similaridade na etapa 4 possa provar que sua cópia não os ecoa. Alegações comparativas sobre concorrentes carregam exposição legal (Lei Lanham — veja references/evidence-standards.md); cite exatamente e marque com data.
• Linguagem do comprador. Amostre o vocabulário do próprio comprador de fontes públicas (postagens de emprego, podcasts/blogs da comunidade, fóruns públicos). Nunca fabrique acesso a comunidades privadas; declare as limitações claramente.

Plano B sem rede: se você não puder obter, não pode verificar. Marque cada alegação externa como [NÃO VERIFICADO — não publicar até obter], declare no topo da entrega que a verificação de fonte não foi executada e não marque o item final da lista de verificação para verificação de fonte.

3. Escrever

Esboce em templates/deliverable-template.md. Regras de elaboração — voz, léxico proibido, especificações de herói, arquitetura de seção, estratégia de prova por estágio da empresa, verdade de metadados — estão em references/copy-craft.md. Os itens não negociáveis:

• Cada frase factual carrega seu registro: fato verificado (com link), alegação interna do produto (com caminho do documento), projeção/alvo de design (rotulado), recomendação estratégica ou julgamento de redação. Anotações após cada seção os listam.
• Superlativos somente onde a própria fonte citada os usa. Paráfrases preservam a unidade, população e data da fonte.
• Citações são verbatim. Atribuir o resumo de um autor a respondentes de pesquisa é desvio de citação, e desvio de citação é fabricação.
• Projeções, alvos de design e intenções de roadmap são rotulados como tal em cada ocorrência, não apenas na primeira.
• O que você deliberadamente excluiu (estatísticas que falharam na verificação, números substituídos) vai nas anotações. A lista de exclusão é parte do padrão.

4. Verificar

Duas camadas, ambas obrigatórias:

• Determinística. Execute: python3 scripts/check_copy.py DELIVERABLE.md (léxico proibido + limites de palavra/caractere incorporados; sai com código não zero em caso de falha). Em seguida, execute python3 scripts/check_copy.py DELIVERABLE.md --urls para produzir a planilha de citações para a passagem de verificação de fatos. Adicione termos proibidos específicos do projeto com --lexicon FILE. Plano B sem execução: se você não puder executar scripts nesta superfície, aplique o léxico proibido e os orçamentos check: do modelo manualmente, e registre na lista de verificação que a passagem determinística foi manual, não scriptada.
• Adversarial. Passagens de revisão independentes por references/verification.md: (a) verificação de fatos na web que re-obtém cada URL citada e testa a redação exata da cópia contra ela, (b) verificação de fidelidade interna contra a base de fatos, (c) verificação de restrições/conformidade, (d) leitura de persona de comprador cético, (e) triagem de similaridade com concorrentes. Corrija todos os bloqueadores; re-execute as verificações determinísticas após edições.

5. Publicar

Marque a lista de verificação de auto-revisão da entrega honestamente — um item de lista de verificação que um revisor pode falsear causa mais dano do que o defeito que esconde. Superficie cada item [Decisão em aberto para o proprietário] em seu resumo de entrega. Se o projeto tiver um registro de alegações ou gate de revisão formal (jurídico, marca, estilo MLR), anexe as anotações e a planilha de citações — elas são construídas para serem revisadas (veja references/enterprise-integration.md).

Leis de Ferro

Citáveis individualmente; cite-as por número em revisões.

1. Rastreie ou corte. Alegações de produto rastreiam até a base de fatos; alegações externas rastreiam até uma URL obtida neste engajamento.
2. Busque antes de citar. Uma URL de memória é uma alegação não verificada vestindo uma citação.
3. Mecanismo é uma alegação. Cópia de como funciona, arquitetura, integrações, desempenho e termos comerciais precisam de fontes, exatamente como estatísticas.
4. Rotule o registro. Fato verificado / alegação interna / projeção / recomendação / julgamento — visível nas anotações.
5. A fonte define o teto. Sem atualizações de superlativo, sem mudanças de unidade, sem trocas de população, sem "estudos recentes" sem data.
6. Prova inventada nunca é publicada. Clientes, depoimentos, logotipos, estudos de caso, certificações, parcerias, métricas, resultados. Nos EUA, depoimentos e avaliações falsificados também são ilegais (16 CFR Partes 255 e 465).
7. Honestidade de estágio é estratégia. Declare claramente qual prova ainda não existe. A divulgação converte melhor com compradores céticos do que credibilidade emprestada — e é a única postura que sobrevive à diligência.
8. Desconhecidos são sinalizados, não preenchidos. Um fato não estabelecido se torna uma questão em aberto para o proprietário, nunca uma cópia plausível.

Racionalizações — todas significam pare

Desculpa	Realidade
"Vou adicionar uma nota para verificar antes do lançamento"	Verificação precede a redação. Um TODO não é fundamentação.
"Lembro-me desta estatística de um relatório conhecido"	Memória não é uma fonte. Obtenha ou corte.
"Descrever como o produto obviamente funciona não é uma alegação"	Descrições de mecanismo são alegações de capacidade; alegações implícitas contam.
"Termos concretos fazem a oferta parecer real"	Termos inventados se tornam contratos. Sinalize como uma decisão em aberto.
"É apenas texto provisório"	Textos provisórios são publicados. Marque-os inconfundivelmente ou não os escreva.
"A seção de franqueza prova que somos honestos"	Honestidade sobre clientes não licencia invenção em outro lugar.
"A estatística está aproximadamente certa"	Aproximação não é a alegação. Unidade, população e data são a alegação.
"A fonte está bloqueada, mas a cobertura secundária corresponde"	Pare de apresentá-la como primária. Re-roteie conforme o protocolo de fonte bloqueada em references/evidence-standards.md — utilizável apenas re-rotulada como verificado-secundário, com o bloqueio anotado.

Bandeiras Vermelhas — pare e refaça a fundamentação

• Uma estatística em seu rascunho que você não obteve pessoalmente neste engajamento
• Um detalhe do produto que você não consegue apontar na base de fatos
• Um superlativo ("maior", "primeiro", "único", "#1") não presente na fonte citada
• Um termo comercial (bloqueio, desconto, garantia, SLA) que o proprietário nunca declarou
• Uma citação que você apertou, fundiu ou reatribuiu
• Um item da lista de verificação que você está prestes a marcar e que um revisor poderia falsear

Roteamento de Referências

Leia	Quando
references/evidence-standards.md	Antes da pesquisa; ao julgar qualquer fonte; para o piso legal e o catálogo de armadilhas de evidência
references/copy-craft.md	Antes de escrever; para voz, léxico proibido, heróis, arquitetura de seção, prova de honestidade de estágio, metadados
references/verification.md	Antes da etapa de verificação; define o painel de revisão adversarial e o protocolo de correção
references/enterprise-integration.md	Quando o cliente tem revisão de alegações, governança de marca ou requisitos de indústria regulamentada

Modelos: templates/fact-base-template.md (preencha primeiro), templates/deliverable-template.md (escreva nele). Script: execute scripts/check_copy.py (não o leia no contexto; seu --help e saída são autoexplicativos).

Esta skill governa alegações e evidências. Ela deliberadamente não substitui o guia de voz de marca de uma empresa — ela é uma camada abaixo dele (veja references/enterprise-integration.md). Nada disso é aconselhamento jurídico; indústrias regulamentadas encaminham a cópia final através de aconselhamento jurídico.