AIGD · Orchestrator
AIGD = AI Game Design (KI-gestütztes Spieledesign). Ein portables Methodik-Paket für die KI-gestützte Spielentwicklung: Brainstorming → Systemdesign → Playtest-Iteration → Finalisierung & Übergabe. Es erzeugt ein Übergabepaket (plattformunabhängig), das „eine andere KI direkt weiterentwickeln kann“. Die Implementierung (Auswahl eines Tech-Stacks zum Schreiben von Client/Server) ist nicht Teil dieses Pakets und bleibt einem zukünftigen, dedizierten Landing-Skill vorbehalten.
Status: v0 (Pre-Release) – Ende-zu-Ende validiert (Live-Demos + der ausführbare
examples/-Walkthrough in der Repository-README).patterns/ist ein Starterpaket, das ständig wächst (siehereferences/README.md).
Kernmodell (Details siehe references/)
- Zwei Ebenen: ① Die lebende Projektebene (Rückgrat) –
project charter(Konzept / Plattform / Zielnutzer / Genre / Stil / Namenskonventionen) +manifest(Systemliste + Abhängigkeitsgraph + ebenenübergreifender Index + Freeze-Ledger + Nummernbereichsregister), kontinuierlich überarbeitet; ② Die produktionsschleife pro System. - Zentralisierte Quelle der Wahrheit: Aufzählungen / Nummerierungen / Schnittstellenverträge / Konfigurationstabellen gehören zur Projektebene; Doppelte Kopien (systemweit + global): Akzeptanz / Ressourcenbedarf / Prototyp; Nur auf Systemebene: Regeln / Backend-Algorithmen.
- Jeder Vorgang: Rückgrat lesen → Arbeit erledigen → Rückgrat aktualisieren. Entdeckungen auf unterer Ebene (neues System / neue Abhängigkeit / neue Aufzählung / geändertes Konzept) werden nach oben in die obere Ebene zurückgeschrieben.
- Methodische Quelle der Wahrheit:
references/methodology.md,references/README.md.
Routing: Sub-Skill nach „Was möchtest du diesmal tun“ auswählen
| Was möchtest du tun | Sub-Skill |
|---|---|
| Konzept / Kernspielschleife / Plattform / Zielnutzer / in Systeme aufteilen | aigd-concept |
| Ein System entwerfen (Regeln + Konfigurationstestdaten + HTML-Prototyp) | aigd-system |
| Ein System nach dem Playtest optimieren (Regeln/Konfiguration/Prototyp, wiederholbar) | aigd-iterate |
| Ein System finalisieren → Vertrag / Akzeptanz / Client-Server-Dokumente / Designer-Akzeptanz-Checkliste | aigd-handoff |
| Globale Spezifikation / Gesamtprototyp / Implementierungs-Master-Guide zurückschreiben; Änderungen an gemeinsamen Elementen als Überprüfung markieren | aigd-sync |
| UI-Screenshot → UI-DSL (Wissensbasis für UI-Paradigmen aufbauen, für Design-Zeit-Recherche & Referenz) | aigd-ui-capture |
Verwendung
- Zuerst das Rückgrat lesen (Projektcharta + Manifest), um zu beurteilen: Welchen Schritt hat das Projekt erreicht, in welchem Zustand befindet sich das diesmalige System, was fehlt?
- Kein Rückgrat → Projekt mit
aigd-conceptstarten (Rückgrat aufbauen). - Den passenden Sub-Skill auswählen und mit dem Skill-Tool aufrufen; jeder Sub-Skill liest und schreibt dasselbe Rückgrat, hält es konsistent und wiedereintrittsfähig (kann sitzungsübergreifend / von einer anderen KI fortgesetzt werden).
- Typischer Pfad: Konzept (einmalig) → pro System {System → iterieren… (wiederholt) → Handoff finalisieren} → Sync (kontinuierlich). Iterate geht nicht direkt in Sync – Sync-Zulassung erfordert, dass das System bereits
Finalist, und nur Handoff kann finalisieren; die Reihenfolge ist nicht erzwungen, nach Bedarf routen.
Wenn kein Rückgrat existiert (erste Verwendung in einem Projekt,
project charter/manifestexistieren noch nicht): „Rückgrat lesen“ liefert nichts → direkt zuaigd-conceptrouten, um das Rückgrat zu starten; das ist normal, kein Fehler.
Start-Selbstprüfung (wird bei jedem Eintritt in /aigd ausgeführt – proaktiv vorantreiben, nicht darauf warten, dass der Nutzer rät)
- Existiert das Rückgrat? Ja →
project-charter.md+manifest.mdlesen; Nein → zuaigd-conceptrouten, um das Projekt zu starten. - Welche Systeme haben Status ≠
Final? Auflisten, den Nutzer fragen, welches diesmal vorangetrieben werden soll. - Gibt es
Recheck-Systeme? Daran erinnern, zuerst zu überprüfen (ein gemeinsames Element hat sich geändert) → zuaigd-syncrouten, um zu klären (Überprüfung bestanden → zurück zuFinal/ fehlgeschlagen → zurückgeworfen). - Nummernbereichskonflikte / Zyklen im Abhängigkeitsgraphen? Prüfen und melden.
Zustandsübergänge (nichtlinear · mit Rollback)
concept ──→ system design ⇄ playtest iteration ──→ finalize ──→ integration
▲ │ │ │(Rückwurf)
│ │ │ ▼
│ └─Grenze falsch gezeichnet─┴────→ zurück zu playtest / zurück zu concept
└────────── Integration findet Inkompatibilität / erneute Aufteilung nötig ──────────┘
- Jeder Rückwurf / erneute Aufteilung zeichnet einen Eintrag im Manifest „Rollback-Log“ auf und sucht gemäß den „Rückwurf-Regeln“ rückwärts
depended-on-by, wobei bereits finalisierte nachgelagerte Systeme alsRecheckmarkiert werden (sieheaigd-handoff/aigd-sync). - Vorlagen:
references/templates/(Projektcharta / Manifest / Implementierungs-Master-Guide, stark typisiert).
Paketstruktur (gesamtes Paket installieren, nicht aufteilen)
aigd (dieser Orchestrator, enthält die references/-Methodik und Vorlagen) + 6 Sub-Skills aigd-concept / system / iterate / handoff / sync / ui-capture, auf derselben Ebene im Skills-Verzeichnis dieser Umgebung installiert (gemäß dem Host-Agenten, z. B. Claude Codes .claude/skills/). Sub-Skill-Texte verwenden ../aigd/references/, um die Methodik abzurufen – aigd/ muss auf derselben Ebene existieren (aigd-ui-capture greift ebenfalls über ../aigd/references/ui-dsl-spec.md und scripts/ zu). Einzelne Quelle der Wahrheit, nicht einzeln kopieren; falls du es später unabhängig verteilen möchtest, upgrade es zu einem Plugin (siehe references/README.md „Packaging & Portability“).
Empfehlungen für die Projektumgebung
- Rückgrat-Dateien (
project charter/manifest) und Design-Artefakte sollten unter Git/SVN-Verwaltung gestellt werden; der Orchestrator sollte vor jedem Vorgang einen Blick auf den Versionsstatus werfen. - CHANGELOG (Änderungsprotokoll) ergänzt die Versionsverwaltung: VCS zeichnet auf „was sich geändert hat“, CHANGELOG zeichnet auf „warum + welches Modell“ (diese Methodik ist ein KI-gestützter Ablauf, die Aufzeichnung des Modells hilft nachzuvollziehen, woher eine bestimmte Änderung stammt).
Abgrenzung
- Reicht bis zu „ein Übergabepaket, das eine KI direkt weiterentwickeln kann“ (plattformunabhängig: Regeln / Vertrag / Konfiguration / Akzeptanz / Prototyp / Ressourcenbedarf).
- Tech-Stack-Wahl und Client/Server-Implementierung = nachgelagert, nicht in diesem Paket.