FI
Pelkkä leipähahmo CRUMB-logosta: hymyilevä leipäviipale, jonka oikeasta yläkulmasta on haukattu pala
Takaisin saliin

CRUMB

Generative Game Studio · Demo

Yhden rivin peli-ideasta pelattavaan luonnokseen, agenttien työ näkyvillä ja ohjattavissa.

CRUMB on moniagenttinen studiokehys kevyiden pelien prototypointiin.

Suunnittelu ja kehitys · rakennettu AI-koodausagenttien avulla

  • CLIPaikallinen demo
  • Web StudioPaikallinen demo

Pelin rakentavat agentit, erillään näytöstä, jolla se arvioidaan.

Paikallinen studiodemo, joka vie yhden rivin peli-idean määrittelyn, koonnin ja suoritustarkistusten läpi. Jokainen vaihe päätyy JSONL-transkriptiin, puhdas reducer-funktio päättää seuraavat vaikutukset, ja vain dispatcher suorittaa sivuvaikutukset. Suoritus-QA ja mallin tuomio pidetään erillään, kun valitaan läpäisyn, uudelleensuunnittelun, korjauksen ja ihmisen ohjauksen välillä.

Kuvaile peli yhdellä rivillä, ja Claude Code-, Codex- ja Gemini CLI -agentit työskentelevät yhdessä järjestyksessä Planner → Builder → deterministinen QA → Verifier, samalla kun CRUMB Studio näyttää tapahtumat, edistymisen ja artefaktit ja ottaa vastaan luonnollisen kielen ohjausta.

Demo, joka kloonataan julkisesta repositoriosta ja ajetaan paikallisesti.

Järjestelmäkartta · piirretty julkisen commitin f5e17c0 koodipoluista
CRUMB-studion järjestelmäIhminen kuvailee ja ohjaa peliä Studiossa, ja Studio kirjoittaa komennot inbox-tiedostoon. Coordinator välittää inboxin ja transkriptin uudet tapahtumat järjestyksessä reducer-funktiolle; puhdas reducer päättää tilan ja seuraavat vaikutukset, ja vain dispatcher suorittaa sivuvaikutukset. Plannerin määrittely, Builderin koonti ja artefaktit, suoritus-QA:n tulos ja Verifierin tuomio tulevat kaikki transkriptitapahtumiksi. Verifier saa vain projisoitua näyttöä, ja reducer tarkistaa ja korjaa sen pisteet QA-tulosta vasten: PASS päättää istunnon, PARTIAL odottaa ihmistä, ja kaikki muu palaa uudelleensuunniteltavaksi tai korjattavaksi.Peli-idea · ohjausIhminen, paikallisestipackages/studioTapahtuma- · artefaktinäkymäKomennot inboxiinsrc/transcripttranscript.jsonl · append-onlysrc/loop/coordinator.tsTapahtumasilmukka · uudelleentoisto · seurantasrc/reducerTila → seuraavat vaikutuksetTuomion reitityssession doneValmis · PASS tai pysähtymissyysrc/dispatcher/live.tsVaikutusten suoritus · toimijoiden käynnistysTuomarin syötteen projektiomodel-config · presetToimija → kehys · malliagent actor · CLIPlanner Lead · määrittelyBuilder · kirjoittaa pelinartifacts/Pelitiedostotdispatcher/qa-runner.tsSuoritus-QA · tarkistuksetVerifier actorVerifier · mallin tuomiosrc/validatorHarhautuksen esto · pisteiden korjausIhmiset · StudioTapahtumien ohjaustranskripti on tilan lähdeTyöagentit · artefaktitTodentaminen · päätös1idea · ohjaus2käyttäjätapahtumat3redusointi järjestyksessä4vaikutukset5toimijan asetus6Plannerin ajo7spec8Builderin ajo9 tiedostot · Builder · kirjoittaa pelin → Pelitiedostot910koontikirjaus11qa_check12mitä ajetaan13qa.result1qa.result2vain näyttö3tuomarin syöte4judge.score5pisteet · QA-näyttö6korjattu tuomio7valmis1korjattu tuomio2PARTIAL-tarkistus3uudelleensuunnittelu · korjaus4valmis5idea · ohjaus1uudet tapahtumat · uudelleentoisto2redusointi järjestyksessä3luku · SSE

