Cómo funciona la integración de IA del app — generación de plantillas, mejora de secciones, etiquetas de dominio.
AI#
GDD Manager integra modelos de lenguaje para acelerar tareas tediosas sin quitarle el control al diseñador. Siempre revisas antes de aceptar — la IA propone, tú decides.
Qué hace#
| Función | Cuándo se usa |
|---|---|
| Generación de plantilla | "Quiero un GDD inicial para un RPG de fantasía" → la IA genera una estructura completa con 5 grupos, atributos, personajes, economía y callouts didácticos |
| Contenido de sección | "Rellena esta página de Núcleo de Combate" → la IA escribe contenido respetando lo que ya existe |
| Mejora de prosa | Botón "Mejorar con IA" en cualquier richDoc — refina el texto sin cambiar el significado |
Proveedores compatibles#
El app admite 3 proveedores. Los eliges en Configuración → AI:
- Anthropic Claude (recomendado para GDDs largos — ventana de contexto grande)
- OpenAI GPT (equilibrio entre costo y velocidad)
- Groq (el más rápido, modelos más pequeños — ideal para prototipos)
Cada proveedor necesita tu API key (la creas en la consola del proveedor y la pegas en el app). Las keys se guardan solo en tu navegador — nunca las enviamos a nuestros servidores.
Principios de diseño#
La integración se construyó con 3 reglas:
1. Revisas antes de aceptar#
Toda generación de la IA aparece en modo vista previa. Lo lees, editas si quieres y haces clic en "Aceptar" para confirmarlo en el proyecto. Nada entra de forma automática. Si la sugerencia no te convence, la descartas.
2. La IA sabe que está en un GDD Manager#
Los prompts fueron ajustados para que entienda:
- Que un GDD se organiza en los cinco grupos canónicos (Visión General, Diseño, Contenido, Presentación, Producción)
- Que los conceptos importantes tienen página propia, citada con
$[...]en vez de repetida en el texto - Que los callouts tienen 4 variantes intencionales (nota / atención / decisión de diseño / nota de balanceo) — que se usan con criterio
- Que el doc es ficticio pero concreto — inventa nombres, números y escenarios (sin placeholders genéricos como "Personaje 1")
3. No inventa sistemas fuera del tema#
La restricción más fuerte del prompt es no añadir mecánicas que el usuario no pidió. ¿Pediste un juego de puzzles? Sin crafting. ¿Pediste una novela visual? Sin combate. La IA está obligada a respetar el alcance descrito.
Generación de plantilla completa#
La función más poderosa — describes tu juego en 3 frases y la IA genera el GDD inicial con:
- 5 grupos jerárquicos (Visión General, Diseño de Juego, Contenido, Presentación, Producción)
- Páginas tipadas dentro de cada grupo (atributos, personajes, ítems, economía)
- richDocBlocks con 3–5 callouts por página
attributeDefinitionsOverridescon stats coherentes con el género (RPG: HP/ATK/DEF/MAG/SPD ~100/10/5/8/5; Plataformas: HP/Speed/Jump ~3/1.0/1.5)domainTagsen cada sección (combat, economy, progression, etc.)dataIdsugerido por página
Tiempo típico: 30–60 segundos. Abres el GDD listo y empiezas a editar.
Ejemplo de entrada#
Tipo: Roguelike top-down
Descripción: Un mago explorador desciende 10 pisos de una torre con mazmorras
procedurales. Sistema de runas que se combinan para crear hechizos únicos.
La muerte es permanente, pero las runas raras desbloquean permanentemente
nuevas combinaciones para futuras partidas.
Información adicional: Pixel art, un jugador, enfoque en construcción de build.
Ejemplo de salida (estructura)#
📖 Visión General — Spire of Echoes
🎮 Diseño de Juego
├── Bucle Central
├── Mecánicas Principales
└── Progresión
📦 Contenido del Juego
├── 🎯 Atributos Base (HP, MP, Mana Regen, Speed, Crit%)
├── 👤 Mago Explorador (perfil + curva de xp + progresión)
├── 👤 Enemigo: Goblin de Piso (perfil)
├── ⚔️ Runa de Fuego (ítem con efecto)
├── ⚔️ Runa de Hielo
├── ⚡ Hechizo: Bola de Fuego (habilidad)
├── 🪙 Esencia (moneda permanente)
└── 🛠️ Mesa de Runas (craft table)
🎨 Presentación
└── Estilo Visual / UX / Audio
🏭 Producción
└── Tecnología / Roadmap / Riesgos / KPIs
Cada página viene con prosa rica, callouts que explican el vocabulario y referencias cruzadas entre los temas.
Mejora de prosa#
En la descripción de cualquier página, el botón "Mejorar con IA" envía el contenido actual más una solicitud de refinamiento (más conciso, más técnico, más visual, etc.) y devuelve una versión revisada. Comparas ambas versiones y aceptas o descartas.
Conectar Claude a tu GDD#
GDD Manager puede conectarse a Claude — en claude.ai, Claude Desktop o Claude Code. Una vez conectado, puede:
- Listar y leer el contenido de tus páginas
- Crear páginas nuevas y reorganizar el árbol
- Reescribir o completar descripciones, con las referencias
$[...]y las tablas en su lugar - Buscar por tema en todos tus proyectos
- Armar el diagrama de flujo de una página a partir de una descripción del flujo
Un escenario común: el programador de tu juego abre Claude, le pide que lea la página donde describiste el core loop, y ya implementa a partir de ahí. Ni siquiera necesitas mandarle el documento.
En claude.ai o Claude Desktop#
Sin clave y sin instalar nada — entras con tu propia cuenta de GDD Manager.
- En GDD Manager, abre el menú de tu cuenta → Conectar con Claude y copia la URL del conector
- En claude.ai (o Claude Desktop), ve a Settings → Connectors → Add custom connector
- Ponle un nombre (ej.: GDD Manager), pega la URL y haz clic en Connect
- Se abre una página de GDD Manager: inicia sesión con tu cuenta si te lo pide y haz clic en Autorizar
Listo. En un chat nuevo, prueba: "lista mis proyectos del GDD".
En Claude Code#
El mismo camino, desde la terminal, también sin clave. La página Conectar con Claude muestra el comando para copiar; después de ejecutarlo, escribe /mcp dentro de Claude Code, elige gdd-manager y Authenticate — el navegador abre GDD Manager para que inicies sesión y autorices.
Desconectar#
En la misma página, Aplicaciones conectadas lista todo lo que autorizaste. Desconectar corta el acceso al instante — para volver, solo conecta y autoriza de nuevo.
Privacidad#
- API keys: se guardan solo en tu navegador (localStorage). Nunca se envían a nuestros servidores.
- Contenido enviado a la IA: va directamente desde tu navegador al proveedor (Anthropic, OpenAI o Groq). Los servidores de GDD Manager no lo ven ni lo almacenan.
- Historial: no almacenamos ningún historial de uso de la IA.