Files
main/AGENTS.md
T
ksv741 2dc72255fe
Conventional commits / commits (pull_request) Successful in 10s
chore: establish engineering workflow (#27)
2026-10-12 09:19:58 +03:00

3.2 KiB

WealthLedger workspace

Root содержит workspace-навигацию и конфигурацию стандартных инструментов. Самописные скрипты не добавляются; CI выполняет только commitlint. frontend, backend, docs, specs — самостоятельные Git-репозитории. Root tracking ограничен allowlist; локальные данные и nested repos в него не добавляются. references/**, dated audits и архивы — read-only.

Инструкции root относятся только к root. Работа внутри другого репозитория начинается с его собственного AGENTS; он содержит все обязательные правила без наследования root conventions и без чтения соседних checkout. Публичные API artifacts передаются явно; CI каждого repo использует локальные входы. Справочные источники не становятся обязательной цепочкой инструкций.

До изменения проекта найди подходящую Gitea Issue (или создай после поиска), проверь Acceptance Criteria, scope и рабочую ветку. Чтение/анализ допускаются без Issue. Маршрут, выбор lightweight/SDD и cross-repo ссылки — в Engineering Workflow.

Начни с результата и affected areas. До edits проследи поведение/invariants, найди owner и 1–3 примера. Работай напрямую; OpenSpec/SDD — по явному запросу.

Root задача Прочитать
Helper/pattern, refactor, scope Code health
Dependency/tooling Dependencies, Guardrails
Нетривиальные tests Test Intent
Git/branch/commit/PR/tracking Git
Release/hotfix README

Перед Node-командой активируй местную .nvmrc: если nvm не загружен в non-interactive shell, загрузи установленный $HOME/.nvm/nvm.sh, затем выполни nvm use --silent из root. Если nvm.sh недоступен, остановись; не используй системный Node вместо проектного. При новой границе и перед завершением повтори routing по staged/unstaged/new files; сохраняй чужие изменения. Missing source/конфликт требований сообщи до зависимого решения. После diff выполни Boy Scout review и relevant gates. Запиши краткие команды, результаты и ограничения; lint не заменяет semantic review.