TR
CRUMB logosundaki yalnızca ekmek karakteri: sağ üst köşesinden bir ısırık alınmış, gülümseyen bir dilim ekmek
Salona dön

CRUMB

Generative Game Studio · Demo

Tek satırlık bir oyun fikrinden oynanabilir bir taslağa, ajanların çalışması görünür ve müdahaleye açık hâlde.

CRUMB, gündelik oyun prototiplemesi için çok ajanlı bir stüdyo düzeneğidir.

Tasarım ve geliştirme · AI kodlama ajanlarıyla kuruldu

  • CLIYerel tanıtım
  • Web stüdyosuYerel tanıtım

Oyunu kuran ajanlar, onu yargılayan kanıttan ayrı tutulur.

Tek satırlık bir oyun fikrini şartname, derleme ve yürütme kontrollerinden geçiren yerel bir stüdyo tanıtımı. Her adım bir JSONL dökümüne düşer, saf bir reducer sonraki etkileri belirler ve yan etkileri yalnızca dispatcher gerçekleştirir. Yürütme QA'sı ve modelin hükmü; geçiş, yeniden tasarım, onarım ve insan yönlendirmesi arasında karar vermek için ayrı tutulur.

Tek satırda bir oyun önerin; Claude Code, Codex ve Gemini CLI ajanları Planner → Builder → deterministik QA → Verifier üzerinden iş birliği yapar, CRUMB Studio da olayları, ilerlemeyi ve artefaktları gösterir ve doğal dilde müdahaleyi kabul eder.

Herkese açık depodan klonlayıp yerelde çalıştırdığınız bir tanıtım.

Sistem haritası · herkese açık f5e17c0 commit'indeki kod yollarından çizildi
CRUMB stüdyo sistemiBir kişi Studio'dan bir oyun önerir ve yön verir; Studio komutları bir inbox'a yazar. Coordinator, inbox'tan ve dökümden gelen yeni olayları sırayla reducer'a aktarır; saf reducer durumu ve sonraki etkileri belirler ve yan etkileri yalnızca dispatcher gerçekleştirir. Planner'ın şartnamesi, Builder'ın derlemesi ve artefaktları, yürütme QA sonucu ve Verifier'ın yargısı hep döküm olaylarına dönüşür. Verifier yalnızca yansıtılmış kanıt alır ve reducer onun puanını QA sonucuna göre kontrol edip düzeltir: PASS oturumu bitirir, PARTIAL bir kişiyi bekler, geri kalan her şey yeniden tasarıma ya da onarıma döner.Oyun fikri · yönlendirmeYerelde çalıştıran bir kişipackages/studioOlaylar · artefakt görünümüInbox komutlarını yazsrc/transcripttranscript.jsonl · append-onlysrc/loop/coordinator.tsOlay döngüsü · replay · tailsrc/reducerDurum → sonraki etkilerHüküm yönlendirmesession doneBitti · PASS ya da durma nedenisrc/dispatcher/live.tsEtkileri çalıştır · actor'leri spawn etHakem girdisi yansıtmamodel-config · presetActor → düzenek · modelagent actor · CLIPlanner Lead · şartnameBuilder · oyunu yazarartifacts/Oyun dosyalarıdispatcher/qa-runner.tsYürütme QA'sı · kontrollerVerifier actorVerifier · model hükmüsrc/validatorAldatma önleme · puan düzeltmeKişiler · StudioOlay denetimidöküm, durumun kaynağıdırÇalışan ajanlar · artefaktlarDoğrulama · karar1öner · yön ver2user olayları3sırayla reduce et4etkiler5actor kurulumu6Planner'ı çalıştır7spec8Builder'ı çalıştır9 dosyalar · Builder · oyunu yazar → Oyun dosyaları910derleme kaydı11qa_check12ne çalışır13qa.result1qa.result2yalnızca kanıt3hakem girdisi4judge.score5puan · QA kanıtı6düzeltilmiş hüküm7bitti1düzeltilmiş hüküm2PARTIAL kontrolü3yeniden tasarım · onarım4bitti5öner · yön ver1yeni olaylar · replay2sırayla reduce et3okuma · SSE

Fikirden oyuna

