PL
Sama postać chleba z logo CRUMB: uśmiechnięta kromka chleba z ugryzionym prawym górnym rogiem
Powrót do sali

CRUMB

Generative Game Studio · Demo

Od jednozdaniowego pomysłu na grę do grywalnego szkicu, z pracą agentów na widoku i otwartą na interwencję.

CRUMB to wieloagentowy harness studyjny do prototypowania gier casualowych.

Projekt i rozwój · zbudowane z agentami kodującymi AI

  • CLIDemo lokalne
  • Web StudioDemo lokalne

Agenci, którzy budują grę, oddzieleni od dowodów, które ją oceniają.

Lokalne demo studia, które prowadzi jednozdaniowy pomysł na grę przez specyfikację, build i kontrole wykonania. Każdy krok trafia do transkryptu JSONL, czysty reducer decyduje o kolejnych efektach, a efekty uboczne wykonuje tylko dispatcher. QA wykonania i werdykt modelu są oddzielone, by rozstrzygnąć między zaliczeniem, przeprojektowaniem, naprawą a sterowaniem przez człowieka.

Wystarczy opisać grę jednym zdaniem, a agenci Claude Code, Codex i Gemini CLI współpracują w sekwencji Planner → Builder → deterministyczne QA → Verifier, podczas gdy CRUMB Studio pokazuje zdarzenia, postęp i artefakty oraz przyjmuje interwencje w języku naturalnym.

Demo, które klonuje się z publicznego repozytorium i uruchamia lokalnie.

Mapa systemu · narysowana na podstawie ścieżek kodu w publicznym commicie f5e17c0
System studia CRUMBCzłowiek proponuje grę i nią steruje w Studio, a Studio zapisuje polecenia do skrzynki inbox. Koordynator przekazuje reducerowi po kolei nowe zdarzenia z inboxa i transkryptu; czysty reducer decyduje o stanie i kolejnych efektach, a efekty uboczne wykonuje tylko dispatcher. Specyfikacja Plannera, build i artefakty Buildera, wynik QA wykonania i ocena Verifiera stają się zdarzeniami transkryptu. Verifier otrzymuje wyłącznie zrzutowane dowody, a reducer sprawdza i koryguje jego ocenę względem wyniku QA: PASS kończy sesję, PARTIAL czeka na człowieka, a wszystko inne wraca do przeprojektowania lub naprawy.Pomysł na grę · sterowanieCzłowiek, uruchamiający lokalniepackages/studioWidok zdarzeń · artefaktówZapis poleceń do inboxasrc/transcripttranscript.jsonl · append-onlysrc/loop/coordinator.tsPętla zdarzeń · replay · tailsrc/reducerStan → kolejne efektyKierowanie według werdyktusession doneKoniec · PASS lub przyczyna zatrzymaniasrc/dispatcher/live.tsWykonanie efektów · uruchamianie aktorówRzutowanie wejścia sędziegomodel-config · presetAktor → harness · modelagent actor · CLIPlanner Lead · specyfikacjaBuilder · pisze gręartifacts/Pliki grydispatcher/qa-runner.tsQA wykonania · kontroleVerifier actorVerifier · werdykt modelusrc/validatorOchrona przed oszustwem · korekta ocenyLudzie · StudioSterowanie zdarzeniamitranskrypt jest źródłem stanuAgenci roboczy · artefaktyWeryfikacja · decyzja1pomysł · sterowanie2zdarzenia user3redukcja po kolei4efekty5konfiguracja aktora6uruchomienie Plannera7spec8uruchomienie Buildera9pliki10zapis builda11qa_check12co jest uruchamiane13qa.result1qa.result2tylko dowody3wejście sędziego4judge.score5ocena · dowody QA6skorygowany werdykt7koniec1skorygowany werdykt2kontrola PARTIAL3przeprojektowanie · naprawa4koniec5pomysł · sterowanie1nowe zdarzenia · replay2redukcja po kolei3odczyt · SSE

Od pomysłu do gry

