UK
Лише персонаж-хлібина з логотипа CRUMB: усміхнена скибка хліба з надкушеним правим верхнім кутом
Назад до зали

CRUMB

Generative Game Studio · Demo

Від однорядкової ідеї гри до чернетки, у яку можна грати, — з роботою агентів на виду й можливістю втрутитися.

CRUMB — мультиагентна студійна обв’язка для прототипування казуальних ігор.

Проєктування й розробка · створено з AI-агентами для програмування

  • CLIЛокальне демо
  • Веб-StudioЛокальне демо

Агенти, що створюють гру, окремо від доказів, які її оцінюють.

Локальне демо студії, що проводить однорядкову ідею гри через перевірки специфікації, збірки й виконання. Кожен крок потрапляє до транскрипту JSONL, чистий reducer визначає наступні ефекти, а побічні ефекти виконує лише dispatcher. QA виконання й вердикт моделі тримають окремо, щоб обрати між успіхом, переробленням дизайну, виправленням і керуванням людиною.

Достатньо описати гру одним рядком, і агенти Claude Code, Codex і Gemini CLI співпрацюють за схемою Planner → Builder → детермінований QA → Verifier, а CRUMB Studio показує події, поступ і артефакти й приймає втручання природною мовою.

Демо, яке клонують із публічного репозиторію й запускають локально.

Карта системи · накреслено за шляхами коду на публічному коміті f5e17c0
Система студії CRUMBЛюдина пропонує гру й керує нею зі Studio, а Studio записує команди в inbox. Coordinator по черзі передає нові події з inbox і транскрипту до reducer; чистий reducer визначає стан і наступні ефекти, а побічні ефекти виконує лише dispatcher. Специфікація Planner, збірка й артефакти Builder, результат QA виконання й рішення Verifier — усе стає подіями транскрипту. Verifier отримує лише спроєктовані докази, а reducer перевіряє й виправляє його оцінку за результатом QA: PASS завершує сесію, PARTIAL чекає на людину, а все інше повертається на перероблення дизайну чи виправлення.Ідея гри · керуванняЛюдина, локальний запускpackages/studioПерегляд подій · артефактівЗапис команд в inboxsrc/transcripttranscript.jsonl · append-onlysrc/loop/coordinator.tsЦикл подій · відтворення · tailsrc/reducerСтан → наступні ефектиМаршрутизація вердиктуsession doneГотово · PASS або причина зупинкиsrc/dispatcher/live.tsВиконання ефектів · spawn акторівПроєкція входу суддіmodel-config · presetАктор → обв’язка · модельagent actor · CLIPlanner Lead · специфікаціяBuilder · пише груartifacts/Файли гриdispatcher/qa-runner.tsQA виконання · перевіркиVerifier actorVerifier · вердикт моделіsrc/validatorЗахист від обману · виправлення оцінкиЛюди · StudioКерування подіямитранскрипт — джерело стануРобочі агенти · артефактиВерифікація · рішення1ідея · керування2події user3reduce по черзі4ефекти5налаштування актора6запуск Planner7spec8запуск Builder9файли10запис збірки11qa_check12що запускається13qa.result1qa.result2лише докази3вхід судді4judge.score5оцінка · докази QA6виправлений вердикт7готово1виправлений вердикт2перевірка PARTIAL3перероблення · виправлення4готово5ідея · керування1нові події · відтворення2reduce по черзі3читання · SSE

Від ідеї до гри

Ідея стає специфікацією, збіркою й запуском QA виконання. Кожен крок проходить через транскрипт; актори не викликають одне одного.

  1. Ідея гри · керуванняідея · керуванняЗапис команд в inboxpackages/studio

    Однорядкова ідея гри й керування природною мовою вводяться в Studio, яка записує команди в inbox. Studio ніколи не редагує транскрипт напряму.

  2. Запис команд в inboxpackages/studioподії userЦикл подій · відтворення · tailsrc/loop/coordinator.ts

    Coordinator читає команди з inbox і записує їх у транскрипт як події user.

  3. Цикл подій · відтворення · tailsrc/loop/coordinator.tsreduce по черзіСтан → наступні ефектиsrc/reducer

    Живі події по одній беруться з черги й проходять через reducer, зберігаючи порядок ефектів кожної події; сама передача виконується асинхронно.

  4. Стан → наступні ефектиsrc/reducerефектиВиконання ефектів · spawn акторівsrc/dispatcher/live.ts

    Reducer — чиста функція, що визначає лише стан і наступні ефекти: goal обирає Planner, spec — Builder, build — qa_check.

  5. Актор → обв’язка · модельmodel-config · presetналаштування актораsrc/dispatcher/live.ts

    Яка обв’язка, провайдер і модель запускають актора, визначається в порядку прапорець CLI > config > preset > ambient > fallback. Актор не є фіксованим провайдером.

  6. Виконання ефектів · spawn акторівsrc/dispatcher/live.tsзапуск PlannerPlanner Lead · специфікаціяagent actor · CLI

    Dispatcher запускає Planner зі спроєктованими вхідними даними. Умовне дослідження продовжується через план дослідження Planner і передачу доказів, згорнуті на цій карті.

  7. Planner Lead · специфікаціяagent actor · CLIspectranscript.jsonl · append-onlysrc/transcript

    Специфікація Planner стає подією транскрипту, і reducer за нею обирає Builder. Актори не викликають одне одного.

  8. Виконання ефектів · spawn акторівsrc/dispatcher/live.tsзапуск BuilderBuilder · пише груagent actor · CLI

    Dispatcher запускає Builder. Якщо той самий актор постійно зазнає збою, circuit розмикається й змінює адаптер, а якщо збої тривають — зупиняється.

  9. Builder · пише груagent actor · CLIфайлиФайли гриartifacts/

    Builder записує вхідний файл, джерела й ресурси як артефакти.

  10. Builder · пише груagent actor · CLIзапис збіркиtranscript.jsonl · append-onlysrc/transcript

    Подія build і artifact.created записуються в транскрипт з ідентичністю артефакту.

  11. Виконання ефектів · spawn акторівsrc/dispatcher/live.tsqa_checkQA виконання · перевіркиdispatcher/qa-runner.ts

    Після події build reducer випускає ефект qa_check з ідентичністю артефакту й збірки та умовами приймання, а dispatcher його виконує.

  12. Файли гриartifacts/що запускаєтьсяQA виконання · перевіркиdispatcher/qa-runner.ts

    QA виконання запускає справжній артефакт із перевірками коду й браузера. Типовий тайм-аут 120 секунд — значення конфігурації.

  13. QA виконання · перевіркиdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Успіх чи провал — результат записується як системна подія qa.result. Навіть якщо перевірка кидає виняток, записується результат із полями, що не пройшли.

Межа довіри верифікації

QA виконання — це докази від справжнього запуску артефакту; Verifier — модель, що оцінює спроєктовані докази. Reducer узгоджує їх перед вибором наступного шляху.

  1. QA виконання · перевіркиdispatcher/qa-runner.tsqa.resulttranscript.jsonl · append-onlysrc/transcript

    Успіх чи провал — результат записується як системна подія qa.result. Навіть якщо перевірка кидає виняток, записується результат із полями, що не пройшли.

  2. transcript.jsonl · append-onlysrc/transcriptлише доказиПроєкція входу суддіsrc/dispatcher/live.ts

    Вхід Verifier проєктується з останніх goal, spec, build, qa.result і artifact.created плюс вибраних доказів дослідження. Це звужує контекст; це не доводить ізоляції чи відсутності витоку.

  3. Проєкція входу суддіsrc/dispatcher/live.tsвхід суддіVerifier · вердикт моделіVerifier actor

    Dispatcher запускає Verifier зі спроєктованими вхідними даними.

  4. Verifier · вердикт моделіVerifier actorjudge.scoretranscript.jsonl · append-onlysrc/transcript

    Вердикт Verifier записується як подія judge.score. Це рішення моделі, а не факт про виконання.

  5. Стан → наступні ефектиsrc/reducerоцінка · докази QAЗахист від обману · виправлення оцінкиsrc/validator

    За judge.score reducer передає її на перевірку захисту від обману разом із результатом QA, провайдером Builder, а також планом і доказами дослідження.

  6. Захист від обману · виправлення оцінкиsrc/validatorвиправлений вердиктМаршрутизація вердиктуsrc/reducer

    PASS без успішного виконання стає FAIL, а оцінку, пов’язану з виконанням, виправляють за детермінованим QA. Інші правила — умовні виправлення, а не загальний доказ правдивості.

  7. Маршрутизація вердиктуsrc/reducerготовоГотово · PASS або причина зупинкиsession done

    PASS завершує сесію як done. Зупинки через бюджет і circuit також завершуються як done, але зберігають причину зупинки, тож done — не завжди PASS.

Збій і керування людиною

PARTIAL іде до людини, Critical — на перероблення дизайну, Important чи Minor — на виправлення, а зупинки через бюджет чи circuit лишають причину зупинки.

  1. Захист від обману · виправлення оцінкиsrc/validatorвиправлений вердиктМаршрутизація вердиктуsrc/reducer

    PASS без успішного виконання стає FAIL, а оцінку, пов’язану з виконанням, виправляють за детермінованим QA. Інші правила — умовні виправлення, а не загальний доказ правдивості.

  2. Маршрутизація вердиктуsrc/reducerперевірка PARTIALІдея гри · керування

    PARTIAL чекає на перевірку людиною.

  3. Маршрутизація вердиктуsrc/reducerперероблення · виправленняsrc/dispatcher/live.ts

    Серед FAIL і REJECT Critical повертається до Planner для перероблення дизайну, а Important чи Minor — до Builder як зворотний зв’язок для виправлення; усе виконується як ефекти dispatcher.

  4. Маршрутизація вердиктуsrc/reducerготовоГотово · PASS або причина зупинкиsession done

    PASS завершує сесію як done. Зупинки через бюджет і circuit також завершуються як done, але зберігають причину зупинки, тож done — не завжди PASS.

  5. Ідея гри · керуванняідея · керуванняЗапис команд в inboxpackages/studio

    Однорядкова ідея гри й керування природною мовою вводяться в Studio, яка записує команди в inbox. Studio ніколи не редагує транскрипт напряму.

Відтворення й спостереження

Відновлення стану з транскрипту не запускає ефектів, а Studio читає той самий запис, щоб показати його.

  1. transcript.jsonl · append-onlysrc/transcriptнові події · відтворенняЦикл подій · відтворення · tailsrc/loop/coordinator.ts

    Writer перевіряє схему, призначає ULID і час та дописує. Під час відтворення минулі події лише проходять через reducer; їхні ефекти не запускаються знову.

  2. Цикл подій · відтворення · tailsrc/loop/coordinator.tsreduce по черзіСтан → наступні ефектиsrc/reducer

    Живі події по одній беруться з черги й проходять через reducer, зберігаючи порядок ефектів кожної події; сама передача виконується асинхронно.

  3. transcript.jsonl · append-onlysrc/transcriptчитання · SSEПерегляд подій · артефактівpackages/studio

    Studio читає транскрипт і артефакти та показує поступ, метрики й артефакти через SSE. Це не телеметрія, що надсилається віддаленому сервісу.

Усі зв’язки однакової товщини. Оберіть потік, щоб підсвітити лише його шлях із пронумерованими кроками.

  • Суцільна · напрямок входів, результатів і записів
  • Штрихова · запуск, рішення, запит
  • Довга пунктирна · спостереження й звітування, окремо від рішення
  • Товста чорна лінія · обраний потік; номери показують порядок
  • Рамка · межа коду чи стану, названа в заголовку
  • Внутрішня плашка · компонент цієї межі
  • Пунктирна рамка · поза цією межею
  • Помаранчевий контур · де вирішує модель
  • Цикл подій · reducer · dispatcher
  • Записи · налаштування · артефакти
  • Детерміновані перевірки · виправлення
  • Studio · актори

Накреслено за шляхами коду на публічному коміті f5e17c0. Актори — це ролі під час виконання, відмінні від агентів для програмування, якими створено цей репозиторій.

Джерело стану
Транскрипт — джерело стану, а reducer — чиста функція. Побічні ефекти (запуск акторів, QA, запис файлів) виконує лише dispatcher, тож відтворення відновлює стан без ефектів.
Що охоплює відтворення
Відтворення дає той самий стан; воно не робить детермінованими генерації LLM чи поведінку браузера й мережі.
Що охоплює вердикт
QA виконання перевіряє лише налаштовані перевірки, а оцінка Verifier — один канал доказів. Жодне з них не вимірює всієї поведінки гри, цікавості чи задоволення користувачів.