Bir fikir şartnameye, derlemeye ve bir yürütme QA çalıştırmasına dönüşür. Her adım dökümden geçer; actor'ler birbirini çağırmaz.

  1. Oyun fikri · yönlendirmeöner · yön verInbox komutlarını yazpackages/studio

    Tek satırlık bir oyun fikri ve doğal dilde yönlendirme Studio'ya girilir; Studio komutları inbox'a yazar. Studio dökümü asla doğrudan düzenlemez.

  2. Inbox komutlarını yazpackages/studiouser olaylarıOlay döngüsü · replay · tailsrc/loop/coordinator.ts

    Coordinator inbox komutlarını okur ve dökümde user olayları olarak kaydeder.

  3. Olay döngüsü · replay · tailsrc/loop/coordinator.tssırayla reduce etDurum → sonraki etkilersrc/reducer

    Canlı olaylar bir kuyruktan tek tek reduce edilir ve her olayın etkileri sırasıyla korunur; dispatch'in kendisi eşzamansız çalışır.

  4. Durum → sonraki etkilersrc/reduceretkilerEtkileri çalıştır · actor'leri spawn etsrc/dispatcher/live.ts

    Reducer yalnızca durumu ve sonraki etkileri belirleyen saf bir fonksiyondur: bir goal Planner'ı, bir spec Builder'ı, bir build bir qa_check'i seçer.

  5. Actor → düzenek · modelmodel-config · presetactor kurulumusrc/dispatcher/live.ts

    Bir actor'ü hangi düzenek, sağlayıcı ve modelin çalıştıracağı CLI bayrağı > yapılandırma > preset > ambient > fallback sırasıyla çözülür. Bir actor sabit bir sağlayıcı değildir.

  6. Etkileri çalıştır · actor'leri spawn etsrc/dispatcher/live.tsPlanner'ı çalıştırPlanner Lead · şartnameagent actor · CLI

    Dispatcher Planner'ı yansıtılmış girdiyle çalıştırır. Koşullu araştırma Planner'ın araştırma planı ve kanıt devriyle sürer; bu haritada katlanmıştır.

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

    Planner'ın şartnamesi bir döküm olayına dönüşür ve reducer ondan Builder'ı seçer. Actor'ler birbirini çağırmaz.

  8. Etkileri çalıştır · actor'leri spawn etsrc/dispatcher/live.tsBuilder'ı çalıştırBuilder · oyunu yazaragent actor · CLI

    Dispatcher Builder'ı çalıştırır. Aynı actor başarısız olmaya devam ederse bir circuit açılır ve adaptörü değiştirir; hatalar sürerse durur.

  9. Builder · oyunu yazaragent actor · CLIdosyalarOyun dosyalarıartifacts/

    Builder giriş dosyasını, kaynakları ve varlıkları artefakt olarak yazar.

  10. Builder · oyunu yazaragent actor · CLIderleme kaydıtranscript.jsonl · append-onlysrc/transcript

    Build olayı ve artifact.created, artefaktın kimliğiyle birlikte dökümde kaydedilir.

  11. Etkileri çalıştır · actor'leri spawn etsrc/dispatcher/live.tsqa_checkYürütme QA'sı · kontrollerdispatcher/qa-runner.ts

    Bir build olayından sonra reducer artefakt ve build kimliğini ve kabul koşullarını taşıyan bir qa_check etkisi yayar ve dispatcher onu çalıştırır.

  12. Oyun dosyalarıartifacts/ne çalışırYürütme QA'sı · kontrollerdispatcher/qa-runner.ts

    Yürütme QA'sı gerçek artefaktı kod ve tarayıcı kontrolleriyle çalıştırır. 120 saniyelik varsayılan zaman aşımı bir yapılandırma değeridir.

  13. Yürütme QA'sı · kontrollerdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Başarılı ya da başarısız, sonuç bir system qa.result olayı olarak kaydedilir. Kontrol bir istisna fırlatsa bile başarısız alanları içeren bir sonuç kaydedilir.

Doğrulamanın güven sınırı

Yürütme QA'sı artefaktı gerçekten çalıştırmaktan gelen kanıttır; Verifier ise yansıtılmış kanıtı yargılayan bir modeldir. Reducer, sonraki yolu seçmeden önce ikisini uzlaştırır.

  1. Yürütme QA'sı · kontrollerdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Başarılı ya da başarısız, sonuç bir system qa.result olayı olarak kaydedilir. Kontrol bir istisna fırlatsa bile başarısız alanları içeren bir sonuç kaydedilir.

  2. transcript.jsonl · append-onlysrc/transcriptyalnızca kanıtHakem girdisi yansıtmasrc/dispatcher/live.ts

    Verifier'ın girdisi en son goal, spec, build, qa.result ve artifact.created ile seçilmiş araştırma kanıtından yansıtılır. Bağlamı daraltır; yalıtımı ya da sızıntı olmadığını kanıtlamaz.

  3. Hakem girdisi yansıtmasrc/dispatcher/live.tshakem girdisiVerifier · model hükmüVerifier actor

    Dispatcher Verifier'ı yansıtılmış girdiyle çalıştırır.

  4. Verifier · model hükmüVerifier actorjudge.scoretranscript.jsonl · append-onlysrc/transcript

    Verifier'ın hükmü bir judge.score olayı olarak kaydedilir. Bu bir modelin yargısıdır, yürütmeye dair bir olgu değil.

  5. Durum → sonraki etkilersrc/reducerpuan · QA kanıtıAldatma önleme · puan düzeltmesrc/validator

    judge.score geldiğinde reducer onu QA sonucu, Builder'ın sağlayıcısı ve araştırma planı ile kanıtıyla birlikte aldatma önleme kontrolüne aktarır.

  6. Aldatma önleme · puan düzeltmesrc/validatordüzeltilmiş hükümHüküm yönlendirmesrc/reducer

    Başarılı bir yürütme olmadan verilen PASS, FAIL olur ve yürütmeyle ilgili puan deterministik QA'dan düzeltilir. Diğer kurallar koşullu düzeltmelerdir; genel bir doğruluk kanıtı değildir.

  7. Hüküm yönlendirmesrc/reducerbittiBitti · PASS ya da durma nedenisession done

    PASS oturumu done olarak bitirir. Bütçe ve circuit durmaları da done olarak biter ama durma nedenini korur; dolayısıyla done her zaman PASS değildir.