Ideasta pelattavaksi

Ideasta tulee määrittely, koonti ja suoritus-QA-ajo. Jokainen vaihe kulkee transkriptin kautta; toimijat eivät kutsu toisiaan.

  1. Peli-idea · ohjausidea · ohjausKomennot inboxiinpackages/studio

    Yhden rivin peli-idea ja luonnollisen kielen ohjaus syötetään Studioon, joka kirjoittaa komennot inboxiin. Studio ei koskaan muokkaa transkriptia suoraan.

  2. Komennot inboxiinpackages/studiokäyttäjätapahtumatTapahtumasilmukka · uudelleentoisto · seurantasrc/loop/coordinator.ts

    Coordinator lukee inboxin komennot ja kirjaa ne transkriptiin käyttäjätapahtumina.

  3. Tapahtumasilmukka · uudelleentoisto · seurantasrc/loop/coordinator.tsredusointi järjestyksessäTila → seuraavat vaikutuksetsrc/reducer

    Live-tapahtumat redusoidaan yksi kerrallaan jonosta, jolloin kunkin tapahtuman vaikutukset pysyvät järjestyksessä; itse välitys ajetaan asynkronisesti.

  4. Tila → seuraavat vaikutuksetsrc/reducervaikutuksetVaikutusten suoritus · toimijoiden käynnistyssrc/dispatcher/live.ts

    Reducer on puhdas funktio, joka päättää vain tilan ja seuraavat vaikutukset: tavoite valitsee Plannerin, määrittely Builderin, koonti qa_check-tarkistuksen.

  5. Toimija → kehys · mallimodel-config · presettoimijan asetussrc/dispatcher/live.ts

    Mikä kehys, mallitoimittaja ja malli ajaa toimijaa, ratkaistaan järjestyksessä CLI-valitsin > config > preset > ambient > fallback. Toimija ei ole kiinteä mallitoimittaja.

  6. Vaikutusten suoritus · toimijoiden käynnistyssrc/dispatcher/live.tsPlannerin ajoPlanner Lead · määrittelyagent actor · CLI

    Dispatcher ajaa Plannerin projisoidulla syötteellä. Ehdollinen tutkimus jatkuu Plannerin tutkimussuunnitelman ja näytön luovutuksen kautta, ja se on tällä kartalla taitettu piiloon.

  7. Planner Lead · määrittelyagent actor · CLIspectranscript.jsonl · append-onlysrc/transcript

    Plannerin määrittelystä tulee transkriptitapahtuma, ja reducer valitsee sen perusteella Builderin. Toimijat eivät kutsu toisiaan.

  8. Vaikutusten suoritus · toimijoiden käynnistyssrc/dispatcher/live.tsBuilderin ajoBuilder · kirjoittaa pelinagent actor · CLI

    Dispatcher ajaa Builderin. Jos sama toimija epäonnistuu toistuvasti, katkaisija laukeaa ja vaihtaa sovittimen, ja ajo pysähtyy, jos epäonnistumiset jatkuvat.

  9. Builder · kirjoittaa pelinagent actor · CLItiedostotPelitiedostotartifacts/

    Builder kirjoittaa aloitustiedoston, lähdekoodit ja resurssit artefakteina.

  10. Builder · kirjoittaa pelinagent actor · CLIkoontikirjaustranscript.jsonl · append-onlysrc/transcript

    Koontitapahtuma ja artifact.created kirjataan transkriptiin artefaktin tunnisteen kanssa.

  11. Vaikutusten suoritus · toimijoiden käynnistyssrc/dispatcher/live.tsqa_checkSuoritus-QA · tarkistuksetdispatcher/qa-runner.ts

    Koontitapahtuman jälkeen reducer lähettää qa_check-vaikutuksen, joka kantaa artefaktin ja koonnin tunnisteet ja hyväksymisehdot, ja dispatcher ajaa sen.

  12. Pelitiedostotartifacts/mitä ajetaanSuoritus-QA · tarkistuksetdispatcher/qa-runner.ts

    Suoritus-QA ajaa varsinaisen artefaktin koodi- ja selaintarkistuksilla. 120 sekunnin oletusaikakatkaisu on konfiguraatioarvo.

  13. Suoritus-QA · tarkistuksetdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Onnistui tai epäonnistui, tulos kirjataan järjestelmän qa.result-tapahtumana. Vaikka tarkistus heittäisi poikkeuksen, kirjataan tulos, jossa on epäonnistumista kuvaavat kentät.

