🧬 Anatomía de un prompt de entregable
Los 15 prompts no son improvisados: todos siguen el mismo esquema. Conocer este molde es lo que te permite editar cualquiera e incluso crear nuevos entregables sin romper el pipeline. Gemini recibe el contexto (investigación + cheat sheets) y luego el prompt con esta estructura.
// estructura de un prompt de entregable (ej.: tech_inventory)
# Task: Generate Technology Inventory & Data Infrastructure Assessment Based on the company research and context provided above, create a comprehensive technology inventory document. ## Required Sections ### 1. Executive Summary - Current landscape, key gaps, AI-readiness (high-level) ### 2. Current Technology Stack | Category | Tool/Platform | Purpose | AI-Ready | Data Integration | |----------|--------------|---------|----------|------------------| ### 3. Data Infrastructure Assessment ... ### 5. AI Readiness Assessment (tabela 1-5 por dimensão) ### 6. Recommendations (0-30 / 30-90 / 90+ dias) ## Output Format - Use markdown; include tables; note assumptions; keep it actionable
💡 Por qué una tabla y por qué "above"
Las tablas obligan al modelo a estructurar, y la estructura es lo que hace que el documento parezca de consultoría. El "research and context above" es el gancho: la Fase 1 y las cheat sheets de la Trilha 2 se incorporan antes del prompt, entonces el modelo escribe sobre hechos reales, no en el vacío.
el objetivo
la estructura
las reglas
viene "above"
🔬 Evaluación: dónde está la empresa
El primer grupo diagnostica. Son tres prompts que establecen la base factual de todo el paquete: sin una evaluación honesta, la hoja de ruta se convierte en una conjetura y el ROI, en ficción.
📦 Tech Inventory
Stack actual en una tabla (AI-Ready, integración) + evaluación de preparación por dimensión.
😣 Pain Points
Matriz de problemas por departamento — dónde duele y cuánto cuesta hoy.
📊 Madurez
Modelo de madurez y preparación para IA en una escala del 1 al 5.
💡 La evaluación alimenta el resto
Fíjate en la cadena: la maturity y los pain points se incorporan como contexto de los prompts de planificación. Los prompts no son islas: cada uno se apoya en lo anterior ("based on the ... above").
el stack
por departamento
escala 1-5
factual
🧭 Planificación: qué hacer y cuánto rinde
El segundo grupo transforma el diagnóstico en un plan. Es la parte que el cliente abre el lunes y ejecuta — roadmap por fases, victorias rápidas y el cálculo del retorno.
Roadmap 30/60/90/180/360
Fases con hitos y dependencias. El camino del piloto a la escala, con fechas.
Quick Wins (esfuerzo × impacto)
Top 10 iniciativas de <60 días, <US$50K, de bajo riesgo, con pasos semana a semana y KPIs.
ROI Calculator
Inversión × ganancias (eficiencia, ingresos, riesgo), payback, NPV de 3 años y escenarios (base/conservador/optimista).
📊 Qué ofrece el ROI Calculator
- •ROI simple año 1 + payback en meses.
- •NPV de 3 años con una tasa de descuento del 10%.
- •Benchmarks del sector (promedio frente al cuartil superior) para dar una referencia.
por fases
<60 días
payback + NPV
con cifras
🔩 Implementación: las decisiones concretas
El tercer grupo acerca el plan a la realidad operativa. Es donde la estrategia se convierte en decisión de compra y de uso: qué construir, qué comprar, dónde recortar licencias y qué casos ejecutar en cada departamento.
🏗️ Build vs Buy
Comparación de proveedores y frameworks para decidir si construir o comprar.
🧾 Consolidar licencias
Dónde se superponen las herramientas y cuánto se puede ahorrar al combinarlas.
🧩 Casos de uso
Biblioteca de casos de IA específicos por departamento, listos para priorizar.
✓ Cuándo comprar (buy)
- ✓Problema común, ya resuelto por un SaaS maduro
- ✓Para un equipo pequeño, importa un time-to-value corto
- ✓No es una ventaja competitiva de la empresa
✗ Cuándo construir (build)
- →Es el núcleo del negocio y se convierte en una ventaja
- →Ningún proveedor atiende el caso específico
- →Los datos sensibles requieren control total
💡 Licencia consolidada = quick win de caja
La consolidación de licencias suele pagar el proyecto entero: muchas empresas tienen tres herramientas que hacen lo mismo. Eliminar redundancias genera un ahorro inmediato y un argumento de venta sólido.
la decisión
reducir costos
por departamento
con los pies en la tierra
🛡️ Gobernanza: lo que sostiene el programa
El cuarto grupo es lo que distingue un piloto aislado de un programa serio. La gobernanza es la parte que el área legal y RR. HH. exigen — y que le da al cliente la seguridad para escalar la IA sin hacerse daño.
Política de IA (uso aceptable)
Qué se puede hacer y qué no: herramientas aprobadas, datos permitidos, supervisión humana.
Gobernanza de datos
Privacidad, clasificación de datos y cumplimiento (GDPR/LGPD) — la base de confianza para usar IA.
Gestión del cambio
Manual de capacitación y adopción: la tecnología falla cuando las personas no se suman.
💡 La gobernanza genera confianza
Mucha gente entrega solo el «qué» (roadmap) y se olvida del «cómo sostenerlo». Incluir políticas, datos y cambio en el paquete demuestra madurez, y es lo que hace que el comité ejecutivo apruebe la inversión.
uso aceptable
LGPD/GDPR
adopción
programa serio
🇧🇷 Recursos + adaptar al portugués de Brasil
El quinto grupo deja al cliente autónomo después de la entrega: una biblioteca de prompts para que la use en el día a día y un glosario de términos. Y aquí entra el detalle que vende en Brasil: adaptar el output al portugués.
📚 Prompt Library
Kit inicial de prompts listos por área: el cliente sigue obteniendo valor sin ti.
📖 Glosario
Términos de IA explicados en lenguaje de negocios: nivelan la conversación con el board.
// adaptar al PT-BR: instrucción de idioma en el contexto de Gemini
# INSTRUÇÃO DE IDIOMA (entra antes das Required Sections) Escreva TODO o documento em português do Brasil (PT-BR). Mantenha termos técnicos consagrados em inglês entre parênteses na primeira menção, ex.: "vitórias rápidas (quick wins)". Use R$ e formato de data DD/MM/AAAA. Tom direto e sóbrio.
✓ Adaptación que funciona
- ✓Instrucción de idioma al principio, no al final
- ✓Términos técnicos preservados entre paréntesis
- ✓R$, LGPD y contexto de Brasil en los ejemplos
✗ Traducción literal
- ✗Traducir todo literalmente («ventanas rápidas»)
- ✗Mantener GDPR/US$ en un paquete brasileño
- ✗Mezclar idiomas en el mismo párrafo
💡 Editar el prompt > pos traducir
Como todos los prompts comparten la misma estructura, basta con pegar la instrucción de idioma una vez en el context_builder y los 15 salen en PT-BR. Adaptar desde el origen es más limpio que traducir el documento una vez terminado.
el cliente usa
nivela el board
en el origen
posterior a la entrega
✅ Resumen del módulo
🎯 Misión 4.2 — Adapta 1 prompt y genera el markdown
Elige un entregable (p. ej.: quick_wins), adáptalo al portugués de Brasil y genera el documento para la empresa del módulo 4.1.
- Abre el prompt original en
synthesis/prompts/e identifica Task / Sections / Format. - Agrega la instrucción de idioma PT-BR en la parte superior del contexto.
- Pídele a Claude Code que genere este entregable usando el
research_cache.jsonde la Misión 4.1. - Revisa el markdown: tablas completas, términos técnicos entre paréntesis, R$ en lugar de US$.
Éxito: uno .md de un entregable en portugués, estructurado y basado en la investigación. Lo que obtuviste: un prompt tuyo, en PT-BR, listo para entrar en el pipeline de la Fábrica.
Siguiente módulo:
4.3 — Orquestación, reanudación y diagramas que venden (state.json, resume y Mermaid → PNG)