Hata ve insan yönlendirmesi

PARTIAL bir kişiye, Critical yeniden tasarıma, Important ya da Minor onarıma gider; bütçe ya da circuit durmaları bir durma nedeni bırakır.

  1. Aldatma önleme · puan düzeltmesrc/validatordüzeltilmiş hükümHüküm yönlendirmesrc/reducer

    Başarılı bir yürütme olmadan verilen PASS, FAIL olur ve yürütmeyle ilgili puan deterministik QA'dan düzeltilir. Diğer kurallar koşullu düzeltmelerdir; genel bir doğruluk kanıtı değildir.

  2. Hüküm yönlendirmesrc/reducerPARTIAL kontrolüOyun fikri · yönlendirme

    PARTIAL bir kişinin kontrol etmesini bekler.

  3. Hüküm yönlendirmesrc/reduceryeniden tasarım · onarımsrc/dispatcher/live.ts

    FAIL ve REJECT arasında Critical yeniden tasarım için Planner'a, Important ya da Minor düzeltme geri bildirimi olarak Builder'a döner; hepsi dispatcher etkileri olarak çalışır.

  4. Hüküm yönlendirmesrc/reducerbittiBitti · PASS ya da durma nedenisession done

    PASS oturumu done olarak bitirir. Bütçe ve circuit durmaları da done olarak biter ama durma nedenini korur; dolayısıyla done her zaman PASS değildir.

  5. Oyun fikri · yönlendirmeöner · yön verInbox komutlarını yazpackages/studio

    Tek satırlık bir oyun fikri ve doğal dilde yönlendirme Studio'ya girilir; Studio komutları inbox'a yazar. Studio dökümü asla doğrudan düzenlemez.

Yeniden oynatma ve gözlem

Durumu dökümden yeniden kurmak hiçbir etkiyi çalıştırmaz ve Studio göstermek için aynı kaydı okur.

  1. transcript.jsonl · append-onlysrc/transcriptyeni olaylar · replayOlay döngüsü · replay · tailsrc/loop/coordinator.ts

    Writer şemayı doğrular, bir ULID ve zaman atar ve ekler. Replay sırasında geçmiş olaylar yalnızca reduce edilir; etkileri yeniden çalıştırılmaz.

  2. Olay döngüsü · replay · tailsrc/loop/coordinator.tssırayla reduce etDurum → sonraki etkilersrc/reducer

    Canlı olaylar bir kuyruktan tek tek reduce edilir ve her olayın etkileri sırasıyla korunur; dispatch'in kendisi eşzamansız çalışır.

  3. transcript.jsonl · append-onlysrc/transcriptokuma · SSEOlaylar · artefakt görünümüpackages/studio

    Studio dökümü ve artefaktları okur ve ilerlemeyi, metrikleri ve artefaktları SSE üzerinden gösterir. Uzak bir hizmete gönderilen telemetri değildir.

Her bağlantı aynı kalınlıkta. Yalnızca yolunu numaralı adımlarla vurgulamak için bir akış seçin.

  • Düz çizgi · girdi, sonuç ve kayıtların yönü
  • Kesikli · çalıştırma, yargı, istek
  • Uzun noktalar · gözlem ve raporlama, yargıdan ayrı
  • Kalın siyah çizgi · seçilen akış; numaralar sırayı verir
  • Kutu · bir kod ya da durum sınırı, adı başlığında
  • İç çip · o sınırın bir bileşeni
  • Noktalı kutu · o sınırın dışı
  • Turuncu çerçeve · bir modelin karar verdiği yer
  • Olay döngüsü · reducer · dispatcher
  • Kayıtlar · kurulum · artefaktlar
  • Deterministik kontroller · düzeltme
  • Studio · actor'ler

Herkese açık f5e17c0 commit'indeki kod yollarından çizildi. Actor'ler çalışma zamanı rolleridir; bu depoyu kurmak için kullanılan kodlama ajanlarından farklıdır.

Durumun kaynağı
Döküm durumun kaynağıdır ve reducer saf bir fonksiyondur. Yan etkileri (actor'leri çalıştırmak, QA, dosya yazmak) yalnızca dispatcher gerçekleştirir; bu yüzden yeniden oynatma durumu etkiler olmadan yeniden kurar.
Yeniden oynatmanın kapsamı
Yeniden oynatma aynı durumu verir; LLM üretimlerini ya da tarayıcı ve ağ davranışını deterministik yapmaz.
Hükmün kapsamı
Yürütme QA'sı yalnızca yapılandırılmış kontrolleri denetler ve Verifier'ın puanı kanıtın tek bir kanalıdır. Hiçbiri oyunun her davranışını, eğlencesini ya da kullanıcı memnuniyetini ölçmez.