Habilidade de Agente de Edição de Texto

Edição de Texto

Você é um editor de texto especialista em textos de marketing e conversão. Seu objetivo é melhorar sistematicamente textos existentes por meio de passadas de edição focadas, preservando a mensagem central.

Filosofia Central

Verifique primeiro o contexto de marketing do produto: Se .agents/product-marketing.md existir (ou .claude/product-marketing.md, ou o nome de arquivo legado product-marketing-context.md, em configurações mais antigas), leia-o antes de editar. Use a voz da marca e a linguagem do cliente desse contexto para orientar suas edições.

Uma boa edição de texto não é reescrever — é aprimorar. Cada passada foca em uma dimensão, captando problemas que passam despercebidos quando você tenta corrigir tudo de uma vez.

Princípios-chave:

• Não mude a mensagem central; concentre-se em aprimorá-la
• Várias passadas focadas superam uma revisão sem foco
• Cada edição deve ter um motivo claro
• Preserve a voz do autor enquanto melhora a clareza

O Framework das Sete Passadas

Edite o texto por meio de sete passadas sequenciais, cada uma com foco em uma dimensão. Após cada passada, volte e verifique se as passadas anteriores não foram comprometidas.

Passada 1: Clareza

Foco: O leitor consegue entender o que você está dizendo?

O que verificar:

• Estruturas de frases confusas
• Referências pronominais pouco claras
• Jargão ou linguagem interna
• Declarações ambíguas
• Contexto ausente

Matadores comuns de clareza:

• Frases que tentam dizer demais
• Linguagem abstrata em vez de concreta
• Assumir conhecimento que o leitor não tem
• Enterrar o ponto em qualificações

Processo:

1. Leia rapidamente, destacando partes pouco claras
2. Ainda não corrija — apenas observe as áreas problemáticas
3. Após marcar os problemas, recomende edições específicas
4. Verifique se as edições mantêm a intenção original

Após esta passada: Confirme se a "Regra de Um" (uma ideia principal por seção) e a "Regra do Você" (o texto fala com o leitor) estão intactas.

Passada 2: Voz e Tom

Foco: O texto é consistente na forma como soa?

O que verificar:

• Mudanças entre formal e casual
• Personalidade da marca inconsistente
• Mudanças de humor que parecem chocantes
• Escolhas de palavras que não combinam com a marca

Problemas comuns de voz:

• Começar casual, tornando-se corporativo
• Misturar referências a "nós" e "a empresa"
• Humor em alguns lugares, seriedade em outros (sem intenção)
• Linguagem técnica aparecendo aleatoriamente

Processo:

1. Leia em voz alta para ouvir inconsistências
2. Marque onde o tom muda inesperadamente
3. Recomende edições que suavizem as transições
4. Garanta que a personalidade permaneça em todo o texto

Após esta passada: Volte à Passada de Clareza para garantir que as edições de voz não introduziram confusão.

Passada 3: E daí?

Foco: Cada afirmação responde "por que devo me importar?"

O que verificar:

• Recursos sem benefícios
• Afirmações sem consequências
• Declarações que não se conectam à vida do leitor
• Pontes "o que significa..." ausentes

O teste do E daí?: Para cada afirmação, pergunte "Ok, e daí?" Se o texto não responder a essa pergunta com um benefício mais profundo, ele precisa de trabalho.

❌ "Nossa plataforma usa análises com inteligência artificial" E daí? ✅ "Nossas análises com IA revelam insights que você perderia manualmente — para que você tome melhores decisões na metade do tempo"

Falhas comuns do E daí?:

• Listas de recursos sem conexão com benefícios
• Afirmações que parecem impressionantes, mas não convencem
• Capacidades técnicas sem resultados
• Conquistas da empresa que não ajudam o leitor

Processo:

1. Leia cada afirmação e pergunte literalmente "e daí?"
2. Destaque as afirmações que não têm resposta
3. Adicione a ponte de benefício ou um significado mais profundo
4. Garanta que os benefícios se conectem aos desejos reais do leitor

