← Volver al blog
Aiaprox. 8 min de lectura

Cuarenta y nueve agents, setenta y cuatro skills y un estudio que pregunta antes de construir

Publicado 8 nov 2026
Cuarenta y nueve agents, setenta y cuatro skills y un estudio que pregunta antes de construir

La lista semanal de GitHub de este mes está llena de repositorios que envuelven Claude Code en una interfaz más agradable. Donchitos/Claude-Code-Game-Studios hace algo menos de moda: le da a la sesión un organigrama. El repositorio es una plantilla, no una aplicación. Lo clonas, abres Claude Code en la raíz y el asistente hereda un sistema de archivo, un conjunto de reglas sobre quién puede decidir qué, y 74 comandos de barra. Ganó unas 5.700 estrellas en una semana y ahora está en 36.845.

Las cifras de titular son 49 agents, 74 skills, 15 hooks, 14 reglas y 62 plantillas de documento. El número de agents es lo más fácil de inflar, así que es la parte menos interesante. Lo que hace que valga la pena leerlo es lo difícil de falsear: un modelo de delegación con vía de escalado, y hooks que comprueban si un subagent hizo de verdad lo que se le dijo.

Tres niveles, y una razón para cada uno

Los 49 agents están ordenados como se ordena un estudio.

El primer nivel son tres directores: creative-director, technical-director y producer. El segundo son los jefes de departamento: game-designer, lead-programmer, art-director, audio-director, narrative-director, qa-lead, release-manager y localization-lead. El tercero es una treintena de especialistas que cubren gameplay, motor, programación de IA y red, diseño de niveles y economía, arte técnico, diseño de sonido, escritura, construcción de mundo, UX, prototipado, rendimiento, DevOps, analítica, seguridad, QA, accesibilidad, live ops y comunidad.

Las reglas de cómo se hablan entre ellos están en el README, y son más estrictas que en la mayoría de los montajes multi-agent:

Solo delegación vertical, de directores a jefes, de jefes a especialistas. Se permite la consulta horizontal, pero dos agents del mismo nivel no pueden tomar decisiones vinculantes fuera de su dominio. Los desacuerdos escalan a un padre común: creative-director para las discusiones de diseño y technical-director para las técnicas. Los cambios entre departamentos pasan por producer. Y ningún agent toca archivos fuera de su dominio sin delegación explícita.

La última regla es la que importa en la práctica. La mayoría de los fallos multi-agent no son fallos de razonamiento, son fallos de alcance: un agent al que se le pidió arreglar un bug de iluminación reescribe el sistema de guardado porque se dio cuenta de algo. Escribir la frontera del dominio y hacer que la aplique un jefe que tiene que delegar es un remedio tosco y real.

Los niveles de modelo son una cuestión de presupuesto

Cada agent declara un modelo en su frontmatter. Los tres directores piden Opus. lead-programmer y quince especialistas nombran Sonnet. Los treinta restantes heredan el modelo que esté ejecutando tu sesión.

El README es inusualmente directo en esto: trata los niveles como antigüedad de rol, no como un plan de facturación, porque casi todo el estudio funciona con el modelo que ya tienes. Es la versión honesta del relato de costes de un framework de agents. En la práctica pagas una sesión más un puñado de llamadas a Opus en las decisiones que determinan todo lo demás, y ese es un sitio defendible donde gastar.

Qué comprueban de verdad los hooks

Quince hooks corren sobre eventos de sesión. Dos merecen que se les nombre.

`log-agent.sh` y `log-agent-stop.sh` escriben un rastro de auditoría cuando un subagent arranca y para. Es contabilidad, y barata.

`validate-agent-artifact.sh` es el interesante. Se dispara cuando un agent se detiene y avisa si ese subagent nunca escribió el archivo que nombraba su encargo. La comprobación es pequeña y apunta a un fallo concreto que conoce cualquiera que haya lanzado agents en paralelo: el subagent informa de éxito, el orquestador sigue, y el archivo no existe. Pillarlo en el evento de parada es el sitio correcto, porque es el último momento en que el padre todavía tiene el contexto para reenviar la tarea.

Los otros hooks cubren commits, pushes, cambios de assets, lectura y escritura de documentos de diseño, registros y el ciclo de vida de la sesión. Los hooks se degradan con elegancia cuando falta una herramienta opcional, con una excepción deliberada: un commit que pone en stage un JSON de datos se bloquea si no hay Python, porque el validador no puede correr.

