agentleFS
ManshoooManshooo/astral-genesis/.claude/skills/gameplay-testing/SKILL.md

gameplay-testing

Skill3 starsChanged 52 days agoMITView on GitHub

Пишет и прогоняет headless-проверки игрового процесса Astral Genesis (генератор уровня, модель тела и распада) плюс ведёт чек-лист ручного плейтеста. Запускать при отладке игровой логики, после правок в GECS-системах, генераторе уровня, дверях/слотах, body-snatch/decay-модели или интеракции, когда нужно покрыть новый инвариант проверкой, и перед тем как считать задачу завершённой.

The file

Files
SKILL.md

Тестирование игрового процесса

Отладка игровой логики в этом проекте идёт через headless-прогон, а не через клики в редакторе: у Godot есть консольная сборка (Godot_v4.7.2-stable_win64_console.exe), сценарий в dev/ запускается godot --headless <сцена> и выходит с ненулевым кодом при провале. Сторонних тест-фреймворков (GUT, gdUnit) в проекте нет — проверка это обычная сцена Godot со скриптом, который сам считает ассерты и зовёт get_tree().quit(код).

Скилл делает три вещи: прогоняет существующие проверки (§«Быстрый прогон»), пишет новые под новый инвариант (§«Как писать проверку») и держит чек-лист ручного плейтеста для того, что headless поймать не может.

Одно не заменяет другое: headless ловит регрессии в данных и структуре (граф несвязен, характеристика не перенеслась), но не в ощущениях (тело село в пол, дверь развернула камеру).

Быстрый прогон

.\dev\run_checks.ps1

Тот же раннер гоняет CI (джоб «Headless-проверки» в .github/workflows/build.yml) на каждом PR в master и на каждом пуше в master, поэтому он лежит в dev/, а не в папке скилла. Godot он берёт из -GodotPath, из переменной окружения GODOT или из PATH (на Linux/macOS — pwsh dev/run_checks.ps1).

