docs: make specs instructions self-contained

2026-09-15 20:45:41 +03:00
parent 9e227a563d
commit e4f10dedef
4 changed files with 51 additions and 18 deletions
@@ -7,20 +7,20 @@

 Если нужна существующая behavioral spec, выбери точный target через
 [AI_INDEX](AI_INDEX.md). Specs не являются вторым editable HTTP OpenAPI:
-backend публикует контракт, а frontend доверяет предоставленному snapshot и
-локально проверяет generated types; flow описан в
-[docs](../docs/architecture/http-api.md#источник-контракта).
+HTTP-провайдер публикует контракт, а потребитель получает отдельный artifact
+и локально проверяет generated types. Specs фиксируют behavioral requirements;
+другие checkout не нужны для чтения и native validation этого store.

 Архивы и чужие active changes сохраняй. Для правки индекса проверь targets,
 anchors и `git diff --check`; application gates принадлежат affected repos.
 Если явно запрошена работа через OpenSpec, следуй
 [локальным инструкциям OpenSpec](README.md#начало-работы)
-и используй store `wealth-ledger-specs`. Перед Node-командами выбери frontend
-`.nvmrc` через `nvm use --silent`, если здесь нет своей.
+и используй store `wealth-ledger-specs`. Перед Node-командами активируй
+местную `.nvmrc` через `nvm use --silent`.

 ## Ветки и релизы

 Работа — в отдельной ветке от `develop`, затем PR в `develop`; в `main` напрямую
-не пушить. Release/hotfix и синхронизация веток — по [root README](../README.md#релизы-и-ветки).
+не пушить. Release/hotfix и синхронизация веток — по [README](README.md#релизы).
 Commits и заголовки PR — Conventional Commits; для спецификаций допустим `spec:`.
-Перед подготовкой релиза прочитай root README; версии вручную не повышать.
+Перед подготовкой релиза прочитай местный README; версии вручную не повышать.