Varnan-Tech/opendirectory

Flujo de Trabajo para Escribir un Artículo de Blog (cook-the-blog)

Sigue estos pasos exactamente cuando te pidan generar un caso de estudio para una empresa.

VERIFICACIÓN OBLIGATORIA DE CONFIGURACIÓN: Antes de empezar, asegúrate de tener configuradas las variables de entorno requeridas y los destinos objetivo (Repositorio de destino, Bucket de imágenes/Almacenamiento, correo del autor, etc.). Si falta alguno, DETENTE y pídele al usuario que los proporcione.

CONTROL DE CALIDAD OBLIGATORIO EN CADA PASO: Después de completar cada uno de los pasos siguientes, DEBES realizar una estricta verificación de calidad autocrítica. Si un paso falla o está alucinado, DEBES reintentarlo hasta que tenga éxito. No finjas éxito.

1. Investigación Profunda (Tavily)

• Utiliza la herramienta tavily (a través de MCP) y búsquedas web estándar para investigar a fondo la empresa. Nota: Siempre verifica si el nombre comercial registrado difiere del nombre del producto. Busca en Reddit y otros foros relevantes para obtener comentarios auténticos de desarrolladores.
• Verificador de calidad: ¿Realmente extrajiste métricas duras y detalles específicos sobre su estrategia de salida al mercado (GTM), o es contenido genérico? Si es genérico, investiga más a fondo.

2. Investigación de Palabras Clave SEO (Google Trends via SerpApi)

• Ejecuta el script de Python: export SERPAPI_KEY="[TU_SERPAPI_KEY]" && python3 [RUTA_DEL_SCRIPT_SEO] "[Nombre de la Empresa]"
• Identifica las palabras clave de alto crecimiento y despegue en el resultado.
• Verificador de calidad: ¿El script tuvo éxito? ¿Las palabras clave son reales y de alto volumen? Si no, reintenta o ajusta la consulta.

3. Generación de Título y Portada

• Título: Formato: "Cómo [Empresa] [Logró X] mediante [Estrategia Clave]". Hazlo específico y muy descriptivo.
• Portada: Utiliza el comando blog-cover-cli generate para generar la imagen de portada. CRÍTICO: El título pasado al generador de portada usando la bandera -t debe contener alrededor de 7 a 10 palabras en total. NO uses saltos de línea (\n) en la cadena. Simplemente proporciona una cadena normal de una sola línea y deja que la CLI maneje el ajuste de texto automáticamente. Escribe un título conciso y agresivo (p. ej., blog-cover-cli generate -t "Cómo Baseten escaló la infraestructura de IA hasta una valoración de 5 mil millones" -l "domain.com" -o "./cover.png").
• Verificador de calidad: ¿Se generó y guardó realmente la imagen? Verifica que el archivo exista.

4. Ensamblaje del MDX

Sintetiza la investigación y escribe el caso de estudio en un formato MDX estricto. Reglas de escritura (Usa la habilidad stop-slop):

• Tono: Incisivo, analítico, centrado en fundadores. Sin relleno. Cada oración debe enseñar algo.
• Audiencia: Fundadores de startups en etapa temprana, constructores de herramientas de IA/desarrolladores, entusiastas del growth impulsado por producto.
• Extensión: 1,200 a 1,800 palabras.
• Punto de vista: Análisis en tercera persona, como un memo de inversor inteligente escrito para una audiencia de constructores.
• No uses nunca guiones largos (—).
• Usa siempre inglés simple y conversacional con palabras de conexión. Evita la jerga corporativa ("sinergia", "apalancamiento", "juego de ecosistema", "disrupción" -> reemplázalos con lenguaje sencillo).
• Cada afirmación debe sentirse respaldada por evidencia o lógica. Usa números específicos.
• Cada sub-sección H3 debe comenzar con una oración conceptual, luego explicar el mecanismo y luego dar 1 ejemplo.
• No repitas el título en el cuerpo del MDX. El título solo debe estar en el frontmatter. NO incluyas un <h1> o # [Título] justo antes del TL;DR.
• Nunca escribas una sección de conclusión. Termina con el párrafo de conclusión o las FAQ.

El MDX debe seguir esta estructura exacta:

---
title: "Cómo [Empresa] [Logró X] mediante [Estrategia Clave]"
description: "[Resumen convincente de 1-2 oraciones con números concretos]"
date: "YYYY-MM-DD"
slug: "[slug-amigable-para-url-ej.-nombre-empresa-caso-de-estudio]"
image: "[URL_PÚBLICA_DE_LA_IMAGEN]"
readingTime: "[X] Min"
published: true
---

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

**TL;DR**
* **Desafío:** [El problema doloroso central que abordaron en el mercado]
* **Solución:** [Lo que construyeron o hicieron específicamente de manera diferente]
* **Resultados:** [2–3 métricas duras — descargas, ingresos, usuarios, % de crecimiento]
* **Inversión/Estrategia:** [La apuesta estratégica clave que hicieron]

