🟣 Entregables y buenas prácticas

Qué es

Tres archivos que muestran la situación actual: 01_tech_inventory (la tecnología que la empresa ya usa), 02_pain_points (los dolores, área por área) y 04_maturity_assessment (una nota de madurez en IA, de 1 a 5).

Por qué aprender

Es el punto de partida de toda estrategia: solo sabes hacia dónde ir después de entender desde dónde partes. Sirven de base para el plan y el ROI.

Conceptos clave

• 01 = inventario de tecnología actual
• 02 = problemas identificados por departamento
• 04 = evaluación de madurez en IA (1 a 5)

Qué es

05_roadmap traza el camino por fases (30 / 60 / 90 / 180 / 360 días) y 06_quick_wins lista de 5 a 10 logros rápidos y de gran impacto para empezar ya.

Por qué aprender

Es la parte que se convierte en acción: la hoja de ruta ofrece la visión de todo el año; las quick wins muestran qué hacer la primera semana para generar resultados y confianza.

Conceptos clave

• 05 = plan por fases (30/60/90/180/360)
• 06 = logros rápidos de alto impacto
• Empieza por los quick wins para demostrar valor

Qué es

09_roi_calculator muestra la relación costo-beneficio y el tiempo de recuperación (payback); 07_vendor_comparison compara construir vs. comprar y trae una matriz de proveedores (OpenAI, Anthropic, Google...); 08_license_consolidation indica cómo combinar herramientas y ahorrar.

Por qué aprender

Es lo que convence a quien firma el cheque. La dirección piensa en cifras: retorno, plazo de amortización y dónde se puede reducir el gasto duplicado.

Conceptos clave

• 09 = costo-beneficio y período de recuperación
• 07 = construir vs. comprar + matriz de proveedores
• 08 = consolidar licencias y ahorrar

Qué es

10_ai_policy es la política de uso aceptable de IA en la empresa (qué se puede hacer y qué no); 11_data_governance se ocupa de la gestión, la seguridad y el cumplimiento normativo (compliance) de los datos.

Por qué aprender

Adoptar IA sin reglas es un riesgo. Estos dos documentos protegen a la empresa de filtraciones, uso indebido y problemas legales, y dan seguridad a los equipos para usarla.

Conceptos clave

• 10 = política de uso aceptable
• 11 = gestión, seguridad y cumplimiento de datos
• Reducen riesgos y le dan confianza al equipo

Qué es

Cuatro documentos para las personas: 12_prompt_library (prompts listos por área), 13_glossary (glosario para personas no técnicas), 14_use_case_library (casos de uso por área) y 15_change_management (plan de capacitación y adopción).

Por qué aprender

La estrategia solo funciona si las personas se suman. Estos documentos convierten el plan en algo que el equipo entiende, usa en el día a día y adopta de verdad.

Conceptos clave

• 12 = biblioteca de prompts por área
• 13 = glosario para personas no técnicas
• 14 = casos de uso · 15 = plan de adopción

Qué es

El documento 03_mermaid_diagrams no es un texto común: guarda el código (en lenguaje Mermaid) que, en la fase de Generación, se convierte en cinco imágenes PNG: estado actual, estado futuro, flujo de datos, roadmap e integración.

Por qué aprender

Saber que el markdown es la «fuente» y los PNG son el «resultado» ayuda a entender por qué a veces la imagen no se genera (tema de la Ruta 3.3) — y cómo editar el diagrama en el código.

Conceptos clave

• 03 = Markdown con el código Mermaid
• Se convierte en 5 PNGs en la fase de Generación
• current, future, data_flow, roadmap, integration

Qué es

La secuencia natural es: Diagnóstico → Plan → Finanzas → Gobernanza → Capacitación. Cada grupo prepara el siguiente, como una historia que empieza con el problema y termina con la ejecución.

Por qué aprender

No necesitas leer todo en orden para entenderlo, pero seguir la secuencia facilita explicar la estrategia a otras personas y preparar la presentación.

Conceptos clave

• Diagnóstico → Plan → Finanzas → Gobernanza → Capacitación
• El ejecutivo empieza por el resumen ejecutivo
• Después: roadmap (05) y ROI (09)

Qué es

El archivo executive_summary_deck.pptx es una presentación breve, de 10 a 15 diapositivas, pensada para el board (la junta directiva). Presenta solo la visión general: lo esencial, sin detalles técnicos.

Por qué aprender

Es el material que usas cuando tienes 15 minutos para convencer a quien toma las decisiones. Breve, directo y enfocado en valor y cifras.

Conceptos clave

• Archivo: executive_summary_deck.pptx
• 10-15 diapositivas, visión general
• Público: directiva / board

Qué es

El archivo full_findings_presentation.pptx es la versión completa, de 40 a 50 diapositivas, con todos los hallazgos y recomendaciones detallados: el análisis en profundidad del resumen ejecutivo.

Por qué aprender

Es ideal para el taller, la reunión técnica o cuando el equipo pide detalles. Es el material de consulta para quienes quieren ir más allá de la visión general.

Conceptos clave

• Archivo: full_findings_presentation.pptx
• 40-50 diapositivas, hallazgos + recomendaciones
• Público: equipo técnico / profundización

Qué es

El archivo final_strategy_report.docx es el informe escrito completo en Word: reúne todos los documentos compilados en un único texto continuo, listo para leer de principio a fin.

Por qué aprender

Es el documento «oficial» que entregas o archivas. Ideal para quien prefiere leer en vez de ver diapositivas, y fácil de editar en Word.

Conceptos clave

