Communitygithub.com

ProdaZhang/aigd

Diseña juegos con ayuda de IA; entrega el resultado a otra IA para que lo construya directamente — con verificadores de consistencia deterministas.

¿Qué es aigd?

AIGD (AI Game Design) es un paquete metodológico portable para el desarrollo de juegos asistido por IA. Cubre el proceso completo: desde la lluvia de ideas y el diseño de sistemas, hasta la iteración mediante pruebas de juego y la finalización con un paquete de entrega que otra IA puede tomar y desarrollar directamente, sin incluir la implementación técnica (elección del stack y escritura del cliente/servidor). El núcleo del sistema se basa en dos capas: una capa de proyecto (columna vertebral) que contiene el acta del proyecto y el manifiesto con registros de sistemas, dependencias y congelamientos; y un bucle de producción por sistema. Cada operación lee la columna vertebral, realiza el trabajo y escribe los cambios de vuelta, garantizando consistencia y reentrada entre sesiones o distintas IA. Soporta plataformas como Claude Code mediante habilidades (skills) instaladas en el directorio de habilidades del agente. El paquete incluye un orquestador principal (`aigd`) y seis sub-habilidades: `aigd-concept`, `aigd-system`, `aigd-iterate`, `aigd-handoff`, `aigd-sync` y `aigd-ui-capture`, todas compartiendo una única fuente de verdad en la carpeta `references/`. El flujo típico comienza con la creación del concepto, seguido del diseño de cada sistema con iteraciones opcionales, finalización y sincronización continua, permitiendo retrocesos y reajustes cuando se detectan incompatibilidades.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add ProdaZhang/aigd

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 (ver references/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 hacerSub-habilidad
Concepto / bucle central / plataforma / usuarios objetivo / dividir en sistemasaigd-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ñadoraigd-handoff
Sincronizar la especificación global / prototipo general / guía maestra de implementación; marcar para revisión los cambios en elementos compartidosaigd-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

  1. 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.
  2. Sin columna vertebral → iniciar el proyecto con aigd-concept primero (construir la columna vertebral).
  3. 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).
  4. 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 / manifiesto no existen): "leer la columna vertebral" devuelve vacío → enruta directamente a aigd-concept para 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)

  1. ¿Existe la columna vertebral? Sí → leer project-charter.md + manifest.md; No → enrutar a aigd-concept para iniciar el proyecto.
  2. ¿Qué sistemas tienen estado ≠ Final? Listarlos, preguntar al usuario cuál impulsar esta vez.
  3. ¿Hay sistemas en Recheck? Recordar volver a verificar primero (algún elemento compartido cambió) → enrutar a aigd-sync para resolver (pase de recheck → volver a Final / fallar → devolver).
  4. ¿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 como Recheck (ver aigd-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.

Skills relacionados