## El Problema
[Describe el estado anterior: ¿Cómo era el mundo antes de la solución de esta empresa? ¿Quién sufría y qué se veía obligado a hacer en su lugar? Hazlo visceral, usa lenguaje de desarrollador/fundador. Extensión: 2-3 párrafos. Sin viñetas.]

## La Ejecución y Estrategia de Salida al Mercado (GTM)
[Divide en 2–4 sub-secciones H3 eligiendo entre: a) LA ESTRATEGIA DE DISTRIBUCIÓN, b) LA CAPA DE MONETIZACIÓN, c) EL FOSO TÉCNICO / DE PRODUCTO, d) EL MOMENTO DE DOGFOODING INTERNO, e) EL INSIGHT DE TIMING]
### [Sub-sección H3]
[Oración conceptual. Mecanismo. 1 Ejemplo.]

## Resultados y Conclusiones
[3–5 métricas duras en viñetas (descargas, ingresos, clientes, conversiones, tiempo ahorrado)]

**Lo que una pequeña startup puede aprender de ellos:**
[Conclusión accionable y específica, conectada directamente con la audiencia objetivo. Relaciona la lección directamente con la estrategia específica de la empresa. Sin consejos genéricos.]

---

## Preguntas Frecuentes

<FAQSection>
  <FAQItem question="[Pregunta AEO 1 - ej., ¿Cuál fue su principal estrategia de crecimiento?]">
    [Respuesta completa en 2-4 oraciones. Nunca la dejes vacía.]
  </FAQItem>

  <FAQItem question="[Pregunta AEO 2 - ej., ¿Cómo monetizan?]">
    [Respuesta completa en 2-4 oraciones. Nunca la dejes vacía.]
  </FAQItem>
  
  <FAQItem question="[Pregunta de Promoción - ej., ¿Cómo puede mi startup replicar esto?]">
    [Respuesta explicando la estrategia, seguida de un sutil gancho para tu marca/producto: "Si estás buscando construir un motor de distribución predecible como [Empresa], [TuMarca](https://tudominio.com) se especializa en diseñar estos bucles de crecimiento exactos. Reserva una llamada de estrategia para ver si encajas."]
  </FAQItem>
</FAQSection>

</div>

• Verificador de calidad: ¿Hay 0 guiones largos? ¿Tiene entre 1200 y 1800 palabras? ¿Hay métricas duras? Si no, reescribe.

5. Control de Calidad (QA)

Antes de continuar, vuelve a auditar el borrador:

• Reglas MDX: ¿Sigue estrictamente el formato MDX? ¿Hay exactamente cero guiones largos?
• Tono: ¿Es incisivo y analítico?
• Imagen de portada: ¿Está generada y lista?

6. Subida de Activos

• Sube la imagen de portada al bucket de almacenamiento preferido del usuario (ej., GCS, AWS S3, Cloudinary).
• Comando: Usa la herramienta CLI adecuada (ej., gsutil cp ./cover.png [BUCKET_DESTINO]).
• Verifica que la URL pública coincida con el campo image: en el MDX.
• Verificador de calidad: ¿La subida tuvo éxito? Verifica que la URL pública exista.

7. Publicación en GitHub (Push Directo)

• Usa la CLI de git para clonar el repositorio de destino: [URL_REPO_DESTINO]
• Mueve el archivo MDX generado al directorio de destino (ej., blogs/).
• Verificación de build: Antes de hacer commit, ejecuta el comando de build del proyecto (ej., npm install && npm run build) dentro del repositorio para asegurarte de que la sintaxis MDX no rompa el build.
• Configuración de Git: Asegúrate de hacer push con los datos del autor correctos. Ejecuta git config user.name "[NOMBRE_USUARIO_GIT]" y git config user.email "[CORREO_USUARIO_GIT]" antes de hacer commit.
• Haz commit de los cambios y haz push directamente a la rama remota de [URL_REPO_DESTINO] usando git pull upstream main --rebase && git push upstream main (o la estructura remota equivalente).
• Verificador de calidad: ¿El build pasó? ¿El push de git tuvo éxito? Si no, corrige los errores.

8. Verificación y Entrega

• NO TE SALTES ESTO: Antes de completar la tarea, DEBES ejecutar git log -1 y git status dentro del repositorio para demostrar que el archivo fue commiteado y pusheado.
• Tu respuesta final al usuario DEBE incluir:
  1. Un resumen detallado de la investigación de SerpApi (Google Trends).
  2. La URL pública de la imagen de portada subida.
  3. La salida real del comando git log -1 que demuestre que el trabajo está hecho.
• Notificación por correo electrónico: DEBES enviar también este mismo resumen final exacto por correo electrónico a [CORREO_ADMIN]. Puedes escribir y ejecutar rápidamente un script de Python usando smtplib para enviarlo desde el correo remitente configurado usando una Contraseña de Aplicación.
• Verificador de calidad final: ¿Enviaste el correo? ¿Incluiste el log de git en el mensaje final? Si no, has fallado todo el pipeline.