Работа с ИИ-ассистентом

Что ассистент узнаёт из проекта

AGENTS.md: Короткие правила в корне проекта; большинство ассистентов читают их сами.
CLAUDE.md: Те же правила для Claude Code, который читает этот файл.
node_modules/@racelink/overlay/docs/ai-guide.md: Полная версия: SDK на одном экране, правила данных, настройки, проверка и публикация. Укажите ассистенту на неё для всего, что больше мелкой правки.
docs/reference/fields.md: Все поля в той же папке, чтобы ассистент не угадывал пути.

Опишите задачу

Скажите, что должен видеть игрок, в каких играх и что можно настроить. Попросите проверить работу командами проекта:

Prompt

Сначала прочитай node_modules/@racelink/overlay/docs/ai-guide.md.

Сделай оверлей топлива: сколько литров осталось, на сколько кругов хватит
при текущем расходе, и предупреждение, если машина не доедет. Все игры.
Настройки: порог предупреждения в кругах (1..5, по умолчанию 2), литры или галлоны.

В конце запусти npm run build и npm run validate и скажи, что открыть,
чтобы увидеть результат на демо-данных.

Проверьте результат

Откройте http://localhost:5173/?demo и попробуйте пару игр через ?demo=<игра>. Потом пройдитесь по списку — это самые частые ошибки ассистентов.

Перед публикацией

До ready ничего не рисуется, и первый кадр выглядит законченным.
Любое значение может быть null: на экране нет NaN и «undefined».
Страница прозрачная: нет фона у html/body, нет color-scheme.
Оверлей заполняет любой размер, который даст игрок.
Нет своих fetch и WebSocket, шрифтов и скриптов из интернета, если манифест не называет адреса.
Настройки менялись в racelink.overlay.json, а не в src/racelink-settings.ts.
npm run build и npm run validate проходят.