Todentamisen luottamusraja

Suoritus-QA on näyttöä artefaktin todellisesta ajamisesta; Verifier on malli, joka arvioi projisoitua näyttöä. Reducer sovittaa nämä kaksi yhteen ennen seuraavan polun valintaa.

  1. Suoritus-QA · tarkistuksetdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Onnistui tai epäonnistui, tulos kirjataan järjestelmän qa.result-tapahtumana. Vaikka tarkistus heittäisi poikkeuksen, kirjataan tulos, jossa on epäonnistumista kuvaavat kentät.

  2. transcript.jsonl · append-onlysrc/transcriptvain näyttöTuomarin syötteen projektiosrc/dispatcher/live.ts

    Verifierin syöte projisoidaan viimeisimmästä tavoitteesta, määrittelystä, koonnista, qa.resultista ja artifact.createdista sekä valitusta tutkimusnäytöstä. Se rajaa kontekstia; se ei todista eristystä tai vuotamattomuutta.

  3. Tuomarin syötteen projektiosrc/dispatcher/live.tstuomarin syöteVerifier · mallin tuomioVerifier actor

    Dispatcher ajaa Verifierin projisoidulla syötteellä.

  4. Verifier · mallin tuomioVerifier actorjudge.scoretranscript.jsonl · append-onlysrc/transcript

    Verifierin tuomio kirjataan judge.score-tapahtumana. Se on mallin arvio, ei tosiasia suorituksesta.

  5. Tila → seuraavat vaikutuksetsrc/reducerpisteet · QA-näyttöHarhautuksen esto · pisteiden korjaussrc/validator

    judge.score-tapahtumassa reducer välittää sen harhautuksen estoon yhdessä QA-tuloksen, Builderin mallitoimittajan sekä tutkimussuunnitelman ja -näytön kanssa.

  6. Harhautuksen esto · pisteiden korjaussrc/validatorkorjattu tuomioTuomion reitityssrc/reducer

    PASS ilman onnistunutta suoritusta muuttuu FAILiksi, ja suoritukseen liittyvä pistemäärä korjataan deterministisen QA:n mukaan. Muut säännöt ovat ehdollisia korjauksia, eivät yleinen todiste totuudellisuudesta.

  7. Tuomion reitityssrc/reducervalmisValmis · PASS tai pysähtymissyysession done

    PASS päättää istunnon tilaan done. Budjetti- ja katkaisijapysähdykset päättyvät myös tilaan done mutta säilyttävät pysähtymissyynsä, joten done ei aina ole PASS.

Epäonnistuminen ja ihmisen ohjaus

PARTIAL menee ihmiselle, Critical uudelleensuunnitteluun, Important tai Minor korjaukseen, ja budjetti- tai katkaisijapysähdykset jättävät pysähtymissyyn.

  1. Harhautuksen esto · pisteiden korjaussrc/validatorkorjattu tuomioTuomion reitityssrc/reducer

    PASS ilman onnistunutta suoritusta muuttuu FAILiksi, ja suoritukseen liittyvä pistemäärä korjataan deterministisen QA:n mukaan. Muut säännöt ovat ehdollisia korjauksia, eivät yleinen todiste totuudellisuudesta.

  2. Tuomion reitityssrc/reducerPARTIAL-tarkistusPeli-idea · ohjaus

    PARTIAL odottaa ihmisen tarkistusta.

  3. Tuomion reitityssrc/reduceruudelleensuunnittelu · korjaussrc/dispatcher/live.ts

    Tuomioista FAIL ja REJECT Critical palaa Plannerille uudelleensuunniteltavaksi ja Important tai Minor Builderille korjauspalautteeksi, kaikki dispatcherin vaikutuksina ajettuina.

  4. Tuomion reitityssrc/reducervalmisValmis · PASS tai pysähtymissyysession done

    PASS päättää istunnon tilaan done. Budjetti- ja katkaisijapysähdykset päättyvät myös tilaan done mutta säilyttävät pysähtymissyynsä, joten done ei aina ole PASS.

  5. Peli-idea · ohjausidea · ohjausKomennot inboxiinpackages/studio

    Yhden rivin peli-idea ja luonnollisen kielen ohjaus syötetään Studioon, joka kirjoittaa komennot inboxiin. Studio ei koskaan muokkaa transkriptia suoraan.

