Communitygithub.com

october-academy/agnt

Guia de estratégia de landing page — Integração de VOC, 15+ fórmulas de headline, Anti-AI-slop. Use ao planejar/criar estratégias de landing page.

O que é agnt?

O agnt é uma skill para agentes de IA (como Claude Code, Coder, etc.) que fornece um guia completo para criar landing pages de alta conversão, com foco em estratégia e copywriting, evitando o 'cheiro de IA'. A skill integra Voice of Customer (VOC) a partir de entrevistas, utiliza mais de 15 fórmulas comprovadas de headline, e aplica verificações como o Anti-AI-slop e o Seven Sweeps para garantir qualidade. Ela suporta múltiplas plataformas (Claude, Codex) e gerencia automaticamente seus arquivos de estado e journey-brief, além de fornecer benchmarks de conversão e orientação específica para diferentes fontes de tráfego (redes sociais, busca, comunidades, anúncios). É ideal para founders e profissionais de produto que querem criar landing pages que realmente vendam, sem depender de templates genéricos.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/october-academy/agnt/tree/HEAD/skills/landing

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Guia de estratégia de landing page. Use insights de entrevistas e fórmulas de copy para projetar landing pages que vendem.

Determinação do caminho dos dados

AGNT_DIR

  1. Tente ler .claude/agnt/state.json → sucesso: AGNT_DIR = .claude/agnt
  2. Se falhar, tente ler ~/.claude/agnt/state.json → sucesso: AGNT_DIR = ~/.claude/agnt
  3. Se falhar, tente ler .codex/agnt/state.json → sucesso: AGNT_DIR = .codex/agnt
  4. Se falhar, tente ler ~/.codex/agnt/state.json → sucesso: AGNT_DIR = ~/.codex/agnt
  5. Se nenhum existir → exiba "Comece executando /agnt:start." e encerre

REFS_DIR

Verifique a existência de {AGNT_DIR}/references/shared/navigator-engine.md.

Regras de saída

A lógica interna (navegação de caminhos, parsing de state, busca MCP) deve ser silenciosa.

Procedimento de execução

1. Verificação de pré-condições

Leia {AGNT_DIR}/state.json.

  • meta.schema_version != 3 → oriente com /agnt:start e encerre
  • project.problem == null → encerre com "Primeiro defina o problema com /agnt:discover."
  • artifacts.spec_versions < 1 → "Dá para seguir sem SPEC, mas organizar com /agnt:spec deixa o copy da landing mais claro." (não obrigatório — pode prosseguir)

2. Coleta de contexto (integração VOC)

Leia do state:

  • project.problem — problema que está resolvendo
  • project.icp — cliente ideal
  • project.hypothesis — hipótese

Tente ler o arquivo SPEC: {AGNT_DIR}/specs/spec-v*.md (versão mais recente). Se não houver, prossiga com base no state.

Tente ler {AGNT_DIR}/journey-brief.md.

  • Se houver seção ## Interview, extraia insights da entrevista (linguagem do cliente, expressões de dor, descobertas surpreendentes)
  • Se houver seção ## Audit, extraia informações de Track + Simplifier Insight
  • Se houver seção ## Compete, extraia resultados de análise competitiva

Regra de uso do VOC (Voice of Customer):

  • Use as expressões reais dos clientes vindas das entrevistas no copy. Não parafraseie.
  • As palavras que o cliente usou são sempre melhores que termos de marketing.
  • Se não houver dados de entrevista, prossiga com os dados do projeto (não obrigatório).

3. Contexto de tráfego

AskUserQuestion: "Onde você acha que as pessoas vão ver esta landing?"

  • A) Compartilhamento de link em redes sociais (Threads, Twitter, Facebook)
  • B) Tráfego de busca (Google, Naver)
  • C) Postagens em comunidades (Discord, Kakao, Slack)
  • D) Anúncios (Meta, Google Ads)
  • E) Ainda não sei

Ajuste de copy por contexto de tráfego:

  • Redes sociais: o headline se torna o texto do compartilhamento → desperte curiosidade + seja específico
  • Busca: a palavra-chave deve estar no H1
  • Comunidades: ordem de importância: identificação com o problema → solução
  • Anúncios: consistência entre copy do anúncio e mensagem da landing (Message Match)

4. Criação de headlines

Leia {REFS_DIR}/copywriting/copy-frameworks.md.

Saída:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Estratégia de Landing Page
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

O objetivo de uma landing é fazer com que alguém que vê seu produto pela primeira vez
sinta, em 3 segundos: "Isso é para mim."

Problema: {project.problem}
ICP: {project.icp}

Gere 3 headlines com base no contexto:

Escolha 3 categorias entre as mais de 15 fórmulas do copy-frameworks.md que se adequem ao projeto e crie rascunhos de headline para cada uma:

📝 Rascunhos de headline (3)

A) [Focado em Resultado]
   "{Valor central} para {ICP}"
   Justificativa: {por que escolheu esta fórmula}

B) [Focado em Problema]
   "Cansado de {problema}?"
   Justificativa: {insight de entrevista ou baseado no state}

C) [Focado em Especificidade]
   "{Método/tempo/público específico}"
   Justificativa: {se houver dados reais, use números; senão, apenas especificidade sem números}

AskUserQuestion: "Qual direção parece mais certa? (A/B/C) Ou quer ajustar algo?"

5. Subheadline + Estrutura da página

Com base no headline escolhido, crie o subheadline:

Subhead: A fraqueza da alternativa atual → como somos diferentes
Fórmula: "Antes era {alternativa atual}. Em vez disso, {nosso diferencial}."

Guia de estrutura com 11 seções:

📋 Estrutura da landing (nesta ordem)

1. ▶ Hero — Headline + Subhead + Botão CTA
   → Deve ser visível sem scroll. CTA obrigatório.

2. Barra de Prova Social — apenas o que existe (nada falso)
   → Números, logos, depoimento de uma linha. Se não houver, omita a seção.

3. Problema — o problema do ICP, de forma específica
   {se houver dados de entrevista}
   → "Nas entrevistas, surgiu esta expressão: '{expressão real}'"
   {senão}
   → "Você não está perdendo tempo com...?"

4. Como Funciona — no máximo 3 etapas
   → Simplifique o complexo. Cada etapa em uma frase.

5. Principais Benefícios — 2-3 (não funcionalidades, sim transformações)
   → Não "você pode fazer X", mas sim "você se torna Y"
   → Antes: {dor} → Depois: {estado resolvido}

6. Depoimento — citação real
   → Citação autorizada de participante de entrevista ou beta tester
   → Se não houver, omita esta seção (nada de provas falsas)

7. Casos de Uso / Personas — "Ideal para quem..."
   → 2-3 cenários de uso específicos

8. Comparação — diferença em relação às alternativas
   → Tabela ou Antes/Depois. Se houver análise competitiva, use-a.

9. Trecho de Case Study — resultado específico
   → "O usuário A recebeu o primeiro pagamento em 2 semanas"
   → Se não houver, omita.

10. FAQ — objeções (3-5)
    → Motivos mais comuns: "É caro", "Não tenho tempo", "Já uso outra ferramenta"

11. ▶ CTA Final — garantia + chamada para ação
    → Mesmo CTA do Hero. Adicione frase de redução de ansiedade.

6. Design do CTA

🎯 Design do CTA

Fórmula: [Verbo de Ação] + [O Que Eles Obtêm] + [Qualificador]

No seu caso:
  Objetivo: {recomendação com base no contexto de tráfego}
  CTA recomendado: "{texto específico do CTA}"

Verificação de CTA forte/fraco:

✅ CTA forte:
  "Começar teste grátis" / "Participar do sprint de 30 dias"
  "Começar com {nome do produto}" / "Receber o guia"

❌ CTA fraco (evitar):
  "Enviar" / "Inscrever-se" / "Saiba mais" / "Começar" / "Clique aqui"

7. Verificação das Quatro Forças do JTBD

Consulte a seção JTBD Four Forces em {REFS_DIR}/copywriting/copy-frameworks.md.

🔄 Verificação psicológica de conversão

Push (insatisfação atual):  Seu copy aborda isso? → {seção Problema}
Pull (nova atração):   Seu copy mostra isso? → {seção Benefícios}
Hábito (inércia):    Seu copy quebra isso? → {seção Comparação}
Ansiedade (medo):  Seu copy alivia isso? → {seção FAQ + garantia}

{se alguma Força estiver faltando}
⚠️ A força {Força} está faltando no seu copy. Deve ser tratada em {seção correspondente}.

8. Verificação Anti-AI-Slop

Leia {REFS_DIR}/copywriting/anti-ai-slop.md.

🚫 Verificação de eliminação de cheiro de IA

Se você evitar apenas isto no copy, já estará no top 50%:

• Uso excessivo de travessão (—) → substitua por vírgula ou ponto final
• "Inovador", "Abrangente", "Excelente" → use resultados específicos
• "Lista de funcionalidades" → mostre como a funcionalidade resolve o problema
• Jargão que o ICP não conhece → use a linguagem do cliente
• Landing sem CTA → página bonita de apresentação ≠ landing
• Listas de 3 itens → hábito de IA. Use 2 ou 4 itens.

9. Orientação sobre Seven Sweeps (usar após finalizar o copy)

📊 Verificação de qualidade do copy (Seven Sweeps)

Depois de escrever todo o copy, verifique estas 7 dimensões.
Agora é só estruturar; quando terminar o copy,
 execute `/agnt:landing` novamente que vou verificar com Seven Sweeps.

1. Clareza     — Uma criança do ensino fundamental entende?
2. Voz         — Tom consistente? Sem cheiro de IA?
3. E daí?     — Cada frase responde "Por quê?"
4. Prove      — As afirmações têm evidências?
5. Especificidade — Em vez de "muitos", use números?
6. Emoção     — Sensação de "Isso é sobre mim"?
7. Risco Zero — Removeu motivos para não agir?

Detalhes: {REFS_DIR}/copywriting/seven-sweeps.md

Quando reexecutar com copy finalizado: Leia {REFS_DIR}/copywriting/seven-sweeps.md e aplique cada sweep ao copy, fornecendo feedback específico.

10. Benchmark

Leia {REFS_DIR}/benchmarks/conversion-benchmarks.md.

📊 Referências de desempenho — "Está indo bem?"

Visita → coleta de e-mail: 5-15% é normal (100 visitas, 5-15 coletas)
Visita → compra paga: 1-3% é normal (100 visitas, 1-3 compras)

Não julgue a taxa de conversão com menos de 100 visitas.
Só faz sentido com pelo menos 200-300 dados acumulados.

Taxa de conversão < 1% → Reavalie a oferta ou o headline
Taxa de conversão 1-3% → Mediano (há espaço para otimização)
Taxa de conversão 3-5% → Bom (aumente o tráfego)
Taxa de conversão 5%+ → Excelente

11. Preparação para execução/validação

AskUserQuestion: "Em que estágio você está agora?"

  • A) Já tenho um rascunho/página que posso tornar pública
  • B) Só defini a estratégia de copy, ainda não criei nada
  • C) Apenas estruturei as seções

Se escolher A:

Ótimo. Agora o foco não é subir no ar, mas sim alinhar a mensagem.
A URL pública pode ser inserida em `/agnt:channel` ou `/agnt:launch-copy` quando precisar.
Próximo passo: /agnt:channel — decidir onde exibir

Se escolher B:

Ótimo. Com a direção do copy definida, é só criar o rascunho.
Pode ser no Notion, Carrd, codificando direto, ou alterando um site existente — qualquer um serve.

Próximos passos:
- Para definir o canal de publicação primeiro: `/agnt:channel`
- Para uma auditoria de SEO/GEO: `/agnt:seo-audit`

Se escolher C:

Tudo bem. Não precisa ser perfeito.
A versão mínima é Hero → Problema → CTA. Essas 3 seções já bastam.

Depois de refinar a estrutura, você pode executar `/agnt:landing` novamente para revisar o copy.

Em todos os casos (A/B/C), salve a nota estratégica no journey-brief.md (veja 11-bis abaixo).

11-bis. Escrever em journey-brief.md

Execute para A/B/C (salvar nota estratégica):

Tente ler {AGNT_DIR}/journey-brief.md.

Se o arquivo não existir: Crie um novo usando o template journey-brief do navigator-engine.md. Se o arquivo existir: Substitua as linhas - Headline:, - CTA:, - Fonte de tráfego: na seção ## Market.

- Headline: {headline escolhido}
- CTA: {CTA definido}
- Fonte de tráfego: {contexto de tráfego escolhido}

12. Atualização do state

Atualize state.json:

  • meta.last_action = "landing"
  • meta.total_actions++

Não registre flags de conclusão de deploy, registro de URL ou execução automática subsequente.

Regras

  • agnt não cria nem faz deploy da landing no lugar do usuário — quem faz é o ICP
  • O guia deve ser curto e direto — não teoria de marketing, mas instruções práticas
  • Se houver SPEC, use-a; senão, prossiga com base no state (não obrigatório)
  • Se houver dados de entrevista, use a linguagem do cliente diretamente no copy
  • Headlines devem sempre apresentar 3 alternativas e justificar a escolha
  • Seven Sweeps só se aplica após o rascunho do copy estar completo
  • Aplique as regras Anti-AI-slop — copy com cheiro de IA reduz a taxa de conversão
  • Proibido provas falsas — se não houver depoimentos, números ou cases, omita a seção
  • Benchmarks servem para informar a "faixa normal" — não são critérios absolutos
  • Esta skill salva apenas notas de estratégia/copy, não registra estado de conclusão de deploy ou execução automática subsequente
  • Em português, tom informal e direto

Habilidades Relacionadas