Las trampas están en la lista de requisitos

La instalación son cuatro líneas en el README, y una de ellas es una advertencia.

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
claude

Luego escribe `/start`. El sistema pregunta en qué punto estás, desde ninguna idea hasta un proyecto existente, y te lleva a un flujo de trabajo. También puedes saltar directo a `/setup-engine godot 4.7`, `/brainstorm` o `/project-stage-detect`.

La advertencia: arranca Claude Code en la carpeta que contiene `CLAUDE.md` y `project.yaml`. Si lo arrancas en `src/`, los hooks del proyecto, las reglas deny y el modo de permisos que pregunta antes de actuar se saltan por completo. Te queda un asistente sin ninguna estructura, y nada te lo dice.

Las dependencias son Git, Claude Code (se recomienda el instalador nativo, aunque `npm install -g @anthropic-ai/claude-code` funciona en Node 22+), Python 3 y Bash. Python 3 no es opcional como parece: cada skill y cada hook lee `project.yaml` a través de él, y sin Python todos los ajustes vuelven en silencio a su valor por defecto. Una vuelta atrás silenciosa es peor que un crash, porque el estudio sigue corriendo con la configuración equivocada y nadie lo nota hasta que una regla deja de dispararse. jq se recomienda para la validación de hooks.

El desarrollo principal es Windows 10 con Git Bash, y los hooks también se prueban en macOS con su bash 3.2 de serie y en Linux. `notify.sh` usa PowerShell para las notificaciones de Windows y no hace nada en otras plataformas, así que las notificaciones de escritorio son solo para Windows por ahora.

Nueve especialistas de motor, y solo necesitas uno

La plantilla trae conjuntos de agents para Godot 4, Unity y Unreal Engine 5. Cada uno tiene un lead y subespecialistas: GDScript, shaders y GDExtension para Godot; DOTS/ECS, shaders y VFX, Addressables y UI Toolkit para Unity; GAS, Blueprints, replication y UMG/CommonUI para Unreal.

Tener los tres en un solo repositorio es una cobertura razonable, y también significa que el repositorio carga mucho texto que nunca vas a abrir. La sección de personalización del README dice que borres los archivos de agents que no necesites, que es el consejo correcto y también una tarea que nadie hace.

La parte que no es autonomía

El README dice sin rodeos que esto no es un piloto automático, y el protocolo de colaboración lo respalda. Los agents preguntan antes de proponer. Presentan de dos a cuatro opciones con sus contrapartidas. Decide el usuario. Muestran un borrador antes de cerrar. No se escribe nada sin aprobación. Los modos `guided` y `autonomous` cambian parte de esas confirmaciones por velocidad, y el README remite a su propio documento de instalación para las rutas al modo automático.

También hay un arnés de pruebas para el propio framework. `studio-tests/` cataloga los 74 skills y los 49 agents con rúbricas por categoría y especificaciones de comportamiento, y `/skill-test` ejecuta un linter estático con siete comprobaciones de cumplimiento, una rúbrica de categoría o aserciones de especificación. `/skill-improve` corre un bucle de probar, corregir y reprobar, y revierte si la puntuación no sube. Probar el framework aparte del juego es la disciplina que hace que editarlo sea soportable.

Para qué sirve esto en realidad

El README se hace su propia pregunta incómoda en el título de una sección: ¿produce juegos o documentos? Una plantilla que trae 62 plantillas de documento y una puerta en cada hito apuesta a que el desarrollo en solitario falla en el proceso y no en el código. Esa apuesta se sostiene. Los modos de fallo de un proyecto individual asistido por IA son un número mágico escrito a mano que nadie anotó, un documento de diseño que describe un juego de tres revisiones atrás, y un build que sale con un tutorial roto porque nadie corrió el smoke check.

Cuarenta y nueve agents no arreglan eso. Una regla limitada a una ruta que se dispara cuando se edita código de gameplay, un `/smoke-check` que tiene que correr antes de un build, y un hook que bloquea un commit cuando el validador no puede correr tienen más posibilidades. Lo interesante aquí es que alguien escribió el organigrama, incluidas las partes donde un especialista tiene que escalar y esperar.

Artículos relacionados