Uudelleentoisto ja havainnointi

Tilan uudelleenrakentaminen transkriptista ei aja vaikutuksia, ja Studio näyttää saman kirjauksen lukemalla sen.

  1. transcript.jsonl · append-onlysrc/transcriptuudet tapahtumat · uudelleentoistoTapahtumasilmukka · uudelleentoisto · seurantasrc/loop/coordinator.ts

    Kirjoittaja validoi skeeman, antaa ULID-tunnisteen ja ajan ja lisää tapahtuman loppuun. Uudelleentoistossa menneet tapahtumat vain redusoidaan; niiden vaikutuksia ei ajeta uudelleen.

  2. Tapahtumasilmukka · uudelleentoisto · seurantasrc/loop/coordinator.tsredusointi järjestyksessäTila → seuraavat vaikutuksetsrc/reducer

    Live-tapahtumat redusoidaan yksi kerrallaan jonosta, jolloin kunkin tapahtuman vaikutukset pysyvät järjestyksessä; itse välitys ajetaan asynkronisesti.

  3. transcript.jsonl · append-onlysrc/transcriptluku · SSETapahtuma- · artefaktinäkymäpackages/studio

    Studio lukee transkriptin ja artefaktit ja näyttää edistymisen, mittarit ja artefaktit SSE:n kautta. Se ei ole etäpalveluun lähetettävää telemetriaa.

Kaikki yhteydet samalla painolla. Valitse virta, niin vain sen polku korostuu numeroiduin vaihein.

  • Yhtenäinen · syötteiden, tulosten ja kirjausten suunta
  • Katkoviiva · suoritus, arvio, pyyntö
  • Pitkät pisteet · havainnointi ja raportointi, erillään arviosta
  • Paksu musta viiva · valittu virta; numerot kertovat järjestyksen
  • Laatikko · koodin tai tilan raja, nimi otsakkeessa
  • Sisälaatta · rajan komponentti
  • Pisteviivalaatikko · rajan ulkopuolella
  • Oranssi ääriviiva · kohta, jossa malli päättää
  • Tapahtumasilmukka · reducer · dispatcher
  • Kirjaukset · asetukset · artefaktit
  • Deterministiset tarkistukset · korjaus
  • Studio · toimijat

Piirretty julkisen commitin f5e17c0 koodipoluista. Toimijat ovat ajonaikaisia rooleja, erillään tämän repositorion rakentamiseen käytetyistä koodausagenteista.

Tilan lähde
Transkripti on tilan lähde ja reducer on puhdas funktio. Vain dispatcher suorittaa sivuvaikutukset (toimijoiden ajo, QA, tiedostojen kirjoitus), joten uudelleentoisto rakentaa tilan uudelleen ilman vaikutuksia.
Mitä uudelleentoisto kattaa
Uudelleentoisto tuottaa saman tilan; se ei tee LLM-generoinneista eikä selaimen ja verkon käyttäytymisestä determinististä.
Mitä tuomio kattaa
Suoritus-QA tarkistaa vain konfiguroidut tarkistukset, ja Verifierin pisteet ovat yksi näyttökanava. Kumpikaan ei mittaa jokaista pelin käyttäytymistä, hauskuutta tai käyttäjätyytyväisyyttä.