Hora de abrir a caixa-preta. Você vai entender as 3 fases por dentro, os dois arquivos que tornam tudo retomável e econômico (state.json e research_cache.json), como se recuperar de falhas e a estrutura exata da pasta output/.
Diagrama ilustrativo — as 3 fases em sequência, com o cache da pesquisa e o checkpoint de estado.
Tudo começa com a coleta de inteligência. Na primeira fase, a Perplexity faz de 9 a 18 buscas (conforme o modo) sobre a empresa e o setor. Essa é a matéria-prima de todos os documentos que vêm depois.
A qualidade da pesquisa define o teto de qualidade dos documentos. Por isso o --context e a escolha do modo (2.1 e 2.2) importam tanto: eles melhoram esta fase.
Com a pesquisa em mãos, o Gemini escreve os 15 documentos. O detalhe importante: eles são gerados em ordem de dependência — alguns só nascem depois que outros ficam prontos, porque usam o anterior como insumo.
# Exemplo simplificado da cadeia de dependência:
inventário técnico ─┐
dores ───┼─→ avaliação de maturidade ─→ roadmap ─→ quick wins
│
└─→ diagramas, ROI, governança, ...
# Um documento "downstream" lê os documentos "upstream"
# já prontos. Por isso não dá para gerar tudo em paralelo.Entre uma chamada e outra ao Gemini, há uma pausa de cerca de 5 segundos. Não é lentidão — é proteção: respeita os limites de requisições da API e evita o erro 429.
Se a síntese parecer "parada", provavelmente é a pausa de respeito ao limite. Deixe terminar — interromper aqui só faz você ter que usar o resume depois.
A última fase roda inteiramente no seu computador, sem custo. Ela transforma os textos em arquivos Office e renderiza os diagramas em imagem.
Monta os 2 PowerPoint com a biblioteca python-pptx.
Gera os 2 relatórios em Word a partir dos documentos.
Renderiza os diagramas Mermaid usando Chrome/Puppeteer.
Se os PNG não saírem, geralmente é o Chrome/Puppeteer que não está disponível. Os documentos em texto ainda ficam prontos — só a renderização das imagens depende dele.
Dentro da pasta de cada empresa existe um checkpoint: o state.json. Ele é o cérebro da retomada — guarda tudo o que a ferramenta precisa saber para continuar de onde parou.
{
"company": "Stripe",
"current_phase": "synthesis",
"deliverables_done": ["01_tech_inventory", "02_pain_points"],
"cost_spent_usd": 0.31,
"errors": []
}Estrutura ilustrativa — os campos reais podem variar, mas a ideia é esta: fase, prontos, custo e erros.
Se o state.json é o cérebro, o research_cache.json é o cofre: ele guarda a pesquisa bruta da Perplexity. Como a pesquisa é a parte que custa, esse cache é o seu maior aliado de economia.
# A primeira execução paga a pesquisa e a grava no cache
python -m strategy_factory.main run "Stripe"
# Mexeu num prompt e quer só regerar os documentos?
# Reusa o cache — não paga a pesquisa de novo:
python -m strategy_factory.main run "Stripe" --skip-researchLembre da Fase 3: a geração já é grátis. O grande gasto está na pesquisa (Fase 1). Reusá-la com --skip-research é o que faz seus experimentos custarem quase nada.
Falhas acontecem: você aperta Ctrl+C, cai a internet, ou estoura o limite da API. A boa notícia é que, graças ao state.json, você nunca perde o trabalho (nem o dinheiro) já feito.
# Caiu no meio? Apenas retome:
python -m strategy_factory.main resume "Stripe"
# Em erro 429 (limite atingido):
# 1. Espere alguns minutos
# 2. Rode o resume novamenteO state.json guardou o ponto. Rode resume e continue.
Reconecte e rode resume. A pesquisa já feita vem do cache.
Você bateu no teto da API. Espere alguns minutos para o limite renovar e rode resume.
Não tem problema rodar resume várias vezes: ele sempre olha o state.json e só faz o que ainda falta. Nunca refaz (nem cobra) o que já está pronto.
Tudo o que a ferramenta produz vai parar num lugar previsível: a pasta output/{slug}/, uma por empresa. Conhecer essa estrutura te deixa achar qualquer arquivo num instante.
output/stripe/
├── markdown/ # 15 documentos .md
├── presentations/ # 2 apresentações .pptx
├── documents/ # 2 relatórios .docx
├── mermaid_images/ # 5 diagramas .png
├── state.json # checkpoint (fase, custo, erros)
└── research_cache.json # pesquisa bruta da PerplexityTodos os documentos de texto: do inventário técnico ao plano de gestão da mudança. A Trilha 3 abre cada um.
Um resumo executivo e uma apresentação completa de achados.
O relatório de estratégia final e a proposta de trabalho.
Estado atual, estado futuro, fluxo de dados, roadmap e integração.
Cada empresa = uma pasta autossuficiente. Os entregáveis ficam separados por tipo, e os dois arquivos JSON guardam o estado e o cache. É tudo o que você precisa para entender, retomar e reaproveitar uma análise.
Trilha 3 — Entregáveis — agora que você domina a ferramenta por dentro, abra cada um dos 15 documentos e aprenda a usá-los na prática.