# AGENTS.md — точка входа для ИИ-агента (инструменто-нейтральная)

> Единственная точка входа. Чужие конфиг-каталоги инструментов не заводить
> (`gotcha-two-agent-configs`). Здесь — только то, что нужно КАЖДУЮ сессию (IV.6).

## Перед работой (всегда)

1. Прочитай `prestart-litany.md` (раздел VI — постоянный чеклист),
   `docs/PROJECT_STATE.md`, `docs/INTERFACES.md`, актуальный `docs/plans/`,
   свежие `docs/decisions/`.
2. Сверь статусы плана с фактическим кодом (`gotcha-phantom-tails`).
3. Контекст-экономия: большие файлы — поиск → чтение диапазона, не целиком.

## Module Map

| Путь               | Назначение                           | Ключевые сущности                             |
| ------------------ | ------------------------------------ | --------------------------------------------- |
| packages/core      | Движок правил Го, чистый TS, без DOM | позиция, группы, SGF, история (этап 1)        |
| docs/              | Состояние, контракты, ADR, планы     | PROJECT_STATE, INTERFACES, decisions/, plans/ |
| prestart-litany.md | Методология (read-only архив)        | грабли — слагами                              |

## Гейты (hard, блокирующие)

`npm run gates` = format:check + lint + typecheck (tsc -b --noEmit) + test (vitest).
Провал: стоп, показать гейт и полный stderr, не чинить молча, не коммитить поверх
красного. Обход по явной команде владельца — `NOTE: committed with failing <gate>`
в тело коммита.

## Опасные команды (только после письменного «да», одно «да» = одно действие)

rm -rf, reset --hard, force-push, git checkout -- с потерей правок, git clean -f,
удаление файлов вне зоны задания, push тега (отдельное «да» каждый раз).
Escape-вектора не использовать: `cd x && git push`, `sh -c`, `eval`, pipe через xargs.

## Правила сессии (кратко; полные — в мастер-промпте)

- Зона работы — только файлы задания; чужой код не рефакторить.
- Контракты: сначала запись в docs/INTERFACES.md, потом код.
- Отложенное — письменно в момент откладывания (`gotcha-silent-later`).
- Плейсхолдеры помечать (TODO владельцу + «?»).
- Всё общение и документация — на русском; идентификаторы кода не переводить.
- Бамп версии — только по явной команде; SoT версии — корневой package.json.

## Ритуал закрытия (триггер «закрываем сессию»)

git log + git status → свести: модуль → docs + Module Map; решение → ADR;
отложенное → письменно; если сводить нечего — сказать явно. Отдельный
docs(sync)-коммит. Отчёт для следующей сессии — обязателен.