docs: make project documentation self-contained
This commit is contained in:
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user