chore: восстановление репозитория из снапшота v0.3.1

Прежняя git-история утрачена при переносе проекта на машину владельца
(снапшот без .git). Хэши коммитов в docs/reports/* относятся к утраченной
истории.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
sab.code.lab 2026-08-07 09:34:02 +02:00
commit 1c85091186
184 changed files with 33303 additions and 0 deletions

48
AGENTS.md Normal file
View file

@ -0,0 +1,48 @@
# 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)-коммит. Отчёт для следующей сессии — обязателен.