Proyecto, página y DataID — el vocabulario que aparece en toda la documentación.
Conceptos clave#
Tres palabras aparecen una y otra vez en esta documentación. Entender bien cada una te ahorra tiempo más adelante.
1. Proyecto#
La unidad de trabajo de más alto nivel. Un proyecto representa un juego.
Todo lo que escribes vive dentro de un proyecto. Puedes tener tantos proyectos como quieras en tu cuenta — uno por juego, uno por experimento, uno por cliente.
2. Página#
Una página es un tema de tu juego. Ej.: "Espada de Hierro", "Mago Sombrío", "Economía Principal", "Core Loop".
Las páginas se organizan en árbol — toda página puede tener subpáginas. La app organiza el GDD en cuatro áreas — Visión del juego, Documentación, Biblioteca y Sistemas — y las páginas viven en la Documentación, con decenas o cientos de hijas debajo.
Cada página tiene un título, una descripción escrita en bloques (párrafos, listas, tablas, imágenes, callouts, spoilers) y las etiquetas de dominio que dicen de qué trata.
3. DataID#
Un DataID es un apodo estable y legible para una página — DATA_FIRE_BALL, DATA_GOLD, DATA_ENEMY_GOBLIN.
Por qué importa#
La app genera un identificador interno (a8f3e9d2-7c1b-…) para cada página, pero es ilegible y cambia cuando duplicas o importas un proyecto. El DataID es el nombre que tú eliges y que no cambia cuando renombras o mueves la página.
Sirve sobre todo para poder emparejar: cuando alguien (o Claude, vía la integración) necesita apuntar a una página concreta, el DataID es la dirección fiable.
Cómo definirlo#
- Abre cualquier página
- Justo debajo del título hay un campo discreto:
- Cuando está vacío: aparece "+ DataID" en gris
- Cuando está definido: aparece "ID: DATA_…" como un pill clicable
- Haz clic en el campo
- La app sugiere uno automáticamente según el título — ej.: "Espada de Hierro" →
DATA_ESPADA_DE_HIERRO - Acéptalo o edítalo (vale la pena mantener una convención, ej.: todo en inglés:
DATA_IRON_SWORD) - La app te avisa si ya existe otra página con el mismo DataID
Cuándo usarlo#
No hace falta en todas las páginas. Vale la pena en las que citas mucho, en las que la integración con IA va a necesitar encontrar, y en las que representan entidades concretas del juego (un ítem, un enemigo, una moneda).
Próximos pasos#
Ahora que el vocabulario está claro: