TODDLER
PLAYROOM CONTRIBUTOR GUIDE · v1.0 Все игры

OPEN SOURCE · AI-FRIENDLY

Создать игру
с ИИ.

Не нужен игровой движок и большая команда. Нужна одна добрая задача для ребёнка, наблюдаемый финал и готовность проверить игру настоящим пальцем на маленьком экране.

Начать со спеки

СНАЧАЛА РЕБЁНОК

ИИ ускоряет работу. Ответственность остаётся у автора.

  1. 01

    Одна задача

    Ребёнок должен понять главное действие из самой сцены, не читая инструкцию и не прося взрослого помочь.

  2. 02

    Добрая реакция

    Каждое осмысленное действие меняет мир. Промах не стыдит, не отнимает прогресс и позволяет сразу попробовать снова.

  3. 03

    Полный маршрут

    Минимальный релиз — это законченный путь: каталог, игра, наблюдаемый успех, звезда и безопасный возврат домой.

  4. 04

    Никаких ловушек

    Новая игра не добавляет рекламу, аккаунт, покупку, трекинг, лидерборд, жизни, наказание или внешний переход.

ПРОДУКТОВАЯ СПЕКА

Сначала опишите, что должно произойти. Потом просите ИИ писать код.

01

Job to Be Done

Когда ребёнок выбирает эту игру, он хочет сразу понять одно игровое действие, чтобы самостоятельно завершить короткое приключение.

02

Наблюдаемое завершение

Назовите физически проверяемый результат: все детали стоят на местах; герой достиг видимой цели; найден весь оговорённый набор. Ожидание таймера и простое открытие страницы не считаются.

03

Acceptance criteria

Given уровень ещё не завершён. When ребёнок выполняет видимую задачу. Then игра добавляет одну уникальную звезду. And повтор снова празднуется, но не увеличивает общий счёт.

04

Edge cases

Что происходит при касании фона, неверном ответе, отпускании вне цели, потере pointer capture, выключенном звуке, reduced motion, повреждённом localStorage и повторном прохождении?

05

Data contract

Зафиксируйте уникальные gameId и levelId, возраст, длительность эпизода, допустимый ввод, условие завершения и обещание обратной совместимости награды.

06

SLC-срез

Simple: один узкий игровой цикл. Lovable: приятная сцена и немедленная реакция. Complete: игру можно пройти от первого касания до возврата домой без заглушек.

ПРОМПТ ДЛЯ АГЕНТА

Дайте ИИ контракт, а не пожелание «сделай игру».

«Прочитай AGENTS.md и docs/GAME_DESIGN.md. Создай одну самостоятельную игру в новой папке. До реализации напиши падающие тесты из критериев приёмки. Сохрани относительные пути, общий HUD и одну идемпотентную звезду за наблюдаемое завершение. Проверь desktop, iPad portrait, iPad landscape и телефон 375 px; звук должен быть необязательным, а reduced motion — понятным».

QUALITY GATE

Что должно пройти до публикации

Логика

Первое завершение даёт одну звезду; повтор и двойное касание не создают дубликат; ошибка не уменьшает прогресс.

Touch

Контролы не меньше 44 × 44 CSS px, цель не скрывается под пальцем, pointer cancel заканчивает жест безопасно.

Доступность

Работают мышь и клавиатура, focus заметен, цвет не является единственным сигналом, критическая обратная связь видна без звука.

Браузер

Нет console errors и переполнения HUD; 3D-canvas не пуст; прямой адрес игры, Back, полноэкранный режим и возврат в каталог работают.

node --test tests/*.test.mjs games/*/tests/*.test.mjs
TOKENVILLE_BASE_URL=http://127.0.0.1:8766 python3 tests/browser_verify.py

КАК КОНТРИБЬЮТИТЬ

Улучшите одну вещь так, чтобы ребёнок это почувствовал.

Начните с существующей игры или добавьте одну законченную. Прочитайте GAME_DESIGN.md и CONTRIBUTING.md, создайте сфокусированную задачу, приложите тесты и четыре адаптивных снимка. Любой вклад должен сохранять приватность, прямые URL и общий контракт звёзд.

Посмотреть 16 готовых игр