Прогоняет любой dev/*_check.tscn, печатает по каждой OK/FAIL и общий вердикт с кодом возврата (0 — всё прошло). Новый файл с суффиксом _check.tscn подхватывается сам, регистрировать его в скрипте не нужно. Особых случаев у раннера нет: последний, dev/gen_verifier, разбирался регулярками, и два числа из четырёх раннер только печатал — его инварианты стали ассертами corridor_graph_check. Параметры:

  • -Check <имя> — прогнать только одну проверку: имя файла без расширения (body_traits_check, stat_modifiers_check, …). Без -Check — всё сразу.
  • -ListChecks — только напечатать, что сейчас найдено под -Check All, без запуска Godot. Полезно после того как в dev/ появился новый сценарий.
  • -GodotPath <путь> — если Godot не в C:\Program Files\Godot Engine\... по умолчанию (скрипт также сам ищет любой *_console.exe там же, рекурсивно).
  • -SkipSubmoduleCheck — не проверять addons/gecs перед прогоном.

Прогон беззвучен, и это сделано специально. --headless выключает аудиодрайвер Godot, но byProd открывает своё устройство сам и про ключ движка не знает — пока в AudioManager не появилась развилка, каждая проверка играла в наушниках у того, кто её запустил. В headless рантайм поднимается без устройства вывода (create_host_mixed), и byprod_check это сверяет. Признак в логе: Audio started on null driver вместо on MiniAudio. Подробности — [[Звук]], §5а.

Скрипт сам чинит одну частую ловушку: в свежем git worktree addons/gecs пустой (сабмодуль не инициализирован) — Godot всё равно рапортует --import успешным, но Entity/Component/System/Observer не существуют и любой headless-прогон молча ничего не проверяет. Скрипт вызывает git submodule update --init addons/gecs, если сабмодуль пуст.

Что именно проверяется

  • dev/system_order_check.tscn — порядок систем в том виде, в каком его получает ИГРА: грузит настоящий world.tscn, сортирует группы той же топосортировкой GECS, что World.initialize(), и сверяет: всё, что готовит перемещение (скорость, маска), идёт до S_Movement, лучи от камеры — после, плюс парные deps() (гравитация до прыжка, бег и ИИ до шага, детектор цели до захвата). Заодно раскладка: папка системы совпадает с её группой, наблюдатели лежат в src/observers/. Регресс на баг: сортировка по Кану уводила S_Walk/S_Jump за S_Movement, и ход с прыжком применялись на тик позже, а остальные проверки собирали системы списком и видели другой порядок. Проверено мутацией: без deps() у S_Movement падает ровно на них. Запускать после любой правки deps(), групп в world.tscn или переноса файла системы.
  • dev/presets_tool_check.tscn — вкладка «Редактор пресетов» на ВРЕМЕННОЙ библиотеке в user:// (правки пишутся на диск по-настоящему, и гонять их по данным проекта значило бы портить их каждым прогоном): загрузка и счётчик «В сцене», правка из карточки доезжает до файла и до строки таблицы, новый тег заводится в словаре и вешается, «убрать из словаря» не снимает тег с пресетов, проверка сцен разбирает двери. Главное — переименование тега в уже занятое имя: это слияние, запись в словаре остаётся одна, пустое описание берётся у старой. Мутация «переименовать id без слияния» даёт ровно прежний баг — две записи beta. Откат Ctrl+Z headless не проверить (истории вне редактора нет); его путь проверялся зондом в живом редакторе. Запускать после правок addons/game_design_tool/tabs/presets*, shared/undo.gd, shared/tags.gd.
  • dev/body_traits_check.tscn — ассерты модели характеристик тела: E_Player.foot_offset() реально меряет коллайдер (не возвращает 0), характеристики читаются из сцены и переносятся при захвате с числами самого тела, карман распада тела тикает отдельно от запаса души, добровольный выход суммирует остаток, излишек утекает быстрее во столько раз, сколько велит lifespan_overflow_leak, гибель тела оставляет lifespan_death_fraction и снимает все трейты. Числа берутся из сцены тела и GameConfig, а не литералами: тюнинг баланса проверку не валит. Запускать после правок в S_BodySnatch, O_ExpelFromBody, S_Lifespan, любом C_BodyTrait.
    • Предупреждения WARNING: N ObjectDB instances were leaked at exit / ERROR: N resources still in use at exit в конце прогона — фоновый шум выключения headless-процесса (тестовые сцены не освобождают всё за собой явно), не провал теста. Провал — это код возврата ≠ 0 и строки FAIL в выводе.
    • Итоговую строку === ИТОГ: ... === проверка обязана напечатать сама, и раннер её требует. --quit-after считает кадры ОТРИСОВКИ (в headless их в разы больше, чем физкадров: Engine.max_fps там не соблюдается), и упёршаяся в этот лимит проверка закрывается движком, не дойдя до get_tree().quit(), — то есть с кодом 0. По коду возврата обрыв неотличим от успеха, поэтому отсутствие итоговой строки раннер считает провалом.
  • dev/abilities_check.tscn — модель «возможность = компонент» на настоящем e_player.tscn: полёт и проход сквозь решётки души авторены в её сцене, засыпают во плоти и просыпаются при выходе (в том числе после пересадки тело→тело и после воплощения ВТОРЫМ путём — загрузкой сейва, без захвата); безногое тело не даёт ни прыжка, ни бега, и на попытку отвечает сообщением, а призраку — нет; бег кладёт множитель в C_StatModifiers, а не в C_Walk.speed, и снимается вместе с телом; прыжок с настоящего пола срабатывает после гравитации; под блокирующим экраном ввод отпускается; HUD показывает ровно то, что риг умеет сейчас. Проверка неявно пишет в user://skills.tres: выход из тела, надетого в разделе 6 в обход on_worn (карман распада пуст), засчитывается «Чистым выходом» и начисляет очко. Поэтому SkillManager.save на время прогона подменяется копией, а файл возвращается байт в байт, и последний ассерт это подтверждает. Запускать после правок O_SoulTraits, O_ExpelFromBody, S_BodySnatch, систем движения и UI_HudAbilities.
  • dev/stat_modifiers_check.tscn — ассерты паттерна «база + модификаторы» (C_StatModifiers/RS_StatModifier): свёртка (base + Σflat) * Πmult, независимость от порядка источников, идемпотентность и снятие источника, изоляция модификаторов между сущностями, доезд дерева перков до души (ранг растит стат, база в компоненте цела, обнуление рангов возвращает базу — без сверки с числами skill_tree.tres, их тюнят). Запускать после правок в O_ApplySkillEffects, SkillManager, любом стате из каталога C_StatModifiers.
  • dev/body_form_check.tscn — ассерты физической формы захваченного тела (C_BodyForm/O_BodyForm): контракт сцен тел (корень E_Body, слой enemies, читаемые габарит и маркер Eyes), перенос капсулы и посадка камеры на уровень глаз, откат к призрачной форме, отказ при нехватке места (синтетический блокер) — и отдельно, на настоящей геометрии трёх комнатных шаблонов (default_room/exit_room/lab_room), что штатно расставленное тело (подошва на y=0, как и пол комнаты) не считается «нет места» из-за простого касания пола. Регресс на баг, найденный живым прогоном: _fits() кастовал капсулу БЕЗ зазора, и intersect_shape против пол-трисетки (ConcavePolygonShape3D) стабильно засчитывал касание подошвы с полом как пересечение — захват отклонялся в КАЖДОЙ заспавненной комнате («Тело здесь не поместится»), но не в хабе, где тела оказались случайно приподняты над локальным полом. Чинит _FLOOR_CLEARANCE в S_BodySnatch._fits(). Запускать после правок в S_BodySnatch, сценах тел, E_Player.foot_offset, либо в комнатных шаблонах (src/levels/procedural/rooms/), если меняется расстановка тел или геометрия пола.
  • dev/enemy_ai_check.tscn — ассерты простого поведения врага (S_EnemyAI/C_EnemyAI): бестелесную душу враг не замечает вовсе (цель — только воплощённый БФЖ, у которого есть C_Health), вне aggro_range стоит на месте (в т.ч. физически, не только по флагу), в радиусе — разворачивается и реально идёт (сквозная проверка, что E_Enemy — CharacterBody3D, а не StaticBody3D, как E_Body — иначе S_Walk/ S_Movement его не двигают), в упор бьёт с кулдауном (не каждый кадр), а добитое тело выбрасывает игрока обратно в призрака через уже отлаженный O_ExpelFromBody. Враг замечает только то, что в конусе обзора, поэтому проверка разворачивает его к цели перед погоней, а бьёт после явной просьбы о проверке обзора (sight_left = 0). Первые два ассерта — регресс-проверка на баг, найденный живым прогоном: враг двигается через C_EnemyInput, а НЕ C_PlayerInput — второй такой компонент в мире ломает добрый десяток мест, которые находят «игрока» просто по наличию C_PlayerInput (RunManager.travel_to, S_InteractionDetector, HUD), из-за чего переход через дверь и интеракция молча промахивались мимо настоящего игрока. Запускать после правок в S_EnemyAI, C_EnemyAI, E_Enemy, C_EnemyInput/C_PlayerInput, либо в C_Health/O_ExpelFromBody, если меняется контракт «кто и как наносит урон».
    • Ещё пять ассертов — слои коллизий (всего 17). Игрок стоит на player, а не на static_colliders, враг — на enemies, а не на moving_colliders. Маска врага видит стены, игрока, подвижную и проницаемую геометрию, маска игрока не видит enemies. И тело за спиной врага остаётся в прицеле захвата: мутация «S_SnatchTargetDetector не проходит насквозь не-цели» валит этот ассерт. Запускать также после правок слоёв или масок в сценах игрока, врага и тел.
  • dev/ragdoll_check.tscn — мышцы рэгдолла трупа (C_Ragdoll, S_Ragdoll, [[Захват тела]] §«Мышцы рэгдолла»): тело, лежащее с начала, стартует рэгдоллом из нейтральной позы (колени согнуты), колено при падении не выгибается назад, через active_seconds мышцы гаснут; свежий труп подхватывается посреди клипа гибели со скоростью костей из клипа, а удар бросает руки по удару и ноги навстречу. Сквозной путь удара до трупа (C_Struck → struck_from) держит combat_check. Глазом — по кадрам: что тело легло «естественно», headless не скажет.
  • dev/enemy_roster_check.tscn — ассерты ростера врагов по слоям и существа L5 (RS_EnemyRoster, маркеры EnemySpawn*, S_Attack.damage_against). Состав: на каждой глубине ростер отдаёт ровно положенных врагов (множества, не веса), часть маркеров пуста, но не все; бросок — функция входа (сид, слой, узел, маркер) и не трогает глобальный ГСЧ. На настоящем RunManager: слой, собранный заново, возвращает тех же врагов на те же маркеры, враги ростера зарегистрированы и несут C_BodyOrigin с id маркера, на дне встают существа L5; труп убитого врага наследует id и лежит там, где враг умер, а не на маркере (сверяются кости рэгдолла, не корень: корень встаёт на место в любом случае, а рэгдолл, запущенный до установки трансформа, оставался в начале комнаты — мутация «трансформ после add_child» валит ассерт), съеденный труп снимает маркер при новой сборке слоя, а убитый и оставленный — возвращается (задокументированный пробел, ассерт на него фиксирует это). Сопротивление: удар тела класса ниже L5 (и души вне тела) по существу L5 ×L5_RESISTANCE, удар L5 и удар по не-L5 — полный урон; труп L5 — body_class 5, класс угрозы врага читается из трупа. Маркеры сверяются по настоящей геометрии комнат из библиотеки: луч вниз находит пол у маркера, капсула существа L5 над ним не пересекает статику, а в выходе, у Архитектора и на лестнице маркеров нет. Проверено мутациями: множитель без ослабления валит три ассерта, маркер, поднятый в воздух, — ассерт про пол. Сейв разработчика снимается и возвращается. Запускать после правок RS_EnemyRoster, data/enemy_roster.tres, LayerStreamer._spawn_roster_enemies, O_EnemyDeath, S_Attack.damage_against, сцен врагов/трупов L5 и при добавлении маркера в сцену комнаты.
  • dev/enemy_nav_check.tscn — навигация и обнаружение врага (S_EnemyAI, LayerNavigation, поля обзора/памяти/пути C_EnemyAI; карточка «Навигация и обнаружение врага»). Арена из настоящей коллизии на static_colliders, навмеш запекается тем же LayerNavigation, что и в игре. Обзор: при одной и той же расстановке без стены враг игрока замечает, а за высокой стеной — нет (контроль нужен, чтобы «не заметил» значило «закрыла стена», а не «далеко»); конус — за спиной не замечает и луч не бросает, вплотную со спины замечает; лучей за две секунды погони порядка десятка, а не сто двадцать. Память: потеряв цель из виду, идёт на место последней встречи (а не к новому месту цели), стоит linger_time и сдаётся. Путь: игрок виден над низкой стенкой, но не достижим по прямой — без навмеша враг упирается в стенку, после запекания обходит её конец. Шаблоны навмеша: разбор геометрии у всех общий, у каждой e_enemy*.tscn шаблон из LayerNavigation.PROFILES, покрывающий её капсулу, и маска геометрии против collision_mask врага; каждый шаблон кому-то нужен. Размеры: под балкой на 2.3 м навмеш обычного размера есть, крупного нет, у размеров разные карты, враг получает карту своего шаблона, после clear() — никакой. Настоящий слой: спавн запекает навмеши, и карта отвечает под каждой комнатой; снос снимает регионы; запекание, перебитое сносом, региона не оставляет. Печатает замер запекания на арене и на слое. Проверено мутациями: луч без учёта попадания валит два ассерта обзора, путь без точек навмеша — два ассерта обхода, крупный шаблон высотой 2.0 — ассерт балки и покрытия капсулы L5. Ждать навмеш надо спросив карту (LayerNavigation.is_ready): номер итерации региона растёт раньше, чем карта начинает отвечать. Запускать после правок S_EnemyAI, C_EnemyAI, LayerNavigation, шаблонов data/enemy_navmesh*.tres, LayerStreamer.spawn/despawn и капсул или масок сцен врагов.
  • dev/movement_check.tscn — ассерты перешагивания порогов (S_Movement.STEP_HEIGHT): CharacterBody3D закатывается на препятствие ниже STEP_HEIGHT (0.16 м) без прыжка, а настоящая стена выше него по-прежнему останавливает как обычно — новый манёвр не должен занижать чувствительность коллизий везде подряд. Регресс на баг, найденный живым прогоном: дверные пороги и кромки комнатной геометрии высотой в несколько сантиметров тормозили ходьбу как полноценная стена, и пройти получалось только прыжком. Порог теста взят 0.15 м не случайно — голый move_and_slide() и без правки перекатывает капсулу через препятствия примерно до 0.12–0.13 м просто своей формой, так что тест специально целится в сантиметры, которые закрывает именно правка. Пятый ассерт — на ВТОРОЙ баг, найденный тем же прогоном: упёршись в настоящую стену, иногда не получалось прыгнуть. _try_step() при неудачной попытке (стена, не ступенька) звал move_and_collide() последним — этот метод не обновляет is_on_floor() (только move_and_slide() его считает), и флаг лгал «в воздухе» до конца кадра, хотя тело физически на земле; S_Jump в следующем кадре молча отказывал. Чинит собственный move_and_slide() в конце _try_step() с принудительным маленьким толчком вниз (velocity=ZERO снап не считает вовсе) — и отдельная защита от обратного: этот довесок сам не должен сжирать прыжок, ЗАДАННЫЙ этим же кадром (vel.velocity.y > 0 — манёвр в process() вовсе не запускается). Запускать после правок в S_Movement, S_Jump, либо если поменялась форма коллайдера тел (радиус капсулы меняет естественный «перекат» без правки).
  • dev/architect_check.tscn — ассерты задела под Архитектора ([[Артефакт «Архитектор»]]). Прокачка: у ArchitectManager своё дерево и свой сейв, его улучшения крутят только статы мира (ArchitectStats) — стат души у Архитектора мёртвая строка, его никто не кладёт в C_StatModifiers, — каждый стат мира чем-то занят, ранги «Карты комплекса» дают уровни 1–4, лишний ранг в данных зажат до максимума, покупка не трогает очки навыков. Встреча (A_ArchitectEncounter): первое касание даёт эссенцию и открывает экран ИМЕННО Архитектора, повторное в том же забеге — ничего, отметка лежит в сейве забега, новый забег — новая награда, вне забега награды нет, а экран есть. Генерация по 30 сидам: Архитектор ровно один, только на глубинах 1, 2, 4 и на каждой из них побывал; одна дверь в коридор, без портала, не вход и не выход; все глубины вычеркнуты — конфиг невалиден. Сцена: одна дверь на юг, артефакт собран как интерактив, пол на пороге двери (иначе стык с тайлом — провал, как у B-комнат без коллизии). Сейвы забега, навыков и Архитектора подменяются и возвращаются. Проверено мутациями: награда без отметки валит 3 ассерта, Архитектор без вычеркнутого слоя хаба — ещё 3. Запускать после правок SkillProgression, ArchitectManager, A_ArchitectEncounter, data/architect_tree.tres, записи Архитектора в data/world_gen_config.tres, RS_UniqueRoom и экрана дерева навыков.
  • dev/essence_finds_check.tscn — ассерты находок и тайников эссенции (LayerFinds, E_EssenceFind, навык «Сбор эссенции»; [[Источники эссенции]]). Бросок — чистая функция сида, слоя и ключа: тот же вход даёт то же, другой сид и другой слой — иное, шанс 0 и 1 дают «никогда» и «везде», сумма не зависит от шанса. На настоящем забеге (шансы выставлены в 1, чтобы проверялось место, а не бросок): тайники стоят только в RS_LayerPlan.dead_ends и в каждом, находка — ровно на каждом EssenceSpot* комнат слоя, пересборка слоя кладёт то же. Взятие: начисляет номинал × доля через award_essence под своим источником (essence_pickup / essence_cache), пишет отметку, исчезает, повтор ничего не даёт, взятая не появляется при пересборке; навык доезжает до души и откатывается, касание Архитектора навык не множит. Сейвы забега, навыков и Архитектора снимаются байтами и возвращаются. Проверено мутациями: взятие без отметки валит три ассерта, доля мимо C_StatModifiers — ассерт про навык. Запускать после правок LayerFinds, E_EssenceFind, LayerStreamer (спавн/снос), RS_GameConfig (группа «Находки эссенции»), сцен комнат с маркерами, навыка в data/skill_tree.tres.
  • dev/complex_map_check.tscn — ассерты экрана карты комплекса и мини-карты ([[Экран карты комплекса]]). Правило видимости MapKnowledge на сгенерированном графе: уровень 0 не видит ничего, уровень 1 — не меньше мини-карты и по ВСЕМ этажам своего слоя, но без непосещённого за пределами соседей; 1–2 держат чужие слои закрытыми, 2 — свой слой целиком, 3 — все слои; портал узнаётся ровно у комнат с тегом портала. Экран (UI_ComplexMap) на том же графе без забега: полосы среза активны по уровню, полоса своего слоя — линия на этаж и штрих на каждую видимую комнату, игрок на своём этаже, чужие слои на уровне 2 закрыты и пусты, порталы в срезе — только между соседними слоями, панель на каждый этаж и каждый узел ровно в одной, обратная проекция курсора (node_at_point) под центром комнаты находит её саму, порталы помечены, второй конец межслойного портала на уровне 2 скрыт, на 3 — найден, и клик по нему открывает его слой с рамкой на нём; содержимое (имя уникальной комнаты, замок с именем ключа, значок типа) — только с уровня 4, а заглушки-буквы уникальных комнат разные. Настоящий забег: уровень 0 даёт строку «нет связи» вместо экрана, клавиша карты (на последнем ранге) открывает экран на паузе с маркером игрока, повторное открытие не плодит экран, та же клавиша закрывает и снимает паузу, поверх чужого экрана карта не открывается; терминал в хабе — C_Interactable без requires_body, объём на interactives, подсветка находит меши его Visual (проп SM_screen), касание открывает экран. Мини-карта (UI_MiniMap) на том же забеге, в настоящей сцене HUD: на уровне 0 Tab не открывает её, а даёт строку «нет связи»; на уровне 2 открывает без паузы и мимо стека экранов, текущий узел показан и прорисован раньше соседей, бусины коридора проступают по очереди и узел за коридором ждёт, пока до него дойдёт цепочка, новое вписывание перетекает, а узнанный при открытой карте узел прорисовывается с этого момента; заголовок на ранге 1 — только этаж, со второго — и слой, стрелки лестниц и порталов — с третьего; рамка обводит заголовок, план и подсказку и рвётся у края; подсказка — «[Tab] Свернуть», мышь не ловит; та же клавиша растворяет её, а не прячет сразу. Ниже последнего ранга M экран не открывает, а отсылает к терминалу, и «[M] Вся карта» в подсказке нет; на последнем — есть, и полная карта сворачивает мини-карту; поверх экрана Tab её не трогает; терминал открывает экран уже на первом ранге. Плюс действия map и map_mini в InputMap и REBINDABLE_ACTIONS без конфликта клавиш. Сейвы забега и Архитектора подменяются и возвращаются. Запускать после правок MapKnowledge, UI_MapFloor, UI_ComplexMap, UIManager.open_complex_map и _toggle_mini_map, UI_MiniMap, ArchitectManager.map_level, терминала и hub.tscn, записей map_name/map_icon в конфиге генерации и каталоге типов.
  • dev/corridor_graph_check.tscn — ассерты генерации графа с коридорами ([[Процедурные коридоры между комнатами]]). Конфиг генерации и библиотека пресетов валидны (validate()). По 30 сидам: граф связен от входа, и по дверям и порталам доходишь туда же — обход так, как ходит игрок: из комнаты в коридор только через дверь, которую план поставил на этот коридор (RS_LayerPlan.door_faces), вертикальным ребром — только если в сцене есть портал (эти два инварианта раньше жили в dev/gen_verifier вне обвязки, и «недостижимо по дверям» раннер только печатал); вход — хаб, выходы — нужное число, на своей глубине, со своей сценой и тегом; у комнаты рёбер в коридоры ровно столько, сколько дверей в сцене (ребро без двери — недостижимый сосед, дверь без ребра — заваренная дверь), и ведут они в коридоры её этажа (в какие — решает раскладка, комната бывает на двух коридорах, см. corridor_layout_check); у каждого коридора есть сосед (коридор без дверей — законная перемычка или тупик); не больше одного вертикального ребра на узел, и портал в СЦЕНЕ (ищется E_VerticalPortal, а не тег пресета) ровно тогда, когда вертикальное ребро есть; каждая пара слоёв связана ОТКРЫТЫМ переходом, каждая пара этажей — переходом. Плюс детерминизм, HOME_DEPTH (умолчание тула) равен глубине хаба из конфига, уникальная комната с шансом 0 и 1 (роль будущего Архитектора), снимок ручек и версии генератора в сейве, а забег прежней версии сбрасывается на вход со свежим снимком и нетронутым запасом — сейв подменяется только в памяти. Проверено мутациями: не раздать лишние двери, снять гарантию открытого перехода, убрать сверку портала — каждая валит свой ассерт. Запускать после правок RS_LevelGraph, select_preset, RS_WorldGenConfig/RS_UniqueRoom, data/world_gen_config.tres и при добавлении пресета с порталом.
    • Здесь впервые поймали «тихо оборванный блок»: ошибка скрипта (SCRIPT ERROR) внутри блока обрывает только этот блок, итоговая строка печатается с нулём провалов, и первый прогон этой проверки прошёл зелёным на 6 ассертах из 23. Сначала от этого защищались ручным счётом ассертов; теперь это сторож общей обвязки (dev/check_harness.gd) для всех проверок.
  • dev/corridor_spawn_check.tscn — ассерты сборки коридоров в мире: настоящий RunManager. На каждый тайл плана — ровно один кусок кита, в клетке своей ветки; тупики слоя встали куском тупика и они есть (иначе лучи ниже тупика бы не видели); проёмы и стены сверяются ЛУЧАМИ по коллизии (слой static_colliders): в открытую сторону луч проходит, в закрытую упирается — только так ловится перевёрнутый поворот (RS_CorridorKit.rotate_mask). Прежний ассерт «кусок под маску» звал ту же формулу, на мутации «тупик с неверной базовой маской» зеленел и удалён; мутацию валят лучи. На стыке тайла с комнатой под ногами пол. Двери привязаны по сторонам плана, заваренных нет; межэтажный переход — порталом. Дверь в коридор открывается на месте: игрок и узел не меняются, подсветка гаснет, а проём освобождается по коллизии — луч сквозь дверь до открытия упирается в полотно, после — нет. По высоте узла это не проверить: прежний ассерт смотрел на Visual и зеленел, пока меш уезжал вверх, а коллизия полотна оставалась в проёме (мутация «поднимать Visual» его валит). Дверь хаба открывается на месте, как любая, шаг за неё — в его коридоре, и присутствие делает коридор текущим. Видимость слоя — у входа и после шага присутствием: показано ровно то, что в LayerStreamer.VISIBLE_HOPS рёбрах графа (ожидание — обход графа в самой проверке, видимость — по лампе комнаты и тайлам, а не по флагу стримера), враги спрятанных комнат видны. Мини-карта (UI_MiniMap.build_view): текущая ветка и хаб известны, комнаты на ветке видны соседями, маркер игрока внутри карты. Загрузка сейва в коридоре — на тайл той же ветки и по снимку ручек, даже если база ручек с тех пор изменилась. Сейв разработчика бэкапится. Запускать после правок RunManager (спавн тайлов, use_door, привязка дверей и порталов), RS_CorridorKit, data/corridor_kit.tres, сцен тайлов и дверей, mini_map.gd.
  • dev/corridor_layout_check.tscn — ассерты коридорной РАСКЛАДКИ (RS_CorridorPlanner, сетью — п. 7 карточки «Сетка уровня», коридор на отрезок между развилками — карточка «Коридор — отдельный узел») — второй путь валидации: corridor_graph_check сверяет двери по сцене, а у коридора сцены нет, и без проверки по плану он просто выпал бы из проверок. Два прогона — 30 сидов на ручках по умолчанию и 10 на 8 комнатах на этаж: все трассы проложены; комнаты не делят клетку, тайлы не встают на комнаты; двери — ровно двери сцены или сокеты, коридоры — ровно рёбра графа; перед каждой дверью тайл её коридора с проёмом в комнату; проёмы взаимны и ни один не ведёт в пустоту; стык коридоров есть ровно там, где в графе ребро между ними (лишний стык — проход, которого в графе нет); тайлы коридора связны; коридор — путь без развилок внутри и на развилке не сворачивает; коридор без двери — перемычка или тупик; тайл с одним проёмом — ровно отмеченный тупик, и тупиков на этаже не больше ручки; node_at узнаёт и комнаты, и тайлы; обволакиваемых комнат (по поясу, RS_LayoutMetrics.wraps) не больше 1 %, сквозных — не меньше 25 %; комнаты на двух коридорах, петли по коридору и тупики есть. Плюс детерминизм «один сид — один граф и раскладка». Печатает метрики раскладки (RS_LayoutMetrics, с числом коридоров на этаж) и распределение кусков кита — смотреть на них при правке TURN_COST и ручек петель/тупиков. Проверено мутациями: не открыть проём в комнату, не открыть стык — каждая валит свои ассерты; раскладка без предохранителей от обволакивания проходит на 4 комнатах и валится на 8 (15 %); с 29.09 8 комнат — ручки по умолчанию, а второй прогон идёт на 12, потолке ручки; развилка, берущая в коридор двух любых соседей вместо прямых, валит форму коридора.
  • dev/run_entry_check.tscn — ассерты входа в забег с генерацией в фоне (RunManager.enter_complex_async) и шторки загрузки (UI_LoadingScreen). Фоновый вход на том же сиде строит тот же мир и ставит в тот же узел, что синхронный enter_complex (подпись графа, узла и заспавненного слоя; сортировка строкой — sort() над StringName сравнивает адреса); кадры идут, пока строится граф; в рабочем потоке не инстанцировано ни одной сцены (RS_RoomLayout.off_main_thread_instances) — кэши сцен перед этим сбрасываются, иначе фону нечем промахнуться; душа одна; слой порциями (LayerStreamer.spawn_async) встаёт тем же, что синхронный _spawn_layer (комнаты на тех же местах, те же тайлы), за несколько кадров, а оборванный не объявляет слой загруженным; переход порталом на другой слой (RunManager.travel_through_portal) в обоих видах — затемнение и шторка: пока слой собирается, у души нет C_Velocity и контрольная точка не ставится, после — душа в целевом узле со скоростью, экран открыт (шторка ищется через is: поиск по типу класс скрипта не узнаёт), слой тот же, что после мгновенного travel_to; вход, перебитый новым на другом сиде, возвращает false и мир нового не трогает; шторка выше слоёв HUD и ниже отладочного оверлея (слои берутся из сцен), dismiss() её убирает. Проверено мутациями: лестница вне RS_LevelGraph.scene_paths, генерация в кадре, вход без номера (_entry_serial), спавн без порций, глубина, поставленная до обрыва, незамороженная душа, неснятая шторка и контрольная точка посреди перехода валят каждая свои ассерты. Смену сцены через SceneLoader проверка не покрывает: она сменила бы саму проверку. Сейв забега подменяется и возвращается. Запускать после правок enter_complex*, RS_LevelGraph.scene_paths (и любого нового источника сцен в генерации), кэшей RS_RoomLayout, UI_LoadingScreen и main.gd.
  • dev/room_presence_check.tscn — ассерты «текущий узел меняется присутствием, а не дверью». На плане по 10 сидам: каждая точка комнаты — центр, угол, рост игрока, чуть ниже пола — находит свой узел через RS_LayerPlan.node_at, этажом выше та же (x, z) — уже не он, пустота и провал — ничьи. Сквозной прогон настоящего RunManager с S_RoomPresence: игрок шагает из хаба на тайл его ветки, и узел меняет НЕ шаг, а следующий такт системы — ровно один room_changed, ветка в сейве текущая и посещённая; повторный такт тишина, пустота узел не трогает, возврат пешком возвращает узел, переход на другой слой меняет узел сразу. Что дверь в коридор никого не переносит, сверяет corridor_spawn_check. Сейв разработчика бэкапится и возвращается, как в run_stats_check. Запускать после правок travel_to, note_presence, RS_LayerPlan (сетка, этажи).
  • dev/world_gen_tool_check.tscn — ассерты по 30 сидам: слой редакторского тула «Генератор мира» (addons/game_design_tool/world/) строится по числу узлов графа (оверлеи «Геометрия» и «Граф» не оставляют геометрию прошлой раскладки, «Подписи» — не остаются видимыми БЕЗ выделения), а ray-vs-AABB пикинг (Picker) находит именно тот узел, в чью коробку послан луч. Всё в этой области ломается ТИХО — неверный пикинг, утёкшая геометрия предыдущей раскладки, обводка не на той комнате или подпись не с тем текстом/не в том месте не бросают ошибку, просто показывают не то, что нарисовано. Регресс на баг живого прогона: оверлеи чистили детей queue_free(), а пересборка слоя синхронная (сид/глубина меняются в один тик) — отложенное удаление не успевало сработать между вызовами show_layer, и старая геометрия накапливалась поверх новой. Чинит free() вместо queue_free() в RoomsOverlay.clear()/GraphOverlay._clear_spheres(). Плюс: 9 ассертов на инлайн-редактор пресета в боковой панели (tabs/world_gen.gd, v3-стретч); LabelsOverlay.set_selected — подпись скрыта до выделения, при выделении показывает id/имя пресета и встаёт на +5 м от верхней грани Picker.room_aabb, прячется при сбросе; RoomsOverlay.set_selected — material_overlay (обводка, тот же приём, что у игрового O_OutlineVisual/RS_EntityVisuals) ставится РОВНО на геометрию выбранной комнаты и снимается с прежней при переключении/сбросе. Всё — ТОЛЬКО чтение: узел с пресетом заполняет форму/подпись значениями ИЗ ресурса, узел без пресета (хаб — авторская сцена вне библиотеки) прячет секцию инлайн- редактора вместо пустой/чужой формы. Обработчики правки (_on_slot_changed и т.п.) не зовутся — пишут в реальные файлы проекта, та же дисциплина, что у кнопок Room Wizard. Плюс _check_restore_state — _restore_state() (реальный путь первого показа вкладки) вне редактора безопасно откатывается на дефолты сида/глубины/оверлеев и всё равно строит граф, а не падает на EditorSettings, которого в headless-прогоне нет (Engine.is_editor_hint() ложно, см. world_gen.gd._get_meta/_set_meta); само чтение/запись project metadata и живое сохранение позиции камеры headless не проверяются — EditorInterface.get_editor_settings() этот прогон не задевает, звать его некуда. Плюс на каждом из 30 сидов: хаб (RS_LevelGraph.HUB_ROOM_SCENE) — ровно один узел на весь граф, и это всегда гарантированный тупик (degree=1) — регресс-щит на риск того, что hub.tres (RS_RoomPresetLibrary.hub, у хаба тоже есть свой пресет теперь, см. [[Единый редактор геймдизайна]]) протечёт в пул автоподбора .presets и молча достанется другим узлам-тупикам; и что боковая панель узнаёт хаб как обычный пресет (секция видима, _editing_preset == library.hub), а не прячет её, как раньше. Запускать после правок в RS_LayerPlan, RS_RoomLayout, RS_LevelGraph, RS_EntityVisuals, RS_RoomPresetLibrary, либо в самом addons/game_design_tool/world/ или tabs/world_gen.gd (живую камеру, клики MenuButton «Видимость» и EditorInterface-кнопки этот прогон не задевает — их некуда звать headless). Коридоры (_check_corridors): оверлей «Коридоры» рисует каждую ветку, «Геометрия» ставит по куску кита на тайл (тем же RS_CorridorKit.instantiate, что игра) и после второй сборки подряд не оставляет тайлов первой — мутация «не освобождать тайлы в clear()» ассерт валит; выделенная ветка обводится всеми тайлами и снимается при сбросе; клик по тайлу выделяет ветку, по комнате — комнату. Сетка (_check_grid_overlay, 5 сидов, все слои): контур и стрелка поворота у каждой комнаты, дверных отметок ровно дверей плана, глухих — остальных сокетов, тупики и стыки веток по плану, пересборка не копит отрезки, выделение красит ровно контур и стрелку своей комнаты. Стрелка сверяется с поворотом корня (room_transform) — формулой, которой оверлей не пользуется; мутация «+turns вместо −turns» её валит. Прогон сидов (_check_seed_sweep): метрики раскладки совпадают с посчитанными по тем же сидам, а таблица «Где встретить» (в скольких сидах пресет выпал, по слоям) пересчитывается прямо по сидам без кода вкладки — общий с ней только формат строки; мутация «слою засчитывается два сида» её валит. «Забег из сейва» (_check_save_run, сейв синтетический и только в памяти): вкладка строит тот же граф, что игра на загрузке этого сейва (ручки — по правилу RunManager._run_gen_config), берёт слепок ручек, а не текущий конфиг (слепок нарочно с другим числом комнат), открывает слой игрока с его комнатой выделенной и показывает в поле сид забега; забег прежнего генератора — так, как его перестроит игра. Мутация «вкладка игнорирует слепок» валит два ассерта.
  • dev/grid_view_check.tscn — ассерты узла сетки GridView и грани клетки во вложении (GridEmbedding.face_edge), без плана и без игры: грань — на полпути к соседу, длиной в клетку, поперёк; решётка 3×2 — 17 отрезков (общая грань один раз, без склейки было бы 24); контур — грани периметра; стрелка смотрит к соседу за своей стороной, стрелка грани — с её середины внутрь; отметки по цветам; commit собирает один меш линий, пустой узел — без меша. Ломается это молча — схема просто рисует не то. Запускать после правок src/grid/grid_view.gd и вложений сетки.
  • dev/room_wizard_check.tscn — ассерты: Room Wizard (addons/game_design_tool/dock/room_wizard.gd) на пяти реальных сценах комнат считает верный путь ресурса (соглашение имён — <сцена>.tres рядом со сценой) и строит рефлексивную форму РОВНО по скалярным @export-полям RS_RoomPreset (display_name/slot_count/weight) — без scene/tags (своя вёрстка) и без служебных полей Resource вроде resource_local_to_scene, которые тоже несут PROPERTY_USAGE_EDITOR и просочились бы в форму при недостаточно строгом фильтре (PROPERTY_USAGE_SCRIPT_VARIABLE and PROPERTY_USAGE_EDITOR вместе — только одного EDITOR мало). Клики по кнопкам «Сохранить»/«Добавить в библиотеку» не проверяются вовсе — они пишут в реальные файлы проекта (новый .tres, правка room_preset_library.tres), и гонять запись на каждый прогон было бы разрушительно, а не проверкой; их поведение — живой прогон в редакторе. Исключение — .disabled-СОСТОЯНИЕ кнопки «Добавить в библиотеку» на хабе (hub.tscn): это чтение, не запись, и оно ровно то, что защищает инвариант «хаб не в пуле автоподбора» (RS_RoomPresetLibrary.hub, не .presets) от случайного клика дизайнера — единственная сцена в наборе, где эта кнопка обязана быть выключена, хотя пресет уже существует на диске. Запускать после правок в RS_RoomPreset, room_wizard.gd, RS_RoomPresetLibrary, либо при переносе/переименовании сцен комнат (ломает соглашение имён, на которое Wizard опирается).
  • dev/room_dressing_check.tscn — обстановка комнаты по сиду (RoomDressing, PlaceSetting, PropJitter; [[Расстановка пропов в комнатах]]) на столовой, 200 сидов. Тот же сид даёт ту же обстановку; другой сид или другой узел графа — иную. Правила подноса: напиток один (кружка или стакан), тарелка одна (плоская или плошка), чайная ложка только при кружке. Прибор не свисает со стола: углы бокса каждого предмета берутся в его собственных осях. AABB повёрнутого подноса шире самого подноса и давал ложный провал. Разнообразие встречается: пустые места, места с подносом и без, кружка и стакан, убранные стулья. Без этого правила зеленели бы и тогда, когда обстановка не срабатывает вовсе. Пути сцен кружки и тарелки берутся у сцены прибора, а не литералами. Проверено мутациями: чайная ложка без условия кружки и напиток, не снятый при замене, валят каждый свой ассерт. Зоны перед сокетами после обстановки сверяет room_shell_check (п. 2, 200 сидов). Запускать после правок src/levels/dressing/, data/place_setting.tres, data/chair_jitter.tres, сцены прибора и расстановки столовой.
  • dev/room_types_check.tscn — ассерты ВТОРОЙ оси подбора комнат (RS_RoomTypeCatalog, RS_RoomPreset.room_type, RS_LevelNode.room_type): каталог валиден и каждый его тип достижим хотя бы на одном слое DEPTHS; выпавший тип всегда покрывает глубину узла, а на глубине без подходящих типов выпадает «без типа»; бросок тратит rng одинаково при любом исходе (rng один на всю генерацию — пропуск броска сдвинул бы всё, что разыгрывается после, и граф перестал бы быть функцией сида); тип — предпочтение, а не фильтр (тип без единого пресета не оставляет узел без комнаты) и при этом не пробивает фильтр портала, а лишний тег пресета не отнимает у него узел своего типа (специфичности, из-за которой так пропадала lab_room, больше нет); после генерации room_type узла равен типу ФАКТИЧЕСКИ вставшей комнаты, ключи типов не протекли в tags, а домашний узел подписан типом хаба (детерминизм типов сверяет подпись графа в corridor_graph_check, она включает room_type). На ветке без коридоров (прежний генератор) ассерт «типизированные комнаты встречаются» не проходил — прежний подбор их вытеснял. Библиотека для части ассертов собирается прямо в проверке из настоящих сцен: поведение подбора нужно поставить в заранее известные условия, а на живой библиотеке они разъедутся при первой новой комнате. Запускать после правок в RS_RoomPresetLibrary, RS_LevelGraph, каталоге типов или при добавлении пресета с room_type.
    • Проверка проверена мутациями: снятие предпочтения по типу валит 3 ассерта, отказ переписывать тип фактическим — ещё один. Держать её такой и дальше: оси тегов и типа разъезжаются молча, ошибкой это не выглядит никогда.
  • dev/outline_mask_check.tscn — ассерты обводки силуэтом (O_OutlineVisual + S_OutlineMask). Пикселей headless не рисует, поэтому проверяется ВХОД постэффекта, и ломается там всё тихо: ошибка в бите слоя, в cull_mask камеры-двойника или в фоне её окружения не бросает ничего — просто вместо контура вокруг объекта выходит либо пустой экран, либо рамка по краю кадра. Слой: выделение переводит на слой обводки ВСЕ меши объекта (иначе силуэт дырявый), прочие слои меша не тронуты, снятие возвращает их ровно к прежним, а material_overlay не трогается вовсе — регресс-щит на тихий возврат старого подхода с выдавленной геометрией. Сборка маски: cull_mask ровно один бит, фон пустой а не небо (с небом маска залита целиком), mask_tex подан в шейдер, материал оверлея — КОПИЯ, а не общий .tres (иначе ViewportTexture прогона утекает в файл проекта). Цена: без выделения маска в UPDATE_DISABLED и оверлей скрыт — полноэкранный проход не должен крутиться вхолостую. Геометрия: камера-двойник совпала с игровой по трансформу и проекции, размер маски равен экрану (шейдер читает её по SCREEN_UV), ножницы накрывают проекцию объекта и заметно меньше экрана, объект за спиной обводки не даёт, а объект в упор обводится по всему экрану (unproject_position там врёт). Проверено мутациями: снятие ножниц валит ассерт про площадь, покраска только первого меша — ассерт про составной объект. Запускать после правок в O_OutlineVisual, S_OutlineMask, RS_EntityVisuals, outline_mask.gdshader либо при смене слоя обводки. Как контур ВЫГЛЯДИТ — только живой прогон.
  • dev/room_tags_check.tscn — ассерты СЛОВАРЯ структурных тегов (RS_RoomTagCatalog, data/room_tag_catalog.tres): словарь назначен библиотеке и валиден (нет дублей и пустых id); каждый тег, который носит хоть один пресет, в словаре есть и описан (тег без описания неотличим от опечатки — ради этого различия словарь и заводился, и только оно делает verticalhub заметным рядом с vertical_hub); флаг set_by_generator совпадает с реальностью в обе стороны — каждый тег, который RS_LevelGraph за 12 сидов проставил узлам, помечен флагом, и каждый помеченный действительно выпадает. Вторая сверка не педантизм: по флагу инструмент выключает «Переименовать», и соврав в любую сторону, он либо блокирует безопасную правку, либо разрешает ту, что молча сломает подбор (ключи тегов в графе — строковые литералы). Обратного требования нет: тег в словаре, который пока никто не носит, — нормальное состояние (завели под ещё не нарисованную комнату). Запускать после правок в словаре, RS_LevelGraph (особенно если появился новый тег узла) или при добавлении пресета с новым тегом.
  • dev/door_sound_check.tscn — звук хода двери (S_DoorMotion → C_DoorMotion.sound, [[Звук]] §3а) на обеих настоящих сценах дверей: старт открытия и старт закрытия по hold заводят каждый своё событие хода (один и тот же путь), доехавший ход получает stop и уходит рантайму (release_when_finished), развёрнутый посреди закрытия — ничего (удар в упор посреди проёма), а разворот заводит новое событие, которое доезжает со stop. Старт наблюдается по AudioManager.event_requested, окончание — записывающим объектом, положенным в C_DoorMotion.sound после старта: проверка не зависит ни от рантайма byProd, ни от собранного проекта звука. Числа хода — из компонента, не литералами. Проверено мутацией: без окончания на закрытии падают два ассерта. Запускать после правок S_DoorMotion, C_DoorMotion и сцен дверей.
  • dev/vitals_sound_check.tscn — звуки модели тела ([[Звук]] §3б): удавшийся захват просит C_BodySnatch.capture_event ровно раз, неудавшийся — молчит; петля распада над порогом дуги (UI_HudMood.LOW) не заводится, ниже — заводится ровно раз, а не каждый кадр, ближе к нулю её Intensity выше и не выходит за intensity_max, над порогом она гаснет за fade_out и отдаётся рантайму, а не обрывается stop(). Проступание (fade_in) не проверяется: оно зовётся на инстансе в момент создания, до подмены. Запрос звука — по AudioManager.event_requested, петля после старта подменена записывающим объектом: от рантайма и собранного звука проверка не зависит. Порог — у дуги, не литералом. Проверено мутацией: без звука захвата падает ассерт захвата. Запускать после правок S_BodySnatch, S_DecaySound, C_DecaySound, UI_HudMood.read_vitals/decay и сцены игрока.
  • dev/footsteps_check.tscn — ассерты озвучивания ходьбы (S_Footsteps/C_Footsteps). Разовый звук (PER_STEP): идущее по земле тело просит звук, путь меряется ПУТЁМ а не временем (число шагов отвечает пройденным метрам, на удвоенной скорости шагов заметно больше), стоящий и висящий в воздухе молчат, событие берётся из компонента, а сущность без C_Footsteps в выборку не попадает. Петля (LOOP): на весь отрезок ходьбы ровно одна просьба сыграть, а не одна на шаг — зацикленное событие не кончается само, и «на каждый шаг» копило бы инстансы, пока не кончатся голоса; остановка снимает петлю и не просит звук заново, следующий отрезок заводит её снова. Наблюдается сигнал AudioManager.event_requested — он шлётся ДО проверки на загруженный проект byProd, поэтому проверка работает и без звукового контента. Тело — настоящий E_Enemy на настоящем полу с цепочкой S_Gravity → S_Movement: is_on_floor() считает только move_and_slide(), и на синтетической сущности без пола он всегда ложь — проверка молча мерила бы пустоту. Запускать после правок в S_Footsteps, C_Footsteps, AudioManager, либо если менялась скорость/стоп хода (S_Walk, C_Walk) — частота шагов следует фактической скорости.
  • dev/byprod_check.tscn — ассерты подключения аудиодвижка byProd (GDExtension addons/byprod): пять классов расширения зарегистрированы, менеджер создаётся, версия рантайма совпадает с той, под которую написан биндинг, запрос несуществующего события даёт null, такт и слушатель безопасны, а событие шагов (event:/sfx/walk) находится, заводится и переходит в STATE_PLAYING. Последнее проверяется именно так, а не по флагу «проект загружен»: банки рантайм просит у хоста сам, и промах по каталогу выглядит снаружи ровно как «нет такого события». Отдельно — что прогон не открывает устройство вывода: --headless глушит аудиодрайвер Godot, но не byProd, и без развилки в AudioManager проверки звучат в наушниках у того, кто их запустил. Ассерт честно слабый — спросить у рантайма «открыто ли устройство» нечем, поэтому сверяется решение AudioManager; ловит он ровно убранную развилку, после которой звук вернулся бы молча. Отдельный ассерт сверяет проект с МЕХАНИКОЙ: событие, которое просит карточка навыка (UI_SkillNode.unlock_event, @export-строка), в собранном проекте есть. Спрашивается строка с карточки, а не литерал рядом — сверка константы с самой собой зеленела бы всегда; расходятся здесь именно проект и то, что просит код, и расходятся молча: byProd один раз предупредит в лог, а экран станет беззвучным. Ровно так этот путь и жил, пока события в проекте не было. Отдельным блоком — громкость: значение из настроек доезжает до мастер-шины, ноль доезжает как ноль (а не теряется по дороге), значение вне диапазона прижимается к единице. Правится оно через SettingsManager.settings целиком, потому что проверяется вся цепочка «настройки → сигнал → движок», а не вызов в обход неё; исходные настройки проверка возвращает на место. Запускать после обновления расширения из godot-byprod, замены SDK, пересборки проекта звука в редакторе byProd, правок громкости (RS_Settings.master_volume, AudioManager._apply_volume) или паузы (AudioManager._apply_tick_level, _follow_pause).
    • Пауза (3 ассерта): биндинг умеет set_auto_pause — единственный ассерт про паузу, который проходит и без рантайма, и ровно он ловит отставший аддон в addons/byprod/bin/; а на живом рантайме инстанс, выданный AudioManager, уходит на паузе игры в STATE_PAUSED и возвращается в STATE_PLAYING после. Второе проверяется наблюдаемым состоянием голоса, а не вызовами, потому что ломается это тихо во все три стороны сразу (неподписанный инстанс, автолоад без PROCESS_MODE_ALWAYS, уровень тика, не вернувшийся к FULL) и выглядит одинаково — «звук ведёт себя не так», без ошибки в логе. Мутациями проверено: снятие подписки и возврат автолоада в PAUSABLE валят ассерт каждый по отдельности. Инстанс берётся у AudioManager, а не у описания напрямую: подписка ставится там, и мимо неё проверялся бы путь, которым механика звук не заводит.
    • Нативный рантайм (byProd.dll/libbyProd.so) в репозитории не лежит — лицензия Madrigal разрешает распространять его только внутри собранной игры. Его отсутствие не провал: проверка это печатает и переключается на ветку «деградация в no-op» (10 ассертов вместо 21). Провал — если без рантайма что-то падает или get_last_error() молчит.
    • В свежем клоне/worktree проверка провалится, пока не выполнен импорт (bash dev/import.sh — в облачной сессии его уже сделал SessionStart-хук; голый godot --headless --path . --import в headless виснет на многопоточном импорте, см. [[Релизы и сборка]]): список расширений лежит в .godot/extension_list.cfg, который в git не входит, а обычный запуск сцены его не создаёт — классов просто не существует. Та же ловушка по духу, что и с пустым addons/gecs.
    • Ни один класс расширения не назван в скрипте идентификатором, только строкой через ClassDB: иначе при незагруженном расширении скрипт не прошёл бы парсер, _ready() не запустился бы, и прогон завершился бы с нулём, пропустив ровно ту поломку, ради которой написан.
    • Менеджер берётся у AudioManager, свой заводить нельзя: второй ByProdSoundManager в одном процессе роняет рантайм segfault'ом прямо в создании, когда устройство уже открыто первым. Проверка, создававшая собственный, валила прогон кодом 139 — при том, что все её ассерты успевали напечататься зелёными, и в выводе поломка выглядела как чужая.
  • dev/brightness_calibration_check.tscn — ассерты экрана калибровки яркости (UI_BrightnessCalibration, [[Калибровка яркости]]). Пикселей headless не рисует, и калибровка ломается молча — экран спокойно подбирает яркость не для того мира. Поэтому сверяется, из чего складывается картинка знаков: та же кривая подъёма теней (adjustment_color_correction) и тот же тонмаппинг при той же яркости, что у окружения world.tscn (берётся его SceneState, а не литерал), свет эталонного слоя (L4) — серый той же яркости, чистый чёрный фон, знаки идут по тьме («виден» → «едва виден» → «не виден»), а ступень «Ультра» не добавляет знакам ни SSAO, ни SDFGI, ни тумана. Ползунок светлит знаки и не применяет яркость мимо «Готово». Потоки: из настроек — экран с яркостью черновика, «Назад» черновик не трогает, «Готово» кладёт значение в ползунок «Яркости» и зажигает «Применить», не трогая применённое; первый запуск — главное меню само открывает экран, «Готово» применяет и сохраняет, «Назад» тоже ставит отметку brightness_calibrated, откалиброванному экран не предлагается. Что подъём теней светлит фоновый свет, а exposure_multiplier камеры нет, headless не видно — это замер живым рендером (карточка). Проверено мутациями: знак без preview_brightness и меню без предложения/отметки валят каждый свои ассерты. user://settings.tres снимается и возвращается байт в байт. Запускать после правок экрана, LevelEnvironment, окружения мира, data/depth_lighting.tres, главного меню и меню настроек.
  • dev/settings_menu_check.tscn — ассерты вкладочного меню настроек (src/ui/settings_menu): состав и порядок вкладок, открыта первая, каждая настройка на своей вкладке и ни одна не задвоена. Проверка нужна ровно потому, что меню собирает контролы рекурсивным обходом поддерева, а не по путям: настройка, потерянная или вынесенная мимо вкладок при переверстке, не даёт ни ошибки, ни предупреждения — она просто перестаёт быть в меню. Отдельно два тихих инварианта раскладки: значения читаются и со скрытых вкладок (иначе baseline снимался бы неполным и «Применить» горела бы сразу при открытии — это и проверяется по кнопке), и минимум TabContainer не равен минимуму самой длинной страницы (ScrollContainer внутри вкладки рвёт эту связь, иначе «Управление» с раскладкой клавиш растягивала бы окно и на «Аудио» с одним ползунком). Меню инстанцируется напрямую, без UIManager; настройки игрока не трогаются — правится только черновик, «Применить» не нажимается. Запускать после любой переверстки меню настроек, добавления настройки в RS_Settings с контролом и правок settings_menu.gd/src/ui/settings/*. Чего проверка не видит: как это выглядит — стили живут в assets/ui/default_theme.tres, эхо и штрих рисуют UI_EchoButton/UI_SettingRow, и headless их не рисует. Зато видит поведение: кнопки-вкладки листают страницы в своём порядке, списки теней и эффектов строятся из каталога, пресет раскатывает и ступень эффектов, строка наполняет колонку подсказки. Окружение уровня (LevelEnvironment) на синтетическом WorldEnvironment: яркость ставит кривую подъёма теней, которая поднимает почти-чёрное и не трогает ни чёрного, ни белого, ни освещённого лампой выше колена (регресс на гамму всего кадра, пересветившую комнаты), ступень эффектов и флажок свечения не включают того, что автор не ставил (SDFGI автора — только на «Ультра», не на «Высоких»), и считаются от авторского, а не от прошлой ступени, общий .tres не задевается, окружение с apply_brightness = false кривой не ставит, туман по глубине кончается там, где лампы погасли, и идёт за ступенью теней. И по SceneState всех сцен src/: каждый WorldEnvironment — под LevelEnvironment, окружений на Camera3D нет. Лампа гаснет на дальности теней ступени (при «Выкл» — на unshadowed_light_distance), спрятанная лампа тень у видимой не отнимает (ShadowBudget), ниже 100 % разрешения включён FSR1, поле зрения из настроек доходит до камеры игрока (по горизонтали, E_Player._apply_fov — до 08.10 его никто не читал). Запускать также после правок E_Player, LevelEnvironment, LevelLight, ShadowBudget, SettingsManager._apply_graphics_settings и data/graphics_presets.tres.
  • dev/skill_graph_check.tscn — ассерты дерева навыков БЕЗ единого Control: радиальная раскладка SkillGraphLayout (место у каждого навыка, нейроны не налезают друг на друга, требование ближе к ядру, чем зависимый, нейрон в секторе своей ветки, секторы в порядке ordered_branch_ids), graph_row как слот по дуге, ветка по сумме рангов дальше от ядра, кольцо требований и обе развилки видимости — is_revealed («навык можно брать») и is_previewed («шаг вперёд пунктиром»). Запускать после правок SkillManager, раскладки сети и data/skill_tree.tres.
  • dev/skill_card_check.tscn — ассерты экрана навыков вокруг карточки справа: карточка не уходит за низ экрана и не шире колонки на каждом навыке боевого дерева, по-русски и по-английски (длинная причина на кнопке — «Сначала выполните требования» — уже раз распирала колонку; кнопка поэтому сдвинута на 26 px влево, как в спеке); кнопка называет ту причину, что есть (освоено / требования / нет очков), а не первую попавшуюся; вкладка Архитектора не видна до встречи с ним и видна после — в том числе у инкубатора; эссенция с тысячи — «12,4 тыс.»; старый сейв с рангами Архитектора считается встречей. Покупку не зовёт — сейвы подменены и не пишутся. Запускать после правок UI_SkillCard, SkillTreeUI, текстов навыков и при добавлении навыка с длинным описанием.
  • dev/skill_layers_check.tscn — ассерты слоёв нейросети на боевом дереве и на синтетическом с заведомо пустой веткой: подпись ветки видна ровно там, где у ветки есть показанные нейроны, берётся из данных и не накрывает нейроны; синапс есть на каждое показанное требование SKILL_RANK и на каждый корень (от ядра) — ни одного лишнего; синапс упирается в края нейронов, а не в центры; синапсы лежат под нейронами (своего z_index нет, держит порядок в полотне). Запускать после правок UI_SkillSynapse, UI_SkillGraph и подписей веток.
  • dev/skill_economy_check.tscn — ассерты экономики очков: порог 50% выжатости тела для «Чистого выхода», покрытие каталога статов навыками, validate() обоих деревьев и сброс дерева на «Новую игру» (включая то, что покупка навыка не пишет в дефолтный сейв — duplicate() не копирует Dictionary). Реально зовёт add_skill_points/unlock, то есть ПИШЕТ на диск, поэтому оригинальный SkillManager.save возвращается и пересохраняется в конце.
  • dev/debug_overlay_check.tscn — ассерты отладочного оверлея (dev/debug_overlay.gd, читы для живого прогона — см. [[Отладочный оверлей]]): путь оверлея в main.gd ведёт на существующую сцену (опечатка не даёт ни ошибки, ни предупреждения — ResourceLoader.exists() вернёт false, и читов просто не будет), каждый пресет экспорта исключает dev/* — единственное, что держит читы вне собранной игры, а фильтр правится в диалоге экспорта одним кликом; шпаргалка на экране соответствует таблице читов (строка на каждый, ни одной пустой); клавиши не повторяются и не пересекаются с InputMap (до второй записи на ту же клавишу перебор не доходит, и чит выглядит «не работает»; этот ассерт сразу и нашёл F5, занятый встроенным ui_filedialog_refresh); «слой ниже» ведёт вглубь — сверка идёт с самим RS_LevelGraph, а не с числом в проверке; бессмертие держит полными ОБА кармана распада, и перед этим отдельный ассерт требует, чтобы без чита карман убывал — иначе «не убыло» было бы правдой зря и проверка зеленела бы на сломанном S_Lifespan. Клавиши не подставляются в обход обработчика: синтезируется InputEventKey и зовётся _unhandled_key_input, то есть проходится тот же путь, что при живом нажатии. Сейвы SkillManager и ArchitectManager подменяются и возвращаются на место — начисление очков и эссенции ПИШЕТ в user://. Четыре ассерта — раздел «Прокачка» меню отладки: кнопка на каждую запись таблицы начислений оверлея с её подписью, очки ложатся только SkillManager, эссенция только ArchitectManager (валюта в чужом дереве не падает — экран Архитектора просто пуст), меню после начисления не закрывается. Семь — меню отладки (dev/debug_menu.tscn, клавиша `) и его «Телепорт»: меню открывается через стек UIManager и не открывается дважды, кнопка на каждую запись unique_rooms, поиск по room_scene_path на пяти настоящих сидах (мутация «искать по другой строке» его валит), круг по комнатам одной сцены, кнопка без забега. Четыре — сид забега: в строке оверлея сид графа (RS_LevelGraph.run_seed, а вне забега — RS_WorldSave.run_seed()), а не сид мира, и без обрезки (сид за пределами int32), кнопка меню называет его же и кладёт в буфер (в headless буфера нет — сверяется сообщение оверлея); мутация «показывать world_seed» валит все четыре. Пересечение с InputMap не засчитывает действия с модификатором (Ctrl+` у ui_swap_input_direction): голая клавиша их не вызывает, мутация «чит на F5» по-прежнему ловится. Сам travel_to здесь не зовётся — ему нужен живой мир. Запускать после правок таблицы читов и начислений, меню, main.gd, фильтров экспорта и unique_rooms в конфиге генерации.
  • dev/body_look_check.tscn — варианты облика (C_Look, шесть обликов и двое очков учёного): розыгрыш по месту детерминирован, разные сиды дают разные лица, глобальный ГСЧ не тронут; облик на всей геометрии тела с растворением, виден ровно один вариант очков; при захвате номера и облик уезжают на душу и риг; контрольная точка RunManager пишет номера в сейв, а _restore_embodiment возвращает тот же облик; труп врага носит облик врага; visual_of_scene с номерами и без. Мутации «розыгрыш случайным ГСЧ» и «риг не переносит видимость» валят по ассерту. Разыгрыш на спавне слоя и пересборку держит dev/enemy_roster_check (три ассерта облика). Запускать после правок C_Look, RS_EntityVisuals.roll_look/dress, O_BodyVisual, O_EnemyDeath, сейва тела, сцен учёного.
  • dev/polygon_check.tscn — полигон ([[Полигон]]) на настоящей сцене dev/polygon/polygon.tscn: системы и наблюдатели те же, что у world.tscn (сравниваются узлы сцены, добавленные на ходу — слушатель HUD — нет), забег не начат; стенд клипов ведёт время сам — перемотка двигает позу костей, пауза её держит, кадр вперёд ровно Animation.step, петля и её отсутствие; клип без петли после конца пускается заново и перематывается (плеер, доиграв его, сам останавливается, и стенд, ждавший «играет», замирал — мутация «опора на current_animation» валит два ассерта). Версии клипов: имя файла относит её к самой длинной основной, синтетическая версия (run ← walk, в памяти, без файла) на стенде даёт позу walk, A/B на той же позиции — основную; общая подмена встаёт манекену и новому дереву, но не стенду, «основные» её снимают. Дорожка: манекен без C_EnemyInput с C_EnemyAI, каждая скорость из presets() даёт свой клип, манекен держит круг, укус/попадание/прыжок видны в дереве, прочность после попадания возвращается, гибель настоящим путём (S_Health → O_EnemyDeath) — труп в death. Мат: захват с первого раза, тело поглощено и кладётся новое. Экраны забирают и отдают кадр и ввод; раздел «Полигон» меню отладки есть только в полигоне, кнопка станции переносит. Станция камеры от третьего лица — на игровой камере (C_ThirdPersonCamera, S_ThirdPersonCamera, S_CameraAim; карточка «Вид от третьего лица»):

    • кадр ведёт камера от третьего лица, интерполяция физики включена;
    • у стены коридора плечо короче и камера не за стеной;
    • маска плеча повторяет маску формы: душа с фазированием проходит решётку вместе с камерой, во плоти hound упирается;
    • голова и руки облика в кадре;
    • облик, манекен и решётка гаснут копиями материалов, общие не тронуты;
    • опора маленькой души не у пола;
    • два луча прицела (S_CameraAim + AimRay): дальность интерактива — от тела, стена между глазами и целью обрывает луч;
    • у решётки полёт вперёд идёт горизонтально (полёт — по взгляду, а не по направлению от глаз к прицелу);
    • слушатель звука у глаз персонажа и повёрнут как камера, а на экранах стенда стоит у камеры облёта (AudioManager.listener_pose(); мутация «уши в камере» валит ассерт);
    • мышь крутит камеру, а не тело; «вперёд» — куда смотрит камера; душа разворачивается по направлению передвижения, а на захвате сразу встаёт к прицелу (S_BodyTurn, мутация «полёт по рысканию тела» валит два ассерта);
    • стрейф тела hound: шагом вбок тело держит взгляд камеры, идёт со скоростью C_Walk.side_speed_scale смесью клипов к strafe_right, а бег разворачивает его по передвижению (мутации «тело не держит взгляд» и «доля скорости не применяется» валят три ассерта).

    Проверено мутациями: постоянная маска геометрии валит ассерт решётки (на прототипе), полёт по базису камеры в глазах — ассерт полёта, второй луч из камеры — ассерт дальности, маска интерактива без стен — ассерт стены (для него плечо прямо за телом: со сдвигом луч уходил мимо цели и без стены). Запускать и после правок систем камеры и лучей (S_CameraAim, AimRay, детекторы, S_Attack), S_SoulCloud, PlayerPlacement. Уход со сцены сбрасывает Engine.time_scale, интерполяцию физики и подмену. Ассерт гибели нашёл баг с первого прогона: без нулевого шага дерева в e_body_rigged.gd._fall труп стоял в idle, мутация «убрать advance(0)» его валит. Сейв навыков снимается и возвращается. Запускать после правок dev/polygon/, S_BodyAnimation, O_BodyVisual, O_EnemyDeath, S_Phasing, сцен hound и игрока, тайлов коридора, меню отладки и main.gd.

  • dev/hud_check.tscn — ассерты HUD «Отголосок» без пикселей ([[HUD — спека]]). Кривые эффектов экрана (UI_HudScreenFx.update_params) сверяются с таблицами спеки по каждой строке: стабильность души, распад тела (без базы, в сепию, стабильность души не протекает в тон тела), кровь по HP — опечатка в пороге не роняет ничего, экран просто давит не тогда. Удар и волна вселения — импульсы, которые гаснут; цвет волны — нового кармана; красная вспышка растёт с долей урона (царапина — слабо, но не ноль); каждый удар кладёт новую раскладку пятен крови и перетекает в неё с прежней, а не рывком. Дуга (UI_DecayArc): ровное убывание её гасит, скачок на 0.05 за полсекунды зажигает, пороги 35 % и 15 %, излишек держит видимой, во плоти она показывает карман тела даже при пустой душе. Смятение T от числа тел в RunStats. Сообщение: таймлайн и равенство C_ScreenMessage.remaining его длине, перенос после 720 px, резкость посередине показа и размытие на растворении. Подсказка — «[клавиша] действие», тень шире строки. Имена кнопок мыши и пробела — ключами. В сцене HUD нет ни одной подложки и полосы, эффекты экрана лежат ниже обводки, вариации Hud* темы (и HudMap* мини-карты) — на Golos; перо мини-карты (UI_MiniMap._partial) обрывает контур по доле длины пути, а не по доле точек. Время проверка подаёт сама (update_state/update_params принимают t), кадры движка не нужны. Раздел HUD в abilities_check — строки управления на смене тела и сообщение отказа на настоящем мире. Запускать после правок src/ui/hud/, темы, C_ScreenMessage и подсказок дверей в LayerStreamer.
  • dev/version_label_check.tscn — ассерты: номер сборки виден там, где его ищут по скриншоту бага, — в углу главного меню и в строке состояния отладочного оверлея — и это ровно application/config/version. На время прогона подставляется номер не-релизной сборки 0.7.0-dev.33+fc91d3c, а не тот, что в project.godot: показывать надо именно его, с + и точками как есть ([[Релизы и сборка]], «Номер сборки»). Оверлею нужно два кадра: process_frame приходит раньше _process узлов, и после одного ожидания в строке ещё «—». Запускать после правок главного меню и строки состояния оверлея.
  • dev/menu_scene_check.tscn — ассерты живой сцены за главным меню (L_menu_map.tscn, [[Меню — спека]] §8). Сцена грузится и крутится 90 кадров без единой ошибки движка — у проверки свой логгер на все ошибки, а не только на SCRIPT ERROR обвязки: битый путь узла или ресурса в сцене, которую игрок видит первой, — тоже провал. Время сцене и колбе (Incubator/Flask, IncubatorFlask) проверка подаёт сама (свой _process у них выключен): свечение колбы за 120 с не выходит за ±15 %, гуляет хотя бы на 10 % и жидкость стекла светится в такт со светом; лампа за 90 с больше мертва, чем горит, вспышек заметно больше, чем пауз, и паузы разные. Настоящая модель: объём колбы — по её стеклу, мозг и пузырьки — на её пустышках BodyAnchor/BubbleSource, пузырьки непрозрачны (прозрачные стекло с преломлением прячет при любом порядке), и самый быстрый из них гаснет у крышки колбы, а не над ней; жидкость не толще диаметра колбы. Без арта (стекло и метки с модели сняты): запасная колба без жидкости, свет в её середине, мозг и пузырьки внутри неё, кольцо пузырьков уже колбы, у каждой декали крови есть текстура-заглушка, у собаки и учёных есть метка menu_action. Подмена арта — в модель, с которой снят её контракт, до входа в дерево подкладываются стекло с MAT_incubator_glass, метки BodyAnchor/BubbleSource, декаль с готовой текстурой и AnimationPlayer с eat: колба берёт объём у стекла, а жидкость — его диаметр, мозг и пузырьки встают на метки, чужую текстуру заглушка не трогает, анимация играет. Общие материалы лампы и кольца колбы после ухода сцены — авторские. Имена меток и доля колбы берутся у скрипта колбы. Проверено мутациями: мозг мимо метки, свечение константой, невозвращённый материал, битый путь узла — каждая валит свои ассерты. Запускать после правок l_menu_map.gd, L_menu_map.tscn, e_incubator.tscn, incubator_flask.gd, заглушек src/levels/menu_map/stubs/ и при приходе арта инкубатора.
  • dev/depth_lighting_check.tscn — ассерты света по слоям (RS_DepthLighting, data/depth_lighting.tres). Данные — направление, а не числа: свет есть у каждого слоя RS_LevelGraph.DEPTHS (слоёв света может быть больше — L5 заведён раньше генератора), глубже — не светлее (фон, лампы, туман не ярче, туман не реже, погасших не меньше), у поверхности погасших нет. world.tscn: окружение мира с apply_depth_lighting и фоновым светом в режиме «цвет» (в другом цвет слоя молча ничего не значит). Слои грузятся настоящим RunManager (_despawn_layer/_spawn_layer), лампы считаются в дереве: у поверхности горят все лампы коридора, на дне погасла доля около заданной, тот же мир гасит те же лампы, лампы на дне тусклее ровно во столько, во сколько велит слой; на каждом тайле один плафон (LampFixture), светится ровно у горящей лампы и на дне тусклее, тросик нашёл потолок коридора (после физкадра — меряется лучом); смена слоя перезапускает SDFGI окружения (выключен на кадр, затем снова включён). Синтетический LevelEnvironment с флагом на дне темнее, у поверхности без тумана, на дне туман плотнее, без флага не слушает слой, после снятия слоя возвращает авторское (и плотность тумана), общий .tres цел. Проверено мутациями: лампа без подписки на layer_changed и стример, не снимающий погасшую лампу, валят каждый свой ассерт. Сейв забега подменяется и возвращается. Запускать после правок LevelLight, LevelEnvironment, LayerStreamer._spawn_corridor, data/depth_lighting.tres, окружения мира и сцен тайлов коридора, src/levels/lamp*.tscn и LampFixture. Как это выглядит — только плейтест (ниже).
  • dev/soul_glow_check.tscn — ассерты свечения души (C_SoulGlow, S_SoulGlow) на настоящем e_player.tscn: лампа по пути компонента находится; на полном запасе — energy_full, у порога тускнеет и тем сильнее, чем ближе, но не ниже energy_faded; во плоти свет следует за карманом тела (душа полна, тело на исходе — тускло), цвет перетекает к янтарю, а не прыгает, и приходит к палитре HUD (UI_HudMood.BODY), вне тела — SOUL. Числа — из компонента и палитры, не литералами. Запускать после правок S_SoulGlow, C_SoulGlow, лампы свечения в e_player.tscn, UI_HudMood.read_vitals/decay.
  • dev/soul_cloud_check.tscn — облик души (C_SoulCloud, S_SoulCloud) на настоящем e_player.tscn: вне тела сгусток и след видны и идут, сгусток стоит в душе и уходит за ней; камера вплотную — сгусток гаснет (прозрачностью экземпляра), издали — плотный (мутация «без затухания» валит ассерт); ближе к распаду сгусток и след получают больший decay, а частиц в следе меньше, но не меньше decay_amount (на спокойном запасе — ни того ни другого); основной меш рига (RS_EntityVisuals.primary) — пустой слот, а не частица облика; во плоти гаснет всё, а меш тела надет на слот; после пересадки тело→тело и выхода слот снова пуст, облик снова виден и стоит в душе, а не там, где прятался. Выход (O_SoulExit, SoulExitFx): душа уносит из тела лишь долю скорости (exit_inertia), брошенное тело — того, из которого вышли, вне мира ECS, без слоёв коллизий, уходит по инерции рига, сгорает (все меши в материале сгорания, burn идёт) и вместе с эффектом убирает себя; сгусток после выхода рваный и через unfold_seconds снова по запасу; брошенное тело встаёт в переданную позу, а не в позу покоя (поза задаётся в проверке: риг пока без скелета, и снятие живой позы _worn_pose не проверяется). Сейв навыков снимается и возвращается (выход бывает «Чистым»). Проверено мутацией: слот меша, поставленный в сцене после камеры с частицами, валит ассерт про основной меш и обрывает блок, облик без _apply_decay — три ассерта распада, кости без скорости — ассерт инерции, тело без _ignite — два ассерта сгорания, без _apply_pose — ассерт позы. Коалесценцию remove+add при пересадке, от которой страхует C_BodyVisual.restore_captured, проверка не воспроизводит: мутация «без флага» проходит. Запускать после правок S_SoulCloud, C_SoulCloud, O_BodyVisual, S_BodySnatch (облик), O_ExpelFromBody, O_SoulExit, SoulExitFx, body_burn.tres, UI_HudMood.decay, графа soul_smoke.tres и порядка узлов e_player.tscn. Как облик выглядит — только живой прогон.
  • dev/character_check.tscn — контракт рига на стороне Godot ([[Пайплайн персонажей]]) по всем сценам облика assets/characters/*/SK_*.tscn: у скелета есть кости Root и Head (имена SkeletonProfileHumanoid); каждое свойство *bone_name узлов под скелетом — IK, CopyTransform, LookAt, физические кости, в том числе массивы settings/N/... — называет существующую кость; каждый узел, записанный в .tscn облика, нашёлся в собранной сцене; у каждой поверхности внешний MAT_*. Ломается всё это молча: переименование кости или объекта в Blender не роняет ничего — Godot на загрузке только предупреждает «was modified from inside an instance, but it has vanished» и отбрасывает переопределение. Персонажей пока нет, поэтому детектор держит синтетика: облик в памяти чист, а каждая мутация (модификатор на несуществующую кость, кость в настройках IK, облик без Head, встроенный материал) валит свою сверку; потеря узла базы проверяется настоящей парой «база + унаследованная сцена» во временной user://character_check, удаляемой прогоном. Запускать после экспорта или переименования персонажа в Blender, правок сцен облика и при добавлении модификатора скелета.

Статистика генератора — какой пресет сколько раз выпал, где встретить, метрики раскладки — не проверка, а инструмент: панель «Прогон сидов» вкладки «Генератор мира» (addons/game_design_tool). Прежние dev/preset_stats.gd (под --script, где автолоады не существуют и Entity не компилируется) и печать dev/gen_verifier её дублировали и удалены.

Как писать проверку

Новый инвариант заслуживает проверки, когда его нарушение тихое — не падает с ошибкой, а молча меняет поведение (характеристика не перенеслась, граф распался, число ушло в ноль). Падающее с ошибкой ловится и без теста.

Проверяется наш код, а не Godot и не Blender (решение пользователя 02.11). Ассерт, который зеленеет или краснеет от поведения движка или экспортёра при неизменном нашем коде («кость доехала через glTF», «экспортёр снял смещение», «id кости появился через кадр»), — не проверка проекта: убрать или оставить молчаливым условием, без которого проверять нечего. Знание о ловушке движка живёт в вики и пометкой в коде. Это касается и тестов аддона Blender (tools/blender/tests/).

Два требования, без которых проверка врёт:

  • Зелёный прогон что-то значит, только если провал даёт ненулевой код выхода. Обвязка check_harness.gd делает это сама; проверка в обход неё, новый раннер или обёртка над godot сначала проверяются на заведомо красном случае — иначе «всё прошло» может значить «ничего не проверено».
  • Настоящий сейв игрока проверка оставляет таким, каким нашла. Всё, что пишет в user:// (WorldSave, SkillManager, ArchitectManager), до прогона копируется и после возвращается, включая случай «файла не было» — образец в dev/run_stats_check.gd (_save_backup/_restore_save). Отдельной временной папки для сейвов у проекта нет: пути зашиты константами автолоадов.

Куда класть: расширять существующий сценарий, если инвариант из той же области (модель тела → dev/body_traits_check.gd, граф генератора → dev/corridor_graph_check.gd, раскладка → dev/corridor_layout_check.gd), и заводить новый dev/<область>_check.tscn + .gd только под новую область.

Скелет (scripts/check_template.gd — готовый файл для копирования). Вся обвязка — счёт ассертов, итоговая строка, код выхода, мир, системы, физкадры и сторож ошибок скрипта — живёт в dev/check_harness.gd, и проверка её наследует:

extends "res://dev/check_harness.gd"
## Что проверяет и почему. Запуск: godot --headless dev/<имя>.tscn


func _ready() -> void:
    var world := _new_world()
    _add_systems(world, "gameplay", [S_Что_Проверяем.new()])

    await _run(world)

    _finish()


func _run(world: World) -> void:
    # --- 1. Что именно проверяем ---------------------------------------
    _check("человекочитаемое утверждение", условие, "детали при провале")

Правила, вытекающие из устройства проекта:

  • Сцена-обёртка обязательна. Запускать надо .tscn с этим скриптом на корне, а не --script <файл>: под --script автолоадов не существует, Entity не компилируется, и проверки молча деградируют (ровно этим был сломан удалённый dev/preset_stats.gd).
  • Мир и системы поднимаются руками — _new_world() и _add_systems(world, "группа", [...]), наблюдатели через world.add_observer(...). Берётся только то, что нужно проверке. _add_systems сортирует группу по deps() так же, как игра: без сортировки проверка гоняет системы в порядке списка, которого в игре нет (так годами было не видно, что ход и прыжок применялись на тик позже — см. dev/system_order_check.gd).
  • Физика — из настоящего физкадра: await _physics(n) прогоняет n тиков группы "physics"; если тику нужно больше (толкать тело, крутить "gameplay") — переопределить _on_physics_tick(delta).
  • Обрыв блока ошибкой скрипта — провал сам по себе. SCRIPT ERROR прерывает только текущий блок, и раньше прогон доходил до итога с нулём провалов; обвязка считает такие ошибки движковым Logger'ом и валит прогон. Считать ассерты вручную (EXPECTED_ASSERTS) больше не нужно.
  • Такт мира — ECS.process(delta, "группа") с тем же именем группы, что у системы. Дельту задавать явно (0.016, 1.0) — прогон не привязан к реальному времени, и «одна секунда» это буквально ECS.process(1.0, ...).
  • После call_deferred нужен await get_tree().process_frame. Развоплощение и переход через дверь отложены (правило v9), и без ожидания кадра проверка увидит состояние ДО них.
  • Ассерт формулируется как утверждение о поведении, а не о реализации: «остаток тела перетёк душе», не «поле current равно 119». Детали в третьем аргументе — они печатаются только при провале и должны объяснять, что пошло не так.
  • Числа брать из GameConfig/сцены, а не хардкодить, если они настраиваемые — иначе тюнинг баланса ломает тест, который ничего не поймал. Ассерт сверяет отношение («остаток тела перетёк душе», «ранг растит стат»), а не значение баланса (== 119.0, «перк: 2.0 + 2 · 0.5»). Исключение — таблицы спеки (hud_check): там число и есть требование.

Чего ассерт делать не должен — всё это нашлось при ревью проверок 08.10 и удалено:

  • Утверждать литерал true. _check("не роняет", true) не может упасть; падение и так ловит сторож ошибок скрипта, а segfault — отсутствие итоговой строки. Сценарий оставить, ассерт убрать.
  • Повторять формулу проверяемого кода. Пересчёт маски поворота той же rotate_mask или сдвига тряски тем же шумом зеленеет на любой мутации: сверяется функция с собой. Проверять наблюдаемое (лучи по коллизии, границы величины).
  • Сверять свой же литерал. ResourceLoader.exists(OVERLAY_PATH), где путь — константа самой проверки рядом с preload той же сцены, существует всегда. Брать значение у того, кто им пользуется (main.gd.DEBUG_OVERLAY_PATH).
  • Гонять собственный цикл вместо кода. «Максимум глубины монотонен», посчитанный maxi() прямо в проверке, не трогал RunManager вовсе.
  • Читать свойство константы. const M := preload("…tres") и затем M.emission_energy_multiplier — анализатор GDScript сворачивает такое обращение при разборе, и проверка вечно видит значение из файла, а не живого ресурса (id совпадает, значение — нет). Ассерт «материал вернули» на этом зеленел при мутации; ресурс, который меняется во время прогона, держать полем (var m: StandardMaterial3D = preload(…)).
  • Держать ручной список имён. Список id навыков отстаёт от кода и падает на переименовании, ничего не поймав; брать перечень из данных (validate() дерева).
  • Дублировать чужой инвариант. Связность графа и детерминизм проверялись в трёх местах каждый; у инварианта одна проверка-хозяин, остальные ссылаются на неё комментарием.
  • Проверять ключи перевода и тексты. Ни наличие ключа в ui.csv, ни перевод, ни дословная строка не проверяются нигде (решение пользователя 15.10): такой ассерт сверяет таблицу с её копией в проверке, ломается от правки формулировки или от локали хоста и бага не ловит. tr() в проверке — только чтобы узнать, какую строку должен показать интерфейс.
  • Выход — через _finish(): итоговая строка и код выхода, на которые опираются dev/run_checks.ps1 и CI. Раннер верит итоговой строке больше, чем коду: проверка, сменившая сцену до своего quit(), выходит с чужим кодом.
  • Один инвариант — один ассерт. Перебор по сидам, узлам или сценам собирает нарушения в список и засчитывает его одним _check с первыми примерами в деталях (образец — problems в corridor_layout_check). Ассерт на каждый элемент давал тысячи строк «ok» (world_gen_tool_check печатал их 2500) и прятал в логе CI единственный провал. _print_passes = false — крайняя мера, а не норма.
  • Сейвы в user:// — настоящие сейвы разработчика, отдельного каталога у проверок нет. Писать туда может не только явный вызов, но и механика по дороге: «Чистый выход» из тела начисляет очко и сразу сохраняет skills.tres, контрольная точка пишет world_save.tres. Проверка, которая дёргает такую механику, снимает байты файла в начале _ready() и в конце возвращает их ассертом — как run_stats_check и abilities_check. Утечку видно только по значениям в файле: прогнать проверку, сравнив skills.tres, architect.tres, world_save.tres до и после.