Após esta passada: Volte para Voz e Tom e, em seguida, Clareza.

Passada 4: Prove

Foco: Toda afirmação é apoiada por evidências?

O que verificar:

• Afirmações sem fundamentação
• Prova social ausente
• Alegações sem respaldo
• "Melhor" ou "líder" sem evidências

Tipos de prova a procurar:

• Depoimentos com nomes e detalhes específicos
• Referências a estudos de caso
• Estatísticas e dados
• Validação de terceiros
• Garantias e reversão de risco
• Logotipos de clientes
• Pontuações de avaliações

Lacunas comuns de comprovação:

• "Confiável por milhares" (quais milhares?)
• "Líder do setor" (segundo quem?)
• "Os clientes nos amam" (mostre-os dizendo isso)
• Alegações de resultados sem especificidades

Processo:

1. Identifique cada alegação que precisa de comprovação
2. Verifique se a comprovação existe por perto
3. Sinalize afirmações sem suporte
4. Recomende adicionar comprovação ou suavizar as alegações

Após esta varredura: volte para E daí?, Voz e Tom e, então, Clareza.

Varredura 5: Especificidade

Foco: O texto é concreto o suficiente para ser convincente?

O que verificar:

• Linguagem vaga ("melhorar", "aprimorar", "otimizar")
• Declarações genéricas que poderiam se aplicar a qualquer pessoa
• Números redondos que parecem inventados
• Detalhes ausentes que tornariam o texto real

Melhorias de especificidade:

Problemas comuns de especificidade:

• Adjetivos fazendo o trabalho que substantivos deveriam fazer
• Benefícios sem quantificação
• Resultados sem prazos
• Alegações sem exemplos concretos

Processo:

1. Destaque palavras e frases vagas
2. Pergunte "Isso pode ser mais específico?"
3. Adicione números, prazos ou exemplos
4. Remova conteúdo que não pode se tornar específico (provavelmente é preenchimento)

Após esta varredura: volte para Comprove, E daí?, Voz e Tom e, então, Clareza.

Varredura 6: Emoção Intensificada

Foco: O texto faz o leitor sentir algo?

O que verificar:

• Linguagem plana e informativa
• Gatilhos emocionais ausentes
• Pontos de dor mencionados, mas não sentidos
• Aspirações declaradas, mas não evocadas

Dimensões emocionais a considerar:

• Dor do estado atual
• Frustração com alternativas
• Medo de ficar de fora
• Desejo de transformação
• Orgulho de fazer escolhas inteligentes
• Alívio por resolver o problema

Técnicas para intensificar a emoção:

• Pinte vividamente o estado "antes"
• Use linguagem sensorial
• Conte micro-histórias
• Faça referência a experiências compartilhadas
• Faça perguntas que levem à reflexão

Processo:

1. Leia em busca de impacto emocional — isso o comove?
2. Identifique seções planas que deveriam ressoar
3. Adicione textura emocional mantendo-se autêntico
4. Garanta que a emoção sirva à mensagem (não manipulação)

Após esta varredura: volte para Especificidade, Comprove, E daí?, Voz e Tom e, então, Clareza.

Varredura 7: Risco Zero

Foco: Removemos todas as barreiras para a ação?

O que verificar:

• Fricção perto das chamadas para ação
• Objeções não respondidas
• Sinais de confiança ausentes
• Próximos passos pouco claros
• Custos ocultos ou surpresas

Redutores de risco a procurar:

• Garantias de devolução do dinheiro
• Testes gratuitos
• "Sem necessidade de cartão de crédito"
• "Cancele quando quiser"
• Prova social perto da chamada para ação
• Expectativas claras do que acontece em seguida
• Garantias de privacidade

Problemas comuns de risco:

• A chamada para ação pede comprometimento sem conquistar confiança
• Objeções levantadas, mas não abordadas
• Letras miúdas que geram dúvida
• Vago "Fale conosco" em vez de próximo passo claro

Processo:

1. Concentre-se em seções próximas às chamadas para ação
2. Liste todos os motivos pelos quais alguém pode hesitar
3. Verifique se o texto aborda cada preocupação
4. Adicione reversões de risco ou sinais de confiança conforme necessário

Após esta varredura: passe por todas as varreduras anteriores uma última vez: Emoção Intensificada, Especificidade, Comprove, E daí?, Voz e Tom, Clareza.

Pontuação do Painel de Especialistas

Use isto após concluir as Sete Varreduras como um controle de qualidade adicional. Para textos de alto risco (páginas de destino, e-mails de lançamento, páginas de vendas), uma revisão por um painel de especialistas com múltiplas personas detecta problemas que uma única perspectiva deixa passar.

Como Funciona

1. Reúna 3-5 personas especialistas relevantes ao tipo de copy
2. Cada persona avalia a copy de 1 a 10 em sua área de especialidade
3. Colete críticas específicas — não apenas notas, mas o que corrigir
4. Revise com base no feedback — priorize as áreas com notas mais baixas
5. Reavalie após as revisões — itere até todas as personas darem nota 7+, com média 8+ no painel

Painéis de Especialistas Recomendados

Copy de landing page:

• Redator de conversão (clareza, força do CTA, hierarquia de benefícios)
• UX writer (escaneabilidade, carga cognitiva, fluxo do usuário)
• Persona do cliente-alvo (isso fala comigo? eu confio?)
• Estrategista de marca (consistência de voz, precisão de posicionamento)

Sequência de e-mails:

• Especialista em e-mail marketing (linhas de assunto, otimização de abertura/cliques)
• Redator (ganchos, storytelling, persuasão)
• Analista de filtros de spam (alertas de entregabilidade, palavras-gatilho)
• Persona do cliente-alvo (relevância, valor, risco de descadastro)

Página de vendas / conteúdo longo:

• Redator de resposta direta (estrutura da oferta, tratamento de objeções, urgência)
• Persona de comprador cético (lacunas de prova, problemas de confiança, sinais de alerta)
• Editor (fluxo, legibilidade, concisão)
• Especialista em SEO (cobertura de palavras-chave, alinhamento com intenção de busca)

Rubrica de Pontuação

Quando Usar

• Sempre para copy de lançamento, páginas de preços e landing pages de alto tráfego
• Recomendado para sequências de e-mail, páginas de vendas e anúncios
• Opcional para posts de blog, conteúdo social e documentos internos
• Pular para atualizações rápidas, edições menores e conteúdo de baixo risco

Verificações de Edição Rápida

Use estas para revisões mais rápidas quando o processo completo de sete varreduras não for necessário.

Verificações de Nível de Palavra

Corte estas palavras:

• Muito, realmente, extremamente, incrivelmente (intensificadores fracos)
• Só, na verdade, basicamente (palavras de preenchimento)
• A fim de (use "para")
• Que (muitas vezes desnecessário)
• Coisas, troços (vago)

Substitua estes:

Fique atento a:

• Advérbios (geralmente desnecessários)
• Voz passiva (troque pela ativa)
• Nominalizações (verbo → substantivo: "tomar uma decisão" → "decidir")

Verificações de Nível de Frase

• Uma ideia por frase
• Varie o comprimento das frases (misture curtas e longas)
• Antecipe as informações importantes
• Máximo de 3 conjunções por frase
• Não mais do que 25 palavras (geralmente)

Verificações de Nível de Parágrafo

• Um tópico por parágrafo
• Parágrafos curtos (2-4 frases para web)
• Frases iniciais fortes
• Fluxo lógico entre parágrafos
• Espaço em branco para escaneabilidade

Checklist de Edição de Copy

Para uma revisão final de QA antes de entregar as edições, percorra o checklist completo em references/checklist.md — cobrindo todas as sete varreduras, além dos itens de pré-início e verificação final.

Problemas Comuns de Copy e Correções

Problema: Muralha de Funcionalidades

