AIGD · orquestador
AIGD = AI Game Design (Diseño de juegos con IA). Un paquete metodológico portable de desarrollo de juegos con IA: abarca lluvia de ideas → diseño de sistemas → iteración de pruebas de juego → finalización y entrega, produciendo un paquete de entrega (independiente de plataforma) que "otra IA puede desarrollar directamente"; la implementación (elegir un stack tecnológico para escribir el cliente/servidor) no está incluida en este paquete y se deja para una futura habilidad de aterrizaje dedicada.
Estado: v0 (prelanzamiento) — validado de extremo a extremo (demostraciones en ejecución real + el tutorial ejecutable
examples/en el README del repositorio).patterns/es un paquete inicial que sigue creciendo (verreferences/README.md).
Modelo central (los detalles se difieren a references/)
- Dos capas: ① la capa de proyecto (columna vertebral) —
acta del proyecto(concepto / plataforma / usuarios objetivo / género / estilo / convenciones de nomenclatura) +manifiesto(lista de sistemas + gráfico de dependencias + índice entre capas + registro de congelaciones + registro de rangos numéricos), revisada continuamente; ② el bucle de producción por sistema. - Fuente centralizada de verdad: enumeraciones / numeración / contratos de interfaz / tablas de configuración pertenecen a la capa de proyecto; copias duales (sistema + global): aceptación / necesidades de recursos / prototipo; solo en la capa del sistema: reglas / algoritmos del backend.
- Cada operación: leer la columna vertebral → realizar el trabajo → escribir de vuelta en la columna vertebral. Los descubrimientos de capas inferiores (nuevo sistema / nueva dependencia / nueva enumeración / concepto cambiado) se escriben hacia arriba en la capa superior.
- Fuente de verdad de la metodología:
references/methodology.md,references/README.md.
Enrutamiento: despachar una sub-habilidad según "lo que quieres hacer esta vez"
| Lo que quieres hacer | Sub-habilidad |
|---|---|
| Concepto / bucle central / plataforma / usuarios objetivo / dividir en sistemas | aigd-concept |
| Diseñar un sistema (reglas + datos de configuración de prueba + prototipo HTML) | aigd-system |
| Optimizar un sistema después de una prueba de juego (reglas/config/prototipo, repetible) | aigd-iterate |
| Finalizar un sistema → contrato / aceptación / documentos cliente-servidor / lista de verificación de aceptación orientada al diseñador | aigd-handoff |
| Sincronizar la especificación global / prototipo general / guía maestra de implementación; marcar para revisión los cambios en elementos compartidos | aigd-sync |
| Captura de pantalla de UI → DSL de UI (construir la base de conocimientos del paradigma de UI de patrones, para recuperación y referencia durante el diseño) | aigd-ui-capture |
Uso
- Leer primero la columna vertebral (acta del proyecto + manifiesto) para juzgar: en qué paso se encuentra el proyecto, en qué estado está el sistema de esta vez, qué falta.
- Sin columna vertebral → iniciar el proyecto con
aigd-conceptprimero (construir la columna vertebral). - Elegir la sub-habilidad correspondiente e invocarla con la herramienta Skill para ejecutarla; cada sub-habilidad lee y escribe la misma columna vertebral, manteniéndola consistente y reentrante (se puede retomar entre sesiones / por otra IA).
- Ruta típica: concepto (una vez) → por sistema {sistema → iterar… (repetido) → finalizar entrega} → sincronizar (continuo). iterate no va directamente a sync — la admisión a sync requiere que el sistema ya esté
Final, y solo handoff puede finalizar; el orden no es obligatorio, enruta según sea necesario.
Cuando no hay columna vertebral (primera vez que se usa en un proyecto,
acta del proyecto/manifiestono existen): "leer la columna vertebral" devuelve vacío → enruta directamente aaigd-conceptpara iniciar la columna vertebral; esto es normal, no es un error.
Autocomprobación de entrada (ejecutar en cada entrada a /aigd — avanzar proactivamente, no esperar a que el usuario adivine)
- ¿Existe la columna vertebral? Sí → leer
project-charter.md+manifest.md; No → enrutar aaigd-conceptpara iniciar el proyecto. - ¿Qué sistemas tienen estado ≠
Final? Listarlos, preguntar al usuario cuál impulsar esta vez. - ¿Hay sistemas en
Recheck? Recordar volver a verificar primero (algún elemento compartido cambió) → enrutar aaigd-syncpara resolver (pase de recheck → volver aFinal/ fallar → devolver). - ¿Conflictos de rangos numéricos / ciclos en el gráfico de dependencias? Verificar e informar.
Transiciones de estado (no lineal · con reversión)
concept ──→ diseño de sistema ⇄ iteración de pruebas de juego ──→ finalizar ──→ integración
▲ │ │ │(rebote)
│ │ │ ▼
│ └─límite mal trazado──┴────→ volver a pruebas de juego / volver a concepto
└────────── integración encuentra incompatibilidad / necesita redividir ──────────┘
- Cualquier rebote / redividir registra una entrada en el "registro de reversiones" del manifiesto, y según las "reglas de rebote" busca hacia atrás
depende-de, marcando los sistemas aguas abajo ya finalizados comoRecheck(veraigd-handoff/aigd-sync). - Plantillas:
references/templates/(acta de proyecto / manifiesto / guía maestra de implementación, fuertemente tipadas).
Estructura del paquete (instalar todo el paquete, no dividirlo)
aigd (este orquestador, que contiene la metodología references/ y las plantillas) + 6 sub-habilidades aigd-concept / system / iterate / handoff / sync / ui-capture, instaladas al mismo nivel en el directorio de habilidades de este entorno (siguiendo al agente anfitrión, p. ej., .claude/skills/ de Claude Code). Los cuerpos de las sub-habilidades usan ../aigd/references/ para obtener la metodología → aigd/ debe existir al mismo nivel (aigd-ui-capture pasa por ../aigd/references/ui-dsl-spec.md y scripts/, igualmente). Fuente única de verdad, no copiar individualmente; si luego se desea distribuirlo de forma independiente, actualizarlo a un plugin (ver references/README.md "Empaquetado y portabilidad").
Recomendaciones de entorno de proyecto
- Se recomienda poner los archivos de la columna vertebral (
acta del proyecto/manifiesto) y los artefactos de diseño bajo control de versiones Git/SVN; el orquestador debería echar un vistazo al estado de versiones antes de cada operación. - CHANGELOG (registro de cambios) complementa el control de versiones: VCS registra "qué cambió", CHANGELOG registra "por qué + qué modelo" (este flujo metodológico es asistido por IA, registrar el modelo ayuda a rastrear de dónde provino un cambio dado).
Límite
- Llega hasta "un paquete de entrega del que una IA pueda desarrollar directamente" (independiente de plataforma: reglas / contrato / configuración / aceptación / prototipo / necesidades de recursos).
- Elección del stack tecnológico e implementación del cliente/servidor = posterior, no incluido en este paquete.