Дописав проверку по этому шаблону, регистрировать её в dev/run_checks.ps1 не нужно — файл, названный dev/<область>_check.tscn, скрипт находит сам (-ListChecks покажет, что подхватилось). Обновить стоит только §«Что именно проверяется» здесь — что именно проверка покрывает и после каких правок её запускать, скрипт этого сам не знает.

Чек-лист ручного плейтеста

Headless-проверки покрывают структуру, не ощущения. После них — реальный прогон: играть world.tscn напрямую (пропустить меню) или через New Game из L_menu_map.tscn, если менялся флоу старта. Смотреть конкретно на область правки:

Состояние для прогона набирается оверлеем, а не забегом. В отладочной сборке поверх мира висит панель читов (dev/debug_overlay.tscn, F1 — свернуть): экран навыков не отходя от места, телепорт по слоям, выключенный распад, а в меню отладки (`) — очки навыков пачкой и эссенция Архитектора (уровень карты комплекса покупается ею). Раньше, чтобы посмотреть на правку в дереве навыков, нужно было бегать пару минут ради очков — то есть цена взгляда была выше цены правки. Подробности и границы: [[Отладочный оверлей]].

  • Обводка силуэтом (S_OutlineMask) — headless не рисует ни одного пикселя, поэтому картинка проверяется только здесь. Смотреть: контур ровной толщины и на мелкой детали, и на крупной стене; у составного объекта (дверь = рама + полотно + ручка) ОДИН силуэт без внутренних рёбер; ничего не мерцает, хотя material_override на объектах больше не стоит; объект вплотную и в паре метров, объект у края экрана — контур не обрезан; наведение и снятие не оставляют контур висеть. Заодно снять кадровое время с выделенным объектом и без него — цена постэффекта в карточке значилась риском.
  • Захват тела: тело село вровень с полом, а не утоплено/парит (регрессия foot_offset/типа коллайдера — body_traits_check ловит только что офсет не нулевой, не то что он верный визуально); обводка красится по всей сложной геометрии, а не только по части меша; пробовать захват в заспавненной комнате, а не только в хабе — там своя геометрия пола, и именно там нашёлся баг «Тело здесь не поместится» на штатно стоящем теле (body_form_check теперь это проверяет headless, но по-другому расставленное новое тело/комната всё ещё стоит пощупать глазами).
  • Двери/переход: игрок появляется перед дверью, ведущей назад, лицом в комнату (не боком); прицел не сбит рывком (пишется только позиция, не поворот — см. CLAUDE.md, «Doors ↔ graph edges»); дверной порог проходится шагом, не прыжком (S_Movement.STEP_HEIGHT — см. ниже).
  • Коридоры и раскладка сетью (п. 7 «Сетки уровня»): headless сверяет маски и лучи, а не то, как этаж читается. Пройти пару этажей целиком (телепорт по слоям — оверлей): коридор подходит к комнате с одной-двух сторон, а не обходит её; две двери одной комнаты в разные коридоры — это обход, по нему реально вернуться другим путём; петля по коридору не выглядит вторым рядом вдоль того же коридора. Тупик (SM_corridor_P_end, 1–2 клетки от коридора): стоит проёмом к коридору, без щелей и провала на стыке, свет в нём есть, и читается он нишей, а не недостроенным проходом к двери. Стык двух коридоров на развилке не отличается от обычного коридора (шлюзов пока нет). Карта (мини и экран, M) рисует тупик рукавом и кольцо коридоров без разрывов.
  • Коридор — отдельный узел: текущий узел меняется на каждой развилке при входе в боковой коридор, а не посреди прямого; мини-карта (посещённое и соседи) при коридоре на отрезок показывает сеть кусками — проверить, что это читается, а не выглядит обрывками; «Комнат посещено» в итогах забега не растёт от коридоров.
  • Сейв прежнего генератора: забег, сохранённый на версии генератора ниже 2 (или с правленой generator_version в сейве), грузится у входа, с тем же запасом и телом; карта пуста, посещённых нет — а не в чужой комнате.
  • Перешагивание порогов (S_Movement): мелкие ступеньки и кромки комнатной геометрии (< 0.16 м — дверные пороги, стыки меша) проходятся ходьбой без рывка/подлёта, который выдавал бы телепорт вверх; настоящая стена или высокий бортик по-прежнему не пускают. Смотреть также на теле меньшего роста («ползун») — у него капсула тоньше, и естественный «перекат» голого move_and_slide() слабее, так что правка там нагляднее. Уперевшись в настоящую стену, прыжок обязан срабатывать сразу (был баг: _try_step() портил is_on_floor() на кадр, и прыжок у стены иногда молча не выходил).
  • Промпт интеракции: показывает верную клавишу для действия (SettingsManager.action_display_name()), перерисовывается сразу после ребайнда в настройках без выхода из игры.
  • HUD «Отголосок» (hud_check сверяет числа, а это — ощущение; спека — [[HUD — спека]]): дуга у прицела сиреневая вне тела и янтарная во плоти, переключается на вселении и выходе за четверть секунды с волной от краёв; на спокойном запасе гаснет, на заметном скачке и ниже 35 % видна, ниже 15 % бьётся. Ранний распад не давит постоянно — только слабая база, нарастание у порога. Излишек после выхода из тела — внешняя дуга с искрами. Во плоти при малом HP кровь пятнами по краю (не ровным кругом), удар — вспышка (сильнее от тяжёлого удара) и лёгкая тряска, пятна после удара ложатся иначе и перетекают, а не прыгают. Подсказка и сообщение читаются на светлой стене без плашки; «эхо» текста дрожит, а не двоится грязью; английский (сменить язык системы) не вылезает за края. Управление появляется на вселении и гаснет через ~4 с. Удобная сцена — оверлей: бессмертие выкл., тело с врагом рядом.
  • Мини-карта по Tab (нужен ранг «Карты комплекса»: эссенция из меню отладки, покупка у Архитектора): открывается на ходу без паузы, Распад под ней тикает, мышь крутит камеру; контуры прорисовываются от текущей комнаты наружу, подписи — следом; точка игрока идёт за ним по коридору; Tab растворяет, M сворачивает её и открывает полную карту (только на последнем ранге, ниже — строка про терминал). Коридоры — бусы на нитке: нить только через открытые проёмы, так что соседние несоединённые ветки не сливаются в сетку; узнал новую комнату — карта плавно перевписывается, без скачка. Рамка рвётся, как дуга распада, но тише, и не спорит с точкой игрока; на светлой стене всё читается за счёт тени-пятна.
  • Враг (S_EnemyAI): на расстоянии стоит, при подходе разворачивается и бежит без рывков и залипаний в геометрии; в упор реально снимает HP (у края экрана проступает кровь, удар трясёт кадр), а не бьёт сквозь стену; добитое тело выбрасывает игрока в призрака без зависаний. Headless проверяет числа и переходы состояний, не то, ощущается ли погоня как угроза, а не декорация. Навигация и обнаружение: враг не замечает через стену и за спиной (но вплотную замечает), обходит угол комнаты и коридора, а не упирается в него; потеряв из виду, идёт на место, где видел, и сдаётся, а не бежит прямо к игроку; сразу после входа в слой (первые доли секунды, пока навмеш запекается) идёт по прямой без залипаний. Отладочный вид навмеша — Debug → Visible Navigation в редакторе.
  • Прототип v0.7.0 — цикл от и до (волны 1–2, [[Игровой цикл — от и до]] §10). Headless сверил числа и детерминизм; здесь — читается ли цикл. Пройти «Новой игрой» от колбы до двери наружу, остальное добрать телепортом оверлея:
    • Удар (ПКМ): во плоти бьёт то, на что смотришь, сквозь стену — нет; в теле без C_Attack — «нечем бить», в призраке — ничего. Добитый враг в тот же миг становится трупом на своём месте (без прыжка и мелькания), труп захватывается, удар переезжает с телом.
    • Ростер по слоям: на L0–L1 учёные, на L3 военные, на L4 военные и гончие, на дне существа L5; враги стоят на полу, не в стене и не в двери, часть маркеров пуста. Вошёл в слой второй раз — те же враги на тех же местах.
    • Существо L5: крупнее гончей и красноватое — читается как другой класс издалека. Удар слабым телом почти не снимает HP (×0.1), телом L5 — в полную силу; понятно ли игроку, почему, — записать (подсказки нет, хвост в [[Бой — начало]]). Захватить труп L5: камера на высоте глаз туши (2.56 м) не в потолке и не в полу, тело помещается в коридоре и проходит в дверь.
    • Очки души и навыки: первое тело вида даёт больше повторов; ранг с условием показывает прогресс в карточке навыка и после выполнения даёт бонус.
    • Эссенция: в комнатах есть находки, в тупиках иногда тайник; подбор показывает «Эссенция: +N», без навыка «Сбор эссенции» N около трети диапазона, с полным навыком — весь. Взятое не появляется после выхода в меню и загрузки; в итогах забега находки и тайники — отдельными строками. Призма-заглушка видна, но не бросается в глаза как мусор геометрии.
    • Архитектор: улучшения раскладки покупаются эссенцией и чувствуются в следующем забеге (меньше тупиков, переходы ближе), а не в текущем.
    • Подача цели: первая мысль ходока «Наверх. Выход на нулевом.» выходит через секунду после захвата и не сбивает строку HUD; полоса L0 на карте подписана «выход». Надписей и подсказок у дверей и порталов нет (16.10).
    • Концовка: дверь «Наружу» в комнате выхода → затемнение, текст, титры, сводка; Esc пропускает; главное меню после — «Комплекс покинут», «Новая игра» снимает отметку.
  • Вывод редактора (Output) во время игры — открыт при запуске из редактора: push_error «structural change during zero-copy system iteration» значит, что где-то в process() структура мира менялась напрямую в обход cmd-буфера (см. «Правило v9» в CLAUDE.md) — тихий баг, который headless-прогон не покажет, если сценарий теста не задел ровно тот код-путь.
  • Оверлей «Сетка» «Генератора мира» — headless считает отрезки, а не то, как схема читается. Новый оверлей появляется только после перезапуска редактора (или выключения-включения плагина). С выключенной «Геометрией»: решётка тёмная и не спорит с контурами, стрелка поворота не мерцает на перекрестье, стрелки дверей видны рядом с плитами «Коридоров» и указывают внутрь комнаты, крест тупика и черта стыка находятся глазом; выделение комнаты перекрашивает её контур и стрелку. С включённой — линии под потолками не лезут поверх мешей.
  • Экран карты комплекса (M или терминал screen2 в хабе) — headless проверяет данные и обратную проекцию, не картинку. Уровень карты ставится рангами «Карты комплекса» у Архитектора; эссенцию на них — из меню отладки («Прокачка»), экран Архитектора — телепортом в его комнату там же. Смотреть: этажи рядом не слипаются, клетка не раздута на крошечном этаже (MAX_STEP), ромб портала со стрелкой читается в углу комнаты и не лезет на значок содержимого, буква заглушки по центру круга, строка под картой меняется при наведении, клик по порталу переносит на слой и рамка видна; терминал подсвечивается обводкой целиком и подсказка «Карта комплекса» появляется у экрана, а не в стороне; без улучшения — строка «Нет связи с Архитектором», курсор после закрытия снова захвачен.
  • Шторка загрузки (UI_LoadingScreen, «Новая игра», «Загрузить» и «Возродиться»): после смены сцены шторка видна с первого кадра мира, строка «Комплекс перестраивается…» дышит, а не стоит (стоит только на спавне слоя, доли секунды); Esc до конца загрузки паузу не открывает; шторка гаснет без рывка за ней — первый кадр слоя должен пройти под ней. Снять в профайлере, что generate_run больше не в кадре входа. Переход порталом: F6/F7 оверлея идут тем же путём, F2 меняет вид — затемнение и шторка. В обоих: рывка нет, душа после перехода стоит у портала, а не падает; на затемнении экран не остаётся чёрным; выход в меню из паузы и побег — без пустоты под меню, пункт бежит штрихом.
  • Экран смерти / итогов забега — тема assets/ui/default_theme.tres применилась (не белые Control без стилизации — признак дублирующего theme = ExtResource(...) в сцене): заголовок прописными с эхом, строки «показатель ···· значение», по фону точки поднимаются вверх; на «Возродиться» штрих под кнопкой бежит, пока строится забег.
  • Меню «Отголосок» (главное, пауза, настройки) — наведение мышью даёт эхо и бледный штрих, стрелка с клавиатуры ставит фокус (точка души слева, штрих в полную силу) и отличается от наведения; экран входит проявлением, а не скачком, и гаснет при закрытии; под паузой мир размыт и обесцвечен, а не закрыт панелью; «Сохранить» отвечает на себе «Сохранено» со значком; «Загрузить» без сейва недоступна и подписана «нет сохранений». Английский (TranslationServer.set_locale("en")) не ломает ни одной строки.
  • Сцена за главным меню (инкубатор, menu_scene_check сверяет числа) — колба справа, меню слева не спорит с ней; свечение колбы живое, но не пульсирует заметным ритмом; лампа в глубине мигает сериями и комната проступает только во вспышку; собака над телом читается и сквозь размытие; кровь видна, а другого красного в кадре нет; камера дышит, а не плывёт. Мозг и пузырьки видны сквозь стекло с толщиной и не вылетают над крышкой — пропали, значит пузырьки снова стали прозрачными (§8 спеки). Снять кадровое время: объёмный туман, SDFGI и глубина резкости в меню включены одновременно.
  • Меню настроек — открыть обоими входами: из главного меню и из паузы. Вкладки выглядят вкладками (стили TabContainer берутся из темы, headless их не рисует), переключение не дёргает размер панели, «Отмена» возвращает туда, откуда пришли, а курсор после закрытия ведёт себя по правилам UIManager. Ребайнд щупать именно здесь: ловля нажатия идёт в _input, и Esc обязан отменять захват клавиши, а не закрывать экран.
  • Яркость и эффекты освещения — числа сверяет settings_menu_check, а картинку только глаз. В тёмном углу комнаты подвигать «Яркость»: тьма без лампы светлеет, а освещённое лампой не меняется (кривая поднимает только то, что ниже колена), пересветы у ламп не выгорают в плоское белое. Экран калибровки (удалить user://settings.tres или снять в нём brightness_calibrated — и запустить главное меню; второй вход — «Калибровка яркости» в настройках): на своём мониторе найти положение, где левый знак виден, средний едва виден, а правый нет, — и проверить на L4 в тёмном закоулке без лампы, что стены при этой яркости тоже «едва видны», а комнаты с лампами не пересвечены; при перекрутке правый знак проступает. «Эффекты освещения» по ступеням: «Низкие» дают затенение в стыках пола и стен, «Средние» — подкраску соседних стен светом ламп, «Высокие» — отражения на глянце, «Ультра» — отражённый свет от стен вне кадра (SDFGI); снять кадровое время на каждой. На «Ультра» тёмный угол без лампы темнее, чем на «Высоких», а на стенах пятна засветов — это известно (14.10: SDFGI вытесняет фоновый свет слоя и течёт сквозь стены без толщины) и ждёт толстых стен; после их пересборки сравнить снова. После портала отражённый свет не должен «помнить» стены прошлого слоя. Туман: в длинном коридоре дальний конец растворяется в темноте, а не обрывается погасшими лампами, и граница не «прыгает» при смене ступени теней.
  • Свет по глубине (data/depth_lighting.tres) — пройти телепортом оверлея (F6/F7) все слои при яркости 100 %: у поверхности (слой 0) заметно светлее, чем на дне (слой 4), и каждый шаг вглубь читается темнее; на дне стены вне пятна лампы — тёмно-синие очертания, а не ровная чернота; провалы погасших ламп коридора читаются участками без света, а не дырой в мире, и выход из такого участка видно; углы не залиты плоским светом (SSAO на месте); туман: на L0 дымки нет вовсе, на L1 она едва заметна и только вдали, глубже — дальний конец коридора уходит в почти чёрную темноту. Плафоны: цепочка светящихся панелей читается в тёмном коридоре, тросик упирается в потолок, а не висит в воздухе и не торчит сквозь него, у погасшей лампы плафон тёмный; в виварии панель не выжигает кадр. Свечение души: вне тела сиреневое пятно вокруг, во плоти янтарное, перетекает за четверть секунды вместе с дугой; на спокойном запасе ровное, у порога распада тускнеет; у стены не засвечивает заметно соседнюю комнату.

Границы

  • Не переписывать/расширять dev/corridor_graph_check.gd или dev/body_traits_check.gd мимоходом, в рутинном прогоне — это тестовые сценарии проекта, их правка (новые ассерты, новые инварианты) отдельная задача с собственным ревью, не рутинный прогон.
  • Не считать headless OK подтверждением фичи целиком — это подтверждение инварианта, который проверяет конкретный сценарий, не больше.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.