AI#

O GDD Manager integra modelos de linguagem pra acelerar tarefas tediosas sem tirar o controle do designer. Você sempre revisa antes de aceitar — a IA propõe, você decide.

O que ela faz#

Provedores suportados#

O app suporta 3 provedores. Você escolhe em Configurações → AI:

• Anthropic Claude (recomendado pra GDDs longos — tem context window grande)
• OpenAI GPT (custo/velocidade balanceados)
• Groq (mais rápido, modelos menores — bom pra prototipagem)

Cada provedor precisa da sua API key (você cria no console do provedor e cola no app). As keys ficam só no seu navegador — nunca enviamos pra nossos servidores.

Princípios de design#

A integração foi projetada com 3 regras:

1. Você revisa antes de aceitar#

Toda geração da IA aparece em modo preview. Você lê, edita se quiser, e clica "Aceitar" pra commitar no projeto. Nada entra automaticamente. Se a sugestão não te convencer, descarta.

2. A IA sabe que está num GDD Manager#

Os prompts foram afinados pra ela entender:

• Que um GDD se organiza nos cinco grupos canônicos (Visão Geral, Design, Conteúdo, Apresentação, Produção)
• Que conceitos importantes viram página própria, citada com $[...] em vez de repetida no texto
• Que callouts têm 4 variantes intencionais (nota / atenção / decisão de design / nota de balanceamento) — usar com critério
• Que o doc é fictício mas concreto — inventa nomes, números, cenários (não placeholders genéricos tipo "Personagem 1")

3. Não inventa sistemas fora do tema#

O guardrail mais forte do prompt é não adicionar mecânicas que o usuário não pediu. Pediu jogo de puzzle? Não tem crafting. Pediu visual novel? Não tem combate. A IA é forçada a respeitar o escopo descrito.

Geração de template completo#

A funcionalidade mais poderosa — você descreve o jogo em 3 frases e a IA gera o GDD inicial com:

• 5 grupos hierárquicos (Visão Geral, Design de Jogo, Conteúdo, Apresentação, Produção)
• Páginas tipadas dentro de cada grupo (atributos, personagens, items, economia)
• richDocBlocks preenchidos com 3-5 callouts por página
• attributeDefinitionsOverrides com stats coerentes com o gênero (RPG: HP/ATK/DEF/MAG/SPD ~100/10/5/8/5; Platformer: HP/Speed/Jump ~3/1.0/1.5)
• domainTags em cada seção (combat, economy, progression, etc.)
• dataId sugerido por página

Tempo típico: 30-60 segundos. Você abre o GDD pronto e começa a editar.

Exemplo de input#

Tipo: Roguelike top-down
Descrição: Mago explorador desce 10 andares numa torre, gerando dungeons
procedurais. Sistema de runas que combinam pra criar feitiços únicos.
Morte é permanente, mas runas raras desbloqueiam permanente novas
combinações pra próximas runs.
Informações adicionais: Pixel art, single player, foco em build-craft.

Exemplo de output (estrutura)#

📖 Visão Geral — Spire of Echoes
🎮 Design de Jogo
  ├── Core Loop
  ├── Mecânicas Centrais
  └── Progressão
📦 Conteúdo do Jogo
  ├── 🎯 Atributos Base (HP, MP, Mana Regen, Speed, Crit%)
  ├── 👤 Mago Explorador (perfil + xp curve + progression)
  ├── 👤 Inimigo: Goblin de Andar (perfil)
  ├── ⚔️ Runa de Fogo (item com efeito)
  ├── ⚔️ Runa de Gelo
  ├── ⚡ Feitiço: Bola de Fogo (skill)
  ├── 🪙 Essência (moeda permanente)
  └── 🛠️ Mesa de Runas (craft table)
🎨 Apresentação
  └── Estilo Visual / UX / Audio
🏭 Produção
  └── Tecnologia / Roadmap / Riscos / KPIs

Cada página vem com prosa rica, callouts explicando jargão, e referências cruzadas entre os assuntos.

Melhoria de prosa#

Na descrição de qualquer página, o botão "Melhorar com IA" envia o conteúdo atual + um pedido de refinamento (mais conciso, mais técnico, mais visual, etc.) e devolve uma versão revisada. Você compara lado a lado e aceita ou descarta.

Conectar o Claude ao seu GDD#

O GDD Manager pode ser conectado ao Claude — no claude.ai, no Claude Desktop ou no Claude Code. Conectado, ele consegue:

• Listar e ler o conteúdo das suas páginas
• Criar páginas novas e reorganizar a árvore
• Reescrever ou completar descrições, com as referências $[...] e as tabelas no lugar certo
• Buscar por assunto em todos os seus projetos
• Montar o fluxograma de uma página a partir de uma descrição do fluxo

Cenário comum: o programador do seu jogo abre o Claude, pede pra ler a página onde você descreveu o core loop, e já implementa a partir dali. Você nem precisa mandar o documento.

No claude.ai ou no Claude Desktop#

Não precisa de chave nem de instalar nada — você entra com a sua própria conta do GDD Manager.

1. No GDD Manager, abra o menu da sua conta → Conectar ao Claude e copie a URL do conector
2. No claude.ai (ou no Claude Desktop), vá em Settings → Connectors → Add custom connector
3. Dê um nome (ex.: GDD Manager), cole a URL e clique em Connect
4. Abre uma página do GDD Manager: entre com a sua conta, se ela pedir, e clique em Autorizar

Pronto. Num chat novo, experimente: "lista meus projetos do GDD".

No Claude Code#

O mesmo caminho, pelo terminal, também sem chave. A tela Conectar ao Claude mostra o comando pra copiar; depois de rodar, digite /mcp dentro do Claude Code, escolha gdd-manager e Authenticate — o navegador abre o GDD Manager pra você entrar e autorizar.

Desconectar#

Na mesma tela, Aplicativos conectados lista tudo que você autorizou. Desconectar corta o acesso na hora — pra voltar, é só conectar e autorizar de novo.

Privacidade#

• API keys: ficam só no seu navegador (localStorage). Nunca enviamos pra nossos servidores.
• Conteúdo enviado pra IA: vai direto do seu navegador pro provedor (Anthropic, OpenAI ou Groq). Os servidores do GDD Manager não veem nem armazenam isso.
• Histórico: não armazenamos histórico de uso de IA.

Veja também#