Es hora de abrir la caja negra. Vas a entender las 3 fases por dentro, los dos archivos que hacen que todo sea retomable y económico (state.json e research_cache.json), cómo recuperarse de fallas y la estructura exacta de la carpeta output/.
Diagrama ilustrativo — las 3 fases en secuencia, con la caché de la investigación y el punto de control del estado.
Todo empieza con la recopilación de información. En la primera fase, la Perplexity hace entre 9 y 18 búsquedas (según el modo) sobre la empresa y el sector. Esta es la materia prima de todos los documentos que vienen después.
La calidad de la investigación determina el límite de calidad de los documentos. Por eso, el --context y la elección del modo (2.1 y 2.2) también importan mucho: mejoran esta fase.
Con la investigación en mano, el Gemini escribe los 15 documentos. El detalle importante: se generan en orden de dependencia — algunos solo se crean cuando otros están listos, porque usan el 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 una llamada y otra a Gemini, hay una pausa de alrededor de 5 segundos. No es lentitud: es protección. Respeta los límites de solicitudes de la API y evita el error 429.
Si la síntesis parece «detenida», probablemente sea la pausa para respetar el límite. Deja que termine — interrumpirla aquí solo hace que tengas que usar el resume después.
La última fase se ejecuta por completo en tu computadora, sin costo. Convierte los textos en archivos de Office y renderiza los diagramas como imágenes.
Arma los 2 PowerPoint con la biblioteca python-pptx.
Genera los 2 informes en Word a partir de los documentos.
Renderiza los diagramas Mermaid usando Chrome/Puppeteer.
Si no se generan los PNG, por lo general es porque Chrome/Puppeteer no está disponible. Los documentos de texto igual quedan listos — solo la representación de las imágenes depende de ello.
Dentro de la carpeta de cada empresa hay un punto de control: o state.json. Es el cerebro de la reanudación — guarda todo lo que la herramienta necesita saber para continuar desde donde quedó.
{
"company": "Stripe",
"current_phase": "synthesis",
"deliverables_done": ["01_tech_inventory", "02_pain_points"],
"cost_spent_usd": 0.31,
"errors": []
}Estructura ilustrativa — los campos reales pueden variar, pero la idea es esta: fase, listos, costo y errores.
Si el state.json es el cerebro, el research_cache.json es la caja fuerte: guarda la investigación en bruto de Perplexity. Como la investigación es la parte que cuesta, esta caché es tu mayor aliada para ahorrar.
# 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-researchRecuerda la Fase 3: la generación ya es gratis. El mayor gasto está en la investigación (Fase 1). Reutilizarla con --skip-research es lo que hace que tus experimentos cuesten casi nada.
Los fallos ocurren: presionas Ctrl+C, se cae internet o se agota el límite de la API. La buena noticia es que, gracias a state.json, nunca pierdes el trabajo (ni el dinero) que ya invertiste.
# 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 guardó el punto. Ejecuta resume y continúa.
Vuelve a conectarte y ejecútalo resume. La investigación ya realizada proviene de la caché.
Llegaste al límite de la API. Espera unos minutos a que se renueve el límite y ejecuta resume.
No hay problema en ejecutar resume varias veces: siempre revisa el state.json y solo hace lo que todavía falta. Nunca vuelve a hacer (ni cobra) lo que ya está listo.
Todo lo que produce la herramienta va a parar a un lugar predecible: la carpeta output/{slug}/, uno por empresa. Conocer esta estructura te permite encontrar cualquier archivo en un 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 los documentos de texto: desde el inventario técnico hasta el plan de gestión del cambio. La Ruta 3 abre cada uno.
Un resumen ejecutivo y una presentación completa con los hallazgos.
El informe de estrategia final y la propuesta de trabajo.
Estado actual, estado futuro, flujo de datos, roadmap e integración.
Cada empresa = una carpeta autónoma. Los entregables quedan separados por tipo y los dos archivos JSON guardan el estado y la caché. Es todo lo que necesitas para entender, retomar y reutilizar un análisis.
Ruta 3 — Entregables — ahora que dominas la herramienta por dentro, abre cada uno de los 15 documentos y aprende a usarlos en la práctica.