• Archivo: final_strategy_report.docx
• Todos los documentos compilados
• Formato Word, fácil de editar

Qué es

El archivo statement_of_work.docx es una propuesta de implementación (SOW): describe lo que se hará, con cronograma, recursos necesarios y costos estimados.

Por qué aprender

Es el puente entre la estrategia y la ejecución. Los consultores la usan como base de una propuesta comercial; los equipos internos, como plan de proyecto.

Conceptos clave

• Archivo: statement_of_work.docx
• Cronograma + recursos + costos
• Base de propuesta o de proyecto

Qué es

Cinco imágenes PNG listas para pegar en diapositivas: current_state (estado actual), future_state (estado futuro), data_flow (flujo de datos), roadmap e integration (integración).

Por qué aprender

Un diagrama vale más que mil palabras en una reunión. Estos PNG quedan en la carpeta mermaid_images/ y se pueden arrastrar directamente a la presentación.

Conceptos clave

• 5 PNGs: current, future, data_flow, roadmap, integration
• Quedan en mermaid_images/
• Listos para pegar en diapositivas

Qué es

Una guía sencilla para conducir la reunión: empieza por el resumen ejecutivo, muestra el diagnóstico, presenta la hoja de ruta y el ROI, y cierra con los quick wins (lo que se puede hacer ya).

Por qué aprender

Tener los archivos no basta — el orden de presentación marca la diferencia. Este flujo cuenta una historia: dónde estamos, hacia dónde vamos, cuánto rinde y por dónde empezar.

Conceptos clave

• Resumen → diagnóstico → hoja de ruta → ROI → quick wins
• Personaliza antes de presentar
• Revisa los números (es un borrador de IA)

Qué es

El error 401 significa "no autorizado": la clave es incorrecta o falta. Verifica si el archivo .env existe y si las claves tienen el formato correcto (pplx-... / AIzaSy...), sin espacios. Después, reinicia la app.

Por qué aprender

Es el error número uno de quienes empiezan. Casi siempre es un detalle tonto: un espacio de más, la clave pegada a medias o el archivo en el lugar equivocado.

Conceptos clave

• 401 = clave incorrecta o ausente
• Formato: pplx-... y AIzaSy..., sin espacios
• Reinicia la app después de corregir el .env

Qué es

El error "Module not found" generalmente significa que el entorno virtual (venv) no está activo. Activa el venv y ejecuta pip install -r requirements.txt. En Windows, comprueba también si Python está en el PATH.

Por qué aprender

Es fácil olvidarse de activar el venv al abrir una terminal nueva. Sin él, Python no encuentra las bibliotecas instaladas y avisa que faltan módulos.

Conceptos clave

• Activa el venv antes de ejecutar
• Reinstala: pip install -r requirements.txt
• Windows: Python debe estar en el PATH

Qué es

Si el puerto 8888 ya está en uso, la app encuentra automáticamente otro puerto disponible. Si prefieres elegir uno, ejecútala con --port 9000 (o cualquier otro número).

Por qué aprender

Este "problema" casi nunca te bloquea: solo es una advertencia. Saberlo evita que te asustes cuando la dirección en el navegador aparece con un número diferente.

Conceptos clave

• La app encuentra automáticamente un puerto libre
• Forzar: --port 9000
• No es un error grave

Qué es

El error 429 significa "muchas solicitudes": alcanzaste el límite de tasa de la API. Espera de 5 a 10 minutos y continúa desde donde te quedaste con el comando resume. Ya hay un delay de unos 5s incorporado entre las llamadas de Gemini.

Por qué aprender

No pierdes el trabajo: el resume aprovecha lo que ya se hizo. Esperar un poco casi siempre lo resuelve, sin necesidad de empezar desde cero.

Conceptos clave

• 429 = límite de solicitudes alcanzado
• Espera 5-10 min y ejecuta resume
• El delay de ~5s ya viene incorporado (Gemini)

Qué es

Si los diagramas se generan como PNG en blanco, por lo general falta Chrome (que usa Puppeteer para «tomar la foto» del diagrama). La solución es instalar Chrome en la computadora o ejecutar la herramienta mediante Docker.

Por qué aprender

Los documentos pueden salir perfectos y solo fallar las imágenes: es un problema aislado de la fase de Generación. Saber la causa evita pensar que "todo salió mal".

Conceptos clave

• PNG en blanco = falta Chrome/Puppeteer
• Instala Chrome en la computadora
• Alternativa: ejecutarlo vía Docker

Qué es

Cuatro hábitos: empieza en el modo rápido (quick), da un buen --context, analiza varias empresas rápidamente y profundiza solo en la elegida, y revisa siempre los resultados antes de usarla.

Por qué aprender

Estas prácticas ahorran dinero y mejoran mucho la calidad. La diferencia entre un borrador mediocre y uno excelente suele estar en el contexto y la revisión.

Conceptos clave

• Empieza en quick · proporciona un buen --context
• Haz un barrido rápido y profundiza en la elegida
• Revisa siempre antes de entregar

Qué es

La herramienta usa datos públicos (no datos confidenciales de la empresa); el resultado es un borrador que requiere revisión humana, y no es asesoría jurídica ni financiera definitiva. Controla el gasto con los comandos status e list.

Por qué aprender

Usarla con responsabilidad te protege a ti y a la empresa. Tratar el resultado como un borrador, y no como una verdad absoluta, es lo que mantiene la calidad y la confianza.

Conceptos clave

• Solo datos públicos · borrador con revisión humana
• No es asesoramiento legal/financiero definitivo
• Dar seguimiento al gasto con status / list