Files
main/AGENTS.md
T
ksv741 93dd5539ad
Workspace security / security (push) Successful in 7s
Workspace verify / verify (push) Successful in 20s
Workspace security / security (pull_request) Successful in 6s
Workspace verify / verify (pull_request) Successful in 20s
Conventional commits / commits (pull_request) Successful in 10s
docs: establish workspace engineering conventions
2026-09-15 05:42:02 +03:00

32 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# WealthLedger workspace
`frontend`, `backend`, `docs`, `specs` и root — независимые Git-репозитории.
Root tracking ограничен allowlist; локальные данные и nested repos в него
не добавляются. `references/**`, dated audits и архивы — read-only.
Структура/запуск — в [README](README.md).
Начни с результата задачи и affected areas. Прочитай local AGENTS затронутого
repo; проследи поведение/инварианты и найди owner с 1–3 примерами до реализации.
Код показывает механизм, а случайный аналог не переопределяет контракт.
Работай напрямую; OpenSpec/SDD lifecycle нужен только по явному запросу.
| Задача / граница | Прочитать |
| --- | --- |
| Frontend / backend | [Frontend](frontend/AGENTS.md) / [Backend](backend/AGENTS.md), затем только активированные темы |
| Docs / specs | [Docs AGENTS](docs/AGENTS.md) / [Specs AGENTS](specs/AGENTS.md) |
| Новая функция, неясное ожидание, межрепозиторное поведение | [Docs entry](docs/README.md) → нужная область/spec/ADR; локальный build/lint bug начинает с repo instructions/code |
| Новый helper/hook/wrapper/pattern, refactor, выбор scope | [Code health / change scope](.ai/conventions/code-health.md) |
| Dependency или tooling | [Dependencies](.ai/conventions/dependencies.md), [guardrails](.ai/conventions/guardrails.md) |
| Нетривиальные tests | [Test Intent](.ai/conventions/testing.md) и local Testing |
| Git, ветка, commit, PR, tracking | [Git](.ai/conventions/git.md) |
| Release/hotfix, main↔develop, release config/CI refs | [Release process](README.md#релизы-и-ветки) |
| Migration существующих conventions findings | [Audit/plan](.ai/migrations/conventions-v1/plan.md) |
Перед Node-командой активируй `.nvmrc` affected repo через `nvm use --silent`.
При новой границе и перед завершением повтори routing по staged/unstaged/new
files; сохраняй чужие изменения. Missing required source или конфликт требований
сообщи до зависимого решения. После code diff выполни
[Boy Scout review](.ai/conventions/code-health.md#boy-scout-review); проверь результат
по рискам и [relevant gates](.ai/conventions/guardrails.md#выбор-финального-gate).
Сохрани краткие команды/результаты и ограничения; успех lint не заменяет semantic review.