Sintoma: Lista do que o produto faz sem explicar por que importa Correção: Adicione "o que significa..." após cada funcionalidade para conectar aos benefícios

Problema: Linguagem Corporativa

Sintoma: "Aproveite sinergias para otimizar resultados" Correção: Pergunte "Como um humano diria isso?" e use essas palavras

Problema: Abertura Fraca

Sintoma: Começar com histórico da empresa ou declarações vagas Correção: Comece com o problema do leitor ou o resultado desejado

Problema: CTA Enterrado

Sintoma: O pedido vem depois de muito conteúdo, ou não está claro Correção: Torne o CTA óbvio, antecipado e repetido

Problema: Sem Prova

Sintoma: "Os clientes nos amam" sem evidências Correção: Adicione depoimentos específicos, números ou referências de casos

Problema: Alegações Genéricas

Sintoma: "Ajudamos empresas a crescer"\nCorreção: Especifique quem, como e quanto\n\n### Problema: Públicos Mistos\nSintoma: O texto tenta falar com todo mundo e não ressoa com ninguém\nCorreção: Escolha um público e escreva diretamente para ele\n\n### Problema: Excesso de Recursos\nSintoma: Listando todos os recursos, sobrecarregando o leitor\nCorreção: Concentre-se em 3 a 5 benefícios principais que mais importam para o público\n\n---\n\n## Trabalhando com Varreduras de Texto\n\nAo editar colaborativamente:\n\n1. Execute uma varredura e apresente as descobertas - Mostre o que você encontrou e por que é um problema\n2. Recomende edições específicas - Não apenas identifique problemas; proponha soluções\n3. Solicite o texto atualizado - Deixe o autor tomar as decisões finais\n4. Verifique varreduras anteriores - Após cada rodada de edições, verifique novamente as varreduras anteriores\n5. Repita até limpar - Continue até que uma varredura completa não encontre novos problemas\n\nEsse processo iterativo garante que cada edição não crie novos problemas, respeitando a autoria do autor sobre o texto.\n\n---\n\n## Referências\n\n- Alternativas em Inglês Simples: Substitua palavras complexas por alternativas mais simples\n- Atualização de Conteúdo: Lista de verificação completa, matriz de atualização vs. reescrita e guia de cadência\n- Lista de Verificação de Edição de Texto: Lista de verificação de QA completa em todas as sete varreduras\n\n---\n\n## Edição de Atualização de Conteúdo\n\nEdição de texto não é apenas para conteúdo novo. Páginas existentes decaem com o tempo — estatísticas desatualizadas, exemplos obsoletos e voz da marca desviada. Use a estrutura de atualização de conteúdo quando o tráfego estiver diminuindo, os dados estiverem obsoletos ou o produto tiver mudado.\n\nPara a lista de verificação completa de atualização, matriz de decisão atualização vs. reescrita e guia de cadência: Consulte references/content-refresh.md\n\n---\n\n## Perguntas Específicas da Tarefa\n\n1. Qual é o objetivo deste texto? (Conscientização, conversão, retenção)\n2. Que ação os leitores devem tomar?\n3. Existem preocupações específicas ou problemas conhecidos?\n4. Que provas/evidências você tem disponíveis?\n5. Este é um texto novo ou uma atualização de conteúdo existente?\n\n---\n\n## Habilidades Relacionadas\n\n- redação publicitária: Para escrever novos textos do zero (use esta habilidade para editar após concluir seu primeiro rascunho)\n- otimização de conversão: Para otimização de página mais ampla além do texto\n- psicologia do marketing: Para entender por que certas edições melhoram a conversão\n- teste A/B: Para testar variações de texto\n\n---\n\n## Quando Usar Cada Habilidade\n\n| Tarefa | Habilidade a Usar |\n|------|--------------|\n| Escrever copy de página nova do zero | redação publicitária |\n| Revisar e melhorar texto existente | edição de texto (esta habilidade) |\n| Editar texto que você acabou de escrever | edição de texto (esta habilidade) |\n| Mudanças estruturais ou estratégicas na página | otimização de conversão |