Pomysł staje się specyfikacją, buildem i przebiegiem QA wykonania. Każdy krok przechodzi przez transkrypt; aktorzy nie wywołują się nawzajem.

  1. Pomysł na grę · sterowaniepomysł · sterowanieZapis poleceń do inboxapackages/studio

    Jednozdaniowy pomysł na grę i sterowanie w języku naturalnym wprowadza się w Studio, które zapisuje polecenia do inboxa. Studio nigdy nie edytuje transkryptu bezpośrednio.

  2. Zapis poleceń do inboxapackages/studiozdarzenia userPętla zdarzeń · replay · tailsrc/loop/coordinator.ts

    Koordynator odczytuje polecenia z inboxa i zapisuje je w transkrypcie jako zdarzenia user.

  3. Pętla zdarzeń · replay · tailsrc/loop/coordinator.tsredukcja po koleiStan → kolejne efektysrc/reducer

    Zdarzenia na żywo są redukowane pojedynczo z kolejki, z zachowaniem kolejności efektów każdego zdarzenia; sam dispatch działa asynchronicznie.

  4. Stan → kolejne efektysrc/reducerefektyWykonanie efektów · uruchamianie aktorówsrc/dispatcher/live.ts

    Reducer to czysta funkcja, która decyduje tylko o stanie i kolejnych efektach: cel wybiera Plannera, specyfikacja Buildera, build qa_check.

  5. Aktor → harness · modelmodel-config · presetkonfiguracja aktorasrc/dispatcher/live.ts

    To, który harness, dostawca i model uruchamia aktora, rozstrzyga się w kolejności flaga CLI > konfiguracja > preset > ambient > fallback. Aktor nie jest stałym dostawcą.

  6. Wykonanie efektów · uruchamianie aktorówsrc/dispatcher/live.tsuruchomienie PlanneraPlanner Lead · specyfikacjaagent actor · CLI

    Dispatcher uruchamia Plannera z zrzutowanym wejściem. Warunkowy research przebiega dalej przez plan badawczy Plannera i przekazanie dowodów, zwinięte na tej mapie.

  7. Planner Lead · specyfikacjaagent actor · CLIspectranscript.jsonl · append-onlysrc/transcript

    Specyfikacja Plannera staje się zdarzeniem transkryptu, a reducer wybiera na jej podstawie Buildera. Aktorzy nie wywołują się nawzajem.

  8. Wykonanie efektów · uruchamianie aktorówsrc/dispatcher/live.tsuruchomienie BuilderaBuilder · pisze gręagent actor · CLI

    Dispatcher uruchamia Buildera. Jeśli ten sam aktor wciąż zawodzi, otwiera się circuit i wymienia adapter, a przy dalszych awariach następuje zatrzymanie.

  9. Builder · pisze gręagent actor · CLIplikiPliki gryartifacts/

    Builder zapisuje plik wejściowy, źródła i zasoby jako artefakty.

  10. Builder · pisze gręagent actor · CLIzapis buildatranscript.jsonl · append-onlysrc/transcript

    Zdarzenie build i artifact.created są zapisywane w transkrypcie z tożsamością artefaktu.

  11. Wykonanie efektów · uruchamianie aktorówsrc/dispatcher/live.tsqa_checkQA wykonania · kontroledispatcher/qa-runner.ts

    Po zdarzeniu build reducer emituje efekt qa_check z tożsamością artefaktu i builda oraz warunkami akceptacji, a dispatcher go wykonuje.

  12. Pliki gryartifacts/co jest uruchamianeQA wykonania · kontroledispatcher/qa-runner.ts

    QA wykonania uruchamia faktyczny artefakt z kontrolami kodu i przeglądarki. Domyślny limit czasu 120 sekund to wartość konfiguracji.

  13. QA wykonania · kontroledispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Sukces czy porażka, wynik jest zapisywany jako systemowe zdarzenie qa.result. Nawet jeśli kontrola rzuci wyjątek, zapisywany jest wynik z polami porażki.

Granica zaufania weryfikacji

QA wykonania to dowód z faktycznego uruchomienia artefaktu; Verifier to model oceniający zrzutowane dowody. Reducer uzgadnia jedno z drugim przed wyborem kolejnej ścieżki.

  1. QA wykonania · kontroledispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Sukces czy porażka, wynik jest zapisywany jako systemowe zdarzenie qa.result. Nawet jeśli kontrola rzuci wyjątek, zapisywany jest wynik z polami porażki.

  2. transcript.jsonl · append-onlysrc/transcripttylko dowodyRzutowanie wejścia sędziegosrc/dispatcher/live.ts

    Wejście Verifiera jest rzutowane z najnowszych goal, spec, build, qa.result i artifact.created oraz wybranych dowodów z researchu. Zawęża kontekst; nie dowodzi izolacji ani braku wycieku.

  3. Rzutowanie wejścia sędziegosrc/dispatcher/live.tswejście sędziegoVerifier · werdykt modeluVerifier actor

    Dispatcher uruchamia Verifiera z zrzutowanym wejściem.

  4. Verifier · werdykt modeluVerifier actorjudge.scoretranscript.jsonl · append-onlysrc/transcript

    Werdykt Verifiera jest zapisywany jako zdarzenie judge.score. To osąd modelu, a nie fakt dotyczący wykonania.

  5. Stan → kolejne efektysrc/reducerocena · dowody QAOchrona przed oszustwem · korekta ocenysrc/validator

    Przy judge.score reducer przekazuje je do kontroli ochrony przed oszustwem razem z wynikiem QA, dostawcą Buildera oraz planem i dowodami z researchu.

  6. Ochrona przed oszustwem · korekta ocenysrc/validatorskorygowany werdyktKierowanie według werdyktusrc/reducer

    PASS bez udanego wykonania staje się FAIL, a ocena związana z wykonaniem jest korygowana na podstawie deterministycznego QA. Pozostałe reguły to korekty warunkowe, a nie ogólny dowód prawdomówności.

  7. Kierowanie według werdyktusrc/reducerkoniecKoniec · PASS lub przyczyna zatrzymaniasession done

    PASS kończy sesję jako done. Zatrzymania przez budżet i circuit również kończą się jako done, ale zachowują przyczynę zatrzymania, więc done nie zawsze oznacza PASS.

