ShiZa/go-learn
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
go-learn/AGENTS.md
sab.code.lab 1c85091186 chore: восстановление репозитория из снапшота v0.3.1 
Прежняя git-история утрачена при переносе проекта на машину владельца
(снапшот без .git). Хэши коммитов в docs/reports/* относятся к утраченной
истории.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 09:34:02 +02:00

3.6 KiB
Raw Permalink Blame History

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