sab.code.lab
1c85091186
Прежняя git-история утрачена при переносе проекта на машину владельца (снапшот без .git). Хэши коммитов в docs/reports/* относятся к утраченной истории. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
48 lines
3.6 KiB
Markdown
48 lines
3.6 KiB
Markdown
# 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)-коммит. Отчёт для следующей сессии — обязателен.
|