Projeto, página e DataID — o vocabulário que se repete em toda a doc.
Conceitos chave#
Três palavras voltam o tempo todo nesta documentação. Entender bem cada uma economiza tempo depois.
1. Projeto#
A unidade de trabalho de mais alto nível. Um projeto representa um jogo.
Tudo o que você escreve vive dentro de um projeto. Você pode ter quantos projetos quiser na conta — um por jogo, um por experimento, um por cliente.
2. Página#
Uma página é um assunto do seu jogo. Ex.: "Espada de Ferro", "Mago Sombrio", "Economia Principal", "Core Loop".
Páginas se organizam em árvore — toda página pode ter sub-páginas. O app organiza o GDD em quatro áreas — Visão do jogo, Documentação, Biblioteca e Sistemas — e as páginas moram na Documentação, com dezenas ou centenas de filhas embaixo.
Cada página tem um título, uma descrição escrita em blocos (parágrafos, listas, tabelas, imagens, callouts, spoilers) e as tags de domínio que dizem do que ela trata.
3. DataID#
Um DataID é um apelido estável e legível pra uma página — DATA_FIRE_BALL, DATA_GOLD, DATA_ENEMY_GOBLIN.
Por que importa#
O app gera um identificador interno (a8f3e9d2-7c1b-…) pra cada página, mas ele é ilegível e muda quando você duplica ou importa um projeto. O DataID é o nome que você escolhe e que não muda quando a página é renomeada ou movida de lugar.
Serve principalmente pra combinar: quando alguém (ou o Claude, via integração) precisa apontar pra uma página específica, o DataID é o endereço confiável.
Como definir#
- Abra qualquer página
- Logo abaixo do título tem um campo discreto:
- Quando vazio: aparece "+ DataID" em cinza
- Quando preenchido: aparece "ID: DATA_…" num pill clicável
- Clique no campo
- O app sugere automaticamente algo baseado no título — ex.: "Espada de Ferro" →
DATA_ESPADA_DE_FERRO - Aceite ou edite (vale padronizar, ex.: tudo em inglês:
DATA_IRON_SWORD) - O app avisa se já existe outra página com o mesmo DataID
Quando usar#
Não precisa em toda página. Vale a pena nas que você cita muito, nas que a integração com IA vai precisar encontrar, e nas que representam entidades concretas do jogo (um item, um inimigo, uma moeda).
Próximos passos#
Agora que o vocabulário tá claro: