docs(ai): archive superseded context routing plan
This commit is contained in:
@@ -1,43 +1,18 @@
|
||||
# Specs
|
||||
|
||||
## Назначение и authority
|
||||
Репозиторий содержит существующие behavioral specifications и SDD history.
|
||||
Для обычной разработки не создавай и не обновляй planning artifacts ради
|
||||
процесса. Требование пользователя определяет работу; OpenSpec применяется
|
||||
только по явному запросу.
|
||||
|
||||
Этот репозиторий — единственный versioned authority для change artifacts.
|
||||
Workspace layout и reference policy — в root `AGENTS.md`.
|
||||
Если нужна существующая behavioral spec, выбери точный target через
|
||||
[AI_INDEX](AI_INDEX.md). Specs не являются вторым editable HTTP OpenAPI:
|
||||
его authority — backend runtime document; workflow находится в
|
||||
[docs](../docs/development/runtime-openapi-verification.md).
|
||||
|
||||
Canonical OpenSpec store — `wealth-ledger-specs`, физический root от workspace —
|
||||
`specs/openspec` (локально `openspec`). OpenSpec commands, читающие или
|
||||
изменяющие change, всегда получают `--store wealth-ledger-specs`.
|
||||
|
||||
Proposal, Delta Specs, Design, Tasks, changes, Completion Evidence и archives
|
||||
хранятся в `openspec`; `docs` владеет as-built документацией и общей policy.
|
||||
|
||||
## Workflow и verification
|
||||
|
||||
Новые changes используют project-local schema `wealth-ledger-sdd`.
|
||||
Для planning, implementation, validation и завершения читай canonical lifecycle:
|
||||
[`../docs/development/openspec-authority-and-lifecycle.md`](../docs/development/openspec-authority-and-lifecycle.md).
|
||||
|
||||
Сначала определить current stage и capability paths через native OpenSpec
|
||||
instruction; читать main specs и supporting docs только для этих paths и
|
||||
affected areas. Recovery и выбор relevant evidence определяет context discipline
|
||||
из [`../docs/development/agent-token-efficiency.md`](../docs/development/agent-token-efficiency.md),
|
||||
а не дублируется в schema instructions.
|
||||
|
||||
Для structural validation из `specs`:
|
||||
|
||||
```bash
|
||||
openspec schema validate wealth-ledger-sdd --verbose
|
||||
openspec validate <change> --type change --strict --store wealth-ledger-specs
|
||||
openspec validate --specs --strict --store wealth-ledger-specs
|
||||
```
|
||||
|
||||
Под Node 22: если локальной `.nvmrc` нет, активировать frontend `.nvmrc`
|
||||
через `nvm use --silent` до перехода в specs. Native structural gate проверяет
|
||||
форму; terminal safeguards определяет canonical lifecycle, доступный без skills.
|
||||
|
||||
## Boundaries
|
||||
|
||||
- Design содержит Delivery Map `frontend`, `backend`, `specs`, `docs` и условный Solution Assessment.
|
||||
- Specs описывают observable behavior, не изменения кода; Design — architecture, не line-by-line implementation; Tasks — implementation checklist без будущего evidence.
|
||||
- Application code и durable ADR принадлежат affected application/docs repos.
|
||||
Архивы и чужие active changes сохраняй. Для правки индекса проверь targets,
|
||||
anchors и `git diff --check`; application gates принадлежат affected repos.
|
||||
Если явно запрошена работа через OpenSpec, следуй
|
||||
[optional lifecycle](../docs/development/openspec-authority-and-lifecycle.md)
|
||||
и используй store `wealth-ledger-specs`. Перед Node-командами выбери frontend
|
||||
`.nvmrc` через `nvm use --silent`, если здесь нет своей.
|
||||
|
||||
Reference in New Issue
Block a user