docs: make project documentation self-contained

This commit is contained in:
2026-09-12 13:09:37 +03:00
parent aa9afc15e4
commit 3a99af1a6e
36 changed files with 1006 additions and 703 deletions
+17 -27
View File
@@ -1,35 +1,25 @@
# OpenSpec: optional legacy workflow
# OpenSpec: роль требований и история процесса
Обязательный SDD lifecycle отменён для обычной разработки. Текущие правила —
[engineering governance](engineering-governance.md),
[context discipline](agent-token-efficiency.md) и root/local AGENTS.
Задача пользователя не требует Proposal/Delta/Design/Tasks, отдельных agent roles,
Completion Evidence или archive как условия завершения.
Обязательный SDD lifecycle отменён для обычной разработки согласно
[ADR 012](../adr/012-task-driven-development-with-scoped-context.md).
Задача пользователя определяет ожидаемый результат; дополнительные planning
artifacts и архивирование не являются условием её завершения.
## Существующие материалы
`specs/openspec` сохраняет behavioral specs, active changes, schemas и archives.
Существующий planning artifact описывает только свой прежний scope и не доказывает
готовность нового запроса. Датированные evidence/archives не переписываются.
Нужную behavioral spec выбирай через [specs index](../../specs/AI_INDEX.md).
OpenSpec сохраняет поведенческие требования, предложенные изменения и историю
согласования. Существующее описание изменения относится только к своему объёму
и не доказывает готовность другой возможности. Текущее поведение системы
объясняется в [карте возможностей](../features/README.md).
## Если OpenSpec запрошен явно
Canonical store прежнего workflow — `wealth-ledger-specs`, физически
`specs/openspec`. Перед Node-командами выбери frontend `.nvmrc`, если у specs
нет своей. Для чтения/изменения change всегда задавай store явно:
OpenSpec остаётся необязательным средством согласования требований, дизайна
и задач. Его собственная модель определяет состав и порядок артефактов;
подтверждение человеком и смысловая проверка результата не выводятся из
одного наличия файлов. Обновление требований и архивирование меняют историю,
поэтому относятся к явно выбранной работе с этой историей.
```bash
openspec status --change <change> --json --store wealth-ledger-specs
openspec instructions <artifact> --change <change> --json --store wealth-ledger-specs
```
Native status/instructions определяют фактические artifacts и schema. Получай
разрешение на именно запрошенное изменение, не выводи approval из наличия файлов.
Sync/archive меняют existing specs/history и выполняются только в рамках такой
явной задачи, после проверки ожидаемого semantic diff и сохранности данных.
Structural validation не доказывает соответствие реализации задаче.
Прежнее rationale — [ADR 010](../adr/010-native-openspec-sdd-and-local-orchestration.md)
и [011](../adr/011-native-openspec-lifecycle-with-repository-gates.md);
текущий выбор прямой работы — [ADR 012](../adr/012-task-driven-development-with-scoped-context.md).
Причины прежнего процесса и его упрощения сохранены в
[ADR 010](../adr/010-native-openspec-sdd-and-local-orchestration.md) и
[ADR 011](../adr/011-native-openspec-lifecycle-with-repository-gates.md).