Awarie i sterowanie przez człowieka

PARTIAL trafia do człowieka, Critical do przeprojektowania, Important lub Minor do naprawy, a zatrzymania przez budżet lub circuit zostawiają przyczynę zatrzymania.

  1. Ochrona przed oszustwem · korekta ocenysrc/validatorskorygowany werdyktKierowanie według werdyktusrc/reducer

    PASS bez udanego wykonania staje się FAIL, a ocena związana z wykonaniem jest korygowana na podstawie deterministycznego QA. Pozostałe reguły to korekty warunkowe, a nie ogólny dowód prawdomówności.

  2. Kierowanie według werdyktusrc/reducerkontrola PARTIALPomysł na grę · sterowanie

    PARTIAL czeka na sprawdzenie przez człowieka.

  3. Kierowanie według werdyktusrc/reducerprzeprojektowanie · naprawasrc/dispatcher/live.ts

    Spośród FAIL i REJECT Critical wraca do Plannera do przeprojektowania, a Important lub Minor do Buildera jako informacja o poprawkach; wszystko jest wykonywane jako efekty dispatchera.

  4. Kierowanie według werdyktusrc/reducerkoniecKoniec · PASS lub przyczyna zatrzymaniasession done

    PASS kończy sesję jako done. Zatrzymania przez budżet i circuit również kończą się jako done, ale zachowują przyczynę zatrzymania, więc done nie zawsze oznacza PASS.

  5. Pomysł na grę · sterowaniepomysł · sterowanieZapis poleceń do inboxapackages/studio

    Jednozdaniowy pomysł na grę i sterowanie w języku naturalnym wprowadza się w Studio, które zapisuje polecenia do inboxa. Studio nigdy nie edytuje transkryptu bezpośrednio.

Odtwarzanie i obserwacja

Odbudowa stanu z transkryptu nie wykonuje żadnych efektów, a Studio czyta ten sam zapis, by go pokazać.

  1. transcript.jsonl · append-onlysrc/transcriptnowe zdarzenia · replayPętla zdarzeń · replay · tailsrc/loop/coordinator.ts

    Writer waliduje schemat, nadaje ULID i czas, po czym dopisuje. Przy odtwarzaniu przeszłe zdarzenia są tylko redukowane; ich efekty nie są wykonywane ponownie.

  2. Pętla zdarzeń · replay · tailsrc/loop/coordinator.tsredukcja po koleiStan → kolejne efektysrc/reducer

    Zdarzenia na żywo są redukowane pojedynczo z kolejki, z zachowaniem kolejności efektów każdego zdarzenia; sam dispatch działa asynchronicznie.

  3. transcript.jsonl · append-onlysrc/transcriptodczyt · SSEWidok zdarzeń · artefaktówpackages/studio

    Studio odczytuje transkrypt i artefakty i pokazuje postęp, metryki i artefakty przez SSE. To nie telemetria wysyłana do zdalnej usługi.

Każde połączenie z tą samą wagą. Wybór przepływu wyróżnia tylko jego ścieżkę z ponumerowanymi krokami.

  • Linia ciągła · kierunek wejścia, wyników i zapisów
  • Linia przerywana · uruchomienie, rozstrzygnięcie, żądanie
  • Długie kropki · obserwacja i raportowanie, oddzielnie od rozstrzygnięcia
  • Gruba czarna linia · wybrany przepływ; liczby podają kolejność
  • Ramka · granica kodu lub stanu, nazwana w nagłówku
  • Wewnętrzny element · komponent tej granicy
  • Kropkowana ramka · poza tą granicą
  • Pomarańczowy obrys · miejsce, w którym decyduje model
  • Pętla zdarzeń · reducer · dispatcher
  • Zapisy · konfiguracja · artefakty
  • Kontrole deterministyczne · korekta
  • Studio · aktorzy

Narysowano na podstawie ścieżek kodu w publicznym commicie f5e17c0. Aktorzy to role w czasie działania, odrębne od agentów kodujących użytych do budowy tego repozytorium.

Źródło stanu
Transkrypt jest źródłem stanu, a reducer jest czystą funkcją. Efekty uboczne (uruchamianie aktorów, QA, zapis plików) wykonuje tylko dispatcher, więc odtwarzanie odbudowuje stan bez efektów.
Co obejmuje odtwarzanie
Odtwarzanie daje ten sam stan; nie czyni deterministycznymi generacji LLM ani zachowania przeglądarki i sieci.
Co obejmuje werdykt
QA wykonania sprawdza tylko skonfigurowane kontrole, a ocena Verifiera jest jednym kanałem dowodów. Żadne z nich nie mierzy każdego zachowania gry, zabawy ani zadowolenia użytkowników.