01 Qué es y por qué tiene sentido
Hacer un juego con un solo chat de IA funciona hasta que deja de hacerlo: valores mágicos escritos a fuego en el código, mecánicas que nadie documentó, cambios que rompen otras partes y ninguna revisión antes de publicar. Esta plantilla añade la estructura de un estudio real a Claude Code mediante archivos en la carpeta .claude/: agentes con responsabilidades definidas, skills para cada fase, reglas de código por carpeta y ganchos que validan automáticamente.
No es piloto automático. El protocolo de todos los agentes es preguntar, presentar de dos a cuatro opciones con pros y contras, dejar que decidas, enseñar un borrador y escribir solo con tu visto bueno.
| Pieza | Cantidad | Para qué sirve |
|---|---|---|
| Agentes | 49 | Diseño, programación, arte, audio, narrativa, QA y producción, organizados en tres niveles. |
| Skills | 74 | Comandos para cada fase: idea, diseño, historias, desarrollo, revisión, QA y lanzamiento. |
| Ganchos | 12 | Validan commits, pushes y recursos, registran la actividad de los agentes y detectan huecos de documentación. |
| Reglas | 13 | Estándares de código que se aplican según la carpeta que se edita (gameplay, red, UI, IA…). |
| Plantillas | 39 | Documentos de diseño, especificaciones de UX, ADR, planes de sprint, accesibilidad. |
02 Cómo se organiza el estudio
Directores
Dirección creativa, dirección técnica y producción. Cuidan la visión y resuelven conflictos entre áreas.
Jefes de área
Diseño de juego, programación, arte, audio, narrativa, QA, lanzamiento y localización. Coordinan a sus especialistas.
Especialistas
Programación de gameplay, motor, IA y red; diseño de niveles y economía; sonido, guion, UX, accesibilidad, rendimiento y más.
Expertos de motor
Conjuntos para Godot 4, Unity y Unreal Engine 5, con subespecialistas en shaders, ECS, Blueprints o replicación.
03 Instalación y primer arranque
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git mi-juego
cd mi-juego
claude-
1
Abre Claude Code en la raíz
La carpeta que contiene CLAUDE.md y project.yaml. Si lo arrancas en una subcarpeta como src/, se saltan los ganchos, las reglas de bloqueo y el modo de permisos.
-
2
Ejecuta /start
Te pregunta en qué punto estás (sin idea, idea vaga, diseño claro o proyecto existente) y te lleva al flujo adecuado.
-
3
Configura el motor
Con /setup-engine seguido del motor y la versión, por ejemplo godot 4.6.
-
4
Elige el nivel de rigor
minimal (por defecto), standard o full. Se cambia cuando quieras con /settings.
| modes.rigor | Qué implica |
|---|---|
| minimal | Velocidad de game jam: un documento de una página, pruebas mínimas y revisión en solitario. |
| standard | Cinco secciones obligatorias en el documento de diseño, QA estándar y revisión ligera. |
| full | Ocho secciones, documentación exhaustiva, evidencia de QA en cada historia y revisión completa de dirección. |
04 Comandos clave por fase
| Fase | Comandos |
|---|---|
| Orientación | /start, /help, /project-stage-detect, /setup-engine, /settings |
| Diseño | /brainstorm, /map-systems, /design-system, /quick-design |
| Historias y sprints | /create-epics, /create-stories, /dev-story, /story-done, /sprint-plan |
| Revisión | /design-review, /code-review, /balance-check, /scope-check, /perf-profile |
| QA | /qa-plan, /smoke-check, /regression-suite, /playtest-report |
| Lanzamiento | /release-checklist, /launch-checklist, /changelog, /patch-notes, /hotfix |
| Equipos | /team-combat, /team-ui, /team-audio, /team-level, /team-polish |
El ciclo más corto en modo minimal es: /start, /setup-engine, /brainstorm, /create-stories y después alternar /dev-story con /story-done. Una historia que cambia algo visible no se cierra hasta que el juego se ha ejecutado y se ha guardado una captura como evidencia.
05 Prompts para arrancar
/brainstorm Quiero un juego 2D para móvil de partidas de 3 minutos, para jugar en el transporte público. Me gustan los puzles de física y las mecánicas de un solo dedo. Presupuesto: yo solo, fines de semana durante 3 meses. Propón tres conceptos distintos, con el bucle principal de cada uno y el mayor riesgo técnico, y ayúdame a elegir uno./create-stories A partir del brief aprobado, crea solo las historias necesarias para un prototipo jugable de un nivel: movimiento, objetivo, condición de victoria y reinicio. Ordénalas por dependencia y estima cada una. No crees historias de menús, sonido ni monetización todavía./quick-design Necesito un minijuego web de 60 segundos para un stand de feria que refuerce el mensaje «[mensaje de la marca]». Debe funcionar en una tableta, sin registro, con una tabla de puntuaciones del día que se reinicie a medianoche. Plantea la mecánica y los riesgos de usabilidad para un público que lo juega una sola vez.06 Personalización y seguridad
- ✓Borra los agentes que no vayas a usar (por ejemplo, los de un motor que no es el tuyo) para que Claude no los considere.
- ✓Los permisos de .claude/settings.json bloquean force push, rm -rf y la lectura de archivos .env; revísalos antes de cambiarlos.
- ✓Si editas o creas skills, comprueba que siguen cumpliendo con /skill-test y /skill-improve.
- ✓Ajustes personales (como revisar en solitario) van en project.local.yaml, que no se sube a Git.
- ✓Las notificaciones de escritorio solo funcionan en Windows; en Mac y Linux ese gancho no hace nada.
- ✓Para actualizar una versión antigua de la plantilla, sigue UPGRADING.md: indica qué archivos se pueden sobrescribir y cuáles fusionar a mano.
Preguntas frecuentes
Ayuda mucho. Los agentes escriben el código y te guían, pero vas a tomar decisiones de diseño y técnicas, y tendrás que abrir el motor para probar el juego.
Trae agentes específicos para Godot 4, Unity y Unreal Engine 5. Puedes usar uno de esos conjuntos o ninguno y adaptar las reglas a tu estructura.
No. Es una plantilla que clonas para empezar tu propio proyecto; el autor no incluye juegos para no llenar tu repositorio de código ajeno.
Más que una sesión normal si usas niveles de rigor altos o comandos de equipo, porque intervienen varios agentes. En modo minimal el consumo es moderado.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.