Varnan-Tech/opendirectory

Fluxo de Trabalho do "cook-the-blog"

Siga estas etapas exatamente quando for solicitado a gerar um estudo de caso para uma empresa.

VERIFICAÇAO DE CONFIGURAÇÃO OBRIGATÓRIA: Antes de começar, verifique se você possui as variáveis de ambiente necessárias e os destinos configurados (Repositório de Destino, Bucket/Storage de Imagens, Email do Autor, etc.). Se algum estiver faltando, PARE e peça ao usuário as informações.

VERIFICAÇÃO DE QUALIDADE (QA) OBRIGATÓRIA EM CADA ETAPA: Após completar cada etapa abaixo, você DEVE realizar uma verificação rigorosa e autocrítica de QA. Se uma etapa falhar ou for alucinada, você DEVE repeti-la até que tenha sucesso. Não finja sucesso.

1. Pesquisa Aprofundada (Tavily)

• Use a ferramenta tavily (via MCP) e pesquisas web padrão para pesquisar profundamente a empresa. Nota: Sempre verifique se o nome comercial registrado difere do nome do produto. Pesquise no Reddit e em outros fóruns relevantes por insights autênticos de desenvolvedores.
• Teste de QA: Você realmente extraiu métricas reais e detalhes específicos sobre a estratégia de GTM (Go-to-Market), ou são apenas palavras genéricas? Se for genérico, pesquise mais a fundo.

2. Pesquisa de Palavras-chave SEO (Google Trends via SerpApi)

• Execute o script python: export SERPAPI_KEY="[SUA_SERPAPI_KEY]" && python3 [CAMINHO_DO_SCRIPT_SEO] "[Nome da Empresa]"
• Identifique as palavras-chave em crescimento e destaque da saída.
• Teste de QA: O script foi bem-sucedido? As palavras-chave são reais e de alto volume? Se não, repita ou ajuste a consulta.

3. Título e Geração de Capa

• Título: Formato: "Como [Empresa] [Alcançou X] com [Estratégia Central]". Torne-o específico e altamente descritivo.
• Capa: Use o comando blog-cover-cli generate para gerar a imagem de capa. CRÍTICO: O título passado para o gerador de imagem de capa usando o sinalizador -t deve conter cerca de 7 a 10 palavras no total. NÃO use quebras de linha (\n) na string. Apenas forneça uma string normal e de linha única e deixe a CLI lidar automaticamente com a quebra de texto! Escreva um título conciso e agressivo (por exemplo, blog-cover-cli generate -t "Como a Baseten Escalou Infraestrutura de IA para uma Avaliação de 5 Bilhões" -l "domain.com" -o "./cover.png").
• Teste de QA: A imagem foi realmente gerada e salva? Verifique se o arquivo existe.

4. Montagem do MDX

Sintetize a pesquisa e escreva o estudo de caso em um formato MDX rigoroso. Regras de Escrita (Use a habilidade stop-slop):

• Tom: Afiado, analítico, focado no fundador. Sem enrolação. Cada frase deve ensinar algo.
• Público-alvo: Fundadores de startups em estágio inicial, construtores de ferramentas de IA/desenvolvedores, entusiastas de growth liderado por produto.
• Extensão: 1.200 a 1.800 palavras.
• Ponto de vista: Análise em terceira pessoa, como um memorando inteligente de investidor escrito para um público de construtores.
• Nunca use travessões (—).
• Sempre use inglês simples e conversacional com palavras de conexão. Evite jargões corporativos (substitua "sinergia", "alavancar", "jogo de ecossistema", "disrupção" por linguagem simples).
• Cada afirmação deve parecer apoiada por evidências ou lógica. Use números específicos.
• Cada subseção H3 deve começar com uma frase de conceito, depois explicar o mecanismo e, em seguida, dar um exemplo.
• Não repita o título no corpo do MDX. O título deve existir apenas no frontmatter. NÃO inclua um <h1> ou # [Título] logo antes do TL;DR.
• Nunca escreva uma seção de conclusão. Termine no parágrafo de takeaways ou no FAQ.

O MDX deve seguir esta estrutura exata:

---
title: "Como [Empresa] [Alcançou X] com [Estratégia Central]"
description: "[Resumo convincente de 1-2 frases com números concretos]"
date: "AAAA-MM-DD"
slug: "[slug-amigável-para-url-ex.-nome-da-empresa-case-study]"
image: "[URL_PÚBLICA_DA_IMAGEM]"
readingTime: "[X] Min"
published: true
---

<div style={{ textAlign: 'left' }}>

**TL;DR**
* **Desafio:** [O problema central e doloroso do mercado que eles resolveram]
* **Solução:** [O que eles especificamente construíram ou fizeram de diferente]
* **Resultados:** [2-3 métricas concretas — downloads, receita, usuários, crescimento %]
* **Investimento/Estratégia:** [A principal aposta estratégica que fizeram]

## O Problema
[Pinte o cenário anterior: Como era o mundo antes da solução desta empresa? Quem estava sofrendo e o que eram forçados a fazer? Torne visceral usando linguagem de desenvolvedor/fundador. Extensão: 2-3 parágrafos. Sem marcadores.]

## A Execução e a Estratégia GTM
[Divida em 2-4 subseções H3 escolhendo entre: a) A ESTRATÉGIA DE DISTRIBUIÇÃO, b) A CAMADA DE MONETIZAÇÃO, c) O DIFERENCIAL TÉCNICO / DE PRODUTO, d) O MOMENTO DE DOGFOODING INTERNO, e) A PERCEPÇÃO DE TIMING]
### [Subseção H3]
[Frase de conceito. Mecanismo. 1 Exemplo.]

## Os Resultados e Takeaways
[3-5 métricas concretas em marcadores (downloads, receita, clientes, conversões, tempo economizado)]

**O que uma startup pequena pode aprender com eles:**
[Takeaway acionável e específico diretamente conectado ao público-alvo. Amarre a lição à estratégia específica da empresa. Nenhum conselho genérico.]

---

## Perguntas Frequentes

<FAQSection>
  <FAQItem question="[Pergunta AEO 1 - Ex.: Qual foi a principal estratégia de crescimento deles?]">
    [Respondida completamente em 2-4 frases. Nunca deixe em branco.]
  </FAQItem>

  <FAQItem question="[Pergunta AEO 2 - Ex.: Como eles monetizam?]">
    [Respondida completamente em 2-4 frases. Nunca deixe em branco.]
  </FAQItem>
  
  <FAQItem question="[Pergunta de Promoção - Ex.: Como minha startup pode replicar isso?]">
    [Resposta explicando a estratégia, seguida por um pitch sutil para sua marca/produto: "Se você está procurando construir um motor de distribuição previsível como a [Empresa], a [SuaMarca](https://seudominio.com) é especializada em engenharia desses mesmos loops de crescimento. Agende uma call estratégica para ver se você se encaixa."]
  </FAQItem>
</FAQSection>

</div>

• Teste de QA: Existem 0 travessões? Tem entre 1200 e 1800 palavras? Existem métricas concretas? Se não, reescreva.

5. Verificação de Qualidade (QA)

Antes de prosseguir, faça uma autoauditoria do rascunho novamente:

• Regras MDX: Está seguindo rigorosamente o formato MDX? Existem exatamente zero travessões?
• Tom: É impactante e analítico?
• Imagem de Capa: A imagem foi gerada e está pronta?

6. Upload de Ativos

• Faça upload da imagem de capa para o bucket de armazenamento preferido do usuário (por exemplo, GCS, AWS S3, Cloudinary).
• Comando: Use a ferramenta CLI apropriada (por exemplo, gsutil cp ./cover.png [BUCKET_ALVO]).
• Verifique se a URL pública corresponde ao campo image: no MDX.
• Teste de QA: O upload foi bem-sucedido? Verifique se a URL pública existe.

7. Publicação no GitHub (Push Direto)

• Use o CLI git para clonar o repositório de destino: [URL_DO_REPO_ALVO]
• Mova o arquivo MDX gerado para o diretório de destino (por exemplo, blogs/).
• Verificação de Build: Antes de commitar, execute o comando de build do projeto (por exemplo, npm install && npm run build) dentro do repositório para garantir que a sintaxe MDX não quebre o build.
• Config Git: Certifique-se de que está enviando com os detalhes corretos do autor. Execute git config user.name "[NOME_DO_USUARIO_GIT]" e git config user.email "[EMAIL_DO_USUARIO_GIT]" antes de commitar.
• Faça commit das alterações e envie diretamente para o branch remoto de [URL_DO_REPO_ALVO] usando git pull upstream main --rebase && git push upstream main (ou a estrutura remota equivalente).
• Teste de QA: O build passou? O git push foi bem-sucedido? Se não, corrija os erros.

8. Verificação e Entrega

• NÃO PULE ESTA ETAPA: Antes de concluir a tarefa, você DEVE executar git log -1 e git status dentro do repositório para provar que o arquivo foi commitado e enviado.
• Sua resposta final para o usuário DEVE incluir:
  1. Um resumo detalhado da pesquisa SerpAPI (Google Trends).
  2. A URL pública da imagem de capa enviada.
  3. A saída real do comando git log -1 comprovando que o trabalho está feito.
• Notificação por Email: Você DEVE enviar este mesmo resumo final por email para [EMAIL_DO_ADMIN]. Você pode escrever e executar rapidamente um script Python usando smtplib para enviá-lo a partir do email do remetente configurado usando uma senha de aplicativo.
• Teste Final de QA: Você enviou o email? Incluiu o git log na mensagem final? Se não, você falhou em todo o pipeline.