41 lines
3.2 KiB
Markdown
41 lines
3.2 KiB
Markdown
# 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](.ai/conventions/engineering-workflow.md).
|
|
|
|
Начни с результата и affected areas. До edits проследи поведение/invariants,
|
|
найди owner и 1–3 примера. Работай напрямую; OpenSpec/SDD — по явному запросу.
|
|
|
|
| Root задача | Прочитать |
|
|
| --- | --- |
|
|
| Helper/pattern, refactor, scope | [Code health](.ai/conventions/code-health.md) |
|
|
| Dependency/tooling | [Dependencies](.ai/conventions/dependencies.md), [Guardrails](.ai/conventions/guardrails.md) |
|
|
| Нетривиальные tests | [Test Intent](.ai/conventions/testing.md) |
|
|
| Git/branch/commit/PR/tracking | [Git](.ai/conventions/git.md) |
|
|
| Release/hotfix | [README](README.md#релизы-и-ветки) |
|
|
|
|
Перед 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](.ai/conventions/code-health.md#boy-scout-review) и
|
|
[relevant gates](.ai/conventions/guardrails.md). Запиши краткие команды,
|
|
результаты и ограничения; lint не заменяет semantic review.
|