docs: simplify verification workflow
This commit is contained in:
@@ -12,17 +12,8 @@
|
||||
- Команда, читающая или изменяющая change, всегда получает `--store wealth-ledger-specs`; cwd и nearest-root discovery не выбирают authority проекта.
|
||||
- Versioned framework-specific planning artifacts вне `specs/openspec`, включая `superpowers/plans`, запрещены. `references/**` остаётся read-only исключением.
|
||||
|
||||
Exact поддерживаемая OpenSpec CLI version хранится в `specs/openspec/.cli-version`. Перед project-owned операциями выполняется:
|
||||
|
||||
```bash
|
||||
bash specs/scripts/verify-openspec-version.sh
|
||||
```
|
||||
|
||||
Несовпадение version блокирует операцию до чтения или изменения store.
|
||||
Публикация новой stable версии не меняет этот contract автоматически. Upgrade
|
||||
выполняется отдельным SDD change после staged проверки schema, instructions,
|
||||
agent workflow, store resolution и hard blockers; historical archives
|
||||
не переписываются.
|
||||
Native OpenSpec CLI валидирует schema, changes и main specs с явным store;
|
||||
historical archives не переписываются.
|
||||
|
||||
## Project-local schema
|
||||
|
||||
@@ -45,19 +36,8 @@ Delta Spec template является operation-neutral comment guide. Он пе
|
||||
`ADDED`, `MODIFIED`, `REMOVED` и `RENAMED`, но не создаёт активную operation
|
||||
section. Автор добавляет только применимые sections и не оставляет пустых.
|
||||
|
||||
До запроса approval выполняется доступная stage-aware проверка:
|
||||
|
||||
```bash
|
||||
bash specs/scripts/verify-openspec-planning.sh <change>
|
||||
```
|
||||
|
||||
Proposal проверяется без ложного объявления полного change success; по мере
|
||||
появления Specs, Design и Tasks добавляются strict validation, Delivery Map,
|
||||
rollback, area ownership и exact Requirement coverage. Planning result имеет
|
||||
три категории: `artifact-validation` (exit 1), `invocation` (exit 2) и
|
||||
`environment` (exit 3). Только первая разрешает менять проверяемый planning
|
||||
artifact; две остальные требуют исправить invocation или prerequisite.
|
||||
Structural success не означает approval.
|
||||
Structural validation выполняется native OpenSpec CLI с
|
||||
`--store wealth-ledger-specs` и не означает approval.
|
||||
|
||||
Project-local schema проверяется из `specs`:
|
||||
|
||||
@@ -104,15 +84,13 @@ version preflight, permissive archive, conditional store selection и второ
|
||||
|
||||
## Реализация и проверка change
|
||||
|
||||
Design содержит Delivery Map для `frontend`, `backend`, `specs` и `docs`. Из workspace один non-mutating dispatcher проверяет карту и запускает canonical gates affected areas:
|
||||
Design содержит Delivery Map для `frontend`, `backend`, `specs` и `docs`.
|
||||
Перед archive canonical gates каждого affected repository выполняются по одному
|
||||
разу. `specs` проверяется всегда native strict validation. При required
|
||||
`runtime-openapi` запускают backend `npm run test:openapi-contract`; этот status
|
||||
допустим лишь при affected frontend и backend.
|
||||
|
||||
```bash
|
||||
bash specs/scripts/verify-workspace-change.sh <change>
|
||||
```
|
||||
|
||||
`specs` проверяется всегда. Dispatcher читает явный Contract Gate Decision из Design и сравнивает backend runtime OpenAPI с committed frontend snapshot только при `runtime-openapi: required`; этот status допустим лишь при affected frontend и backend. Child failure блокирует общий результат; fallback и auto-fix отсутствуют.
|
||||
|
||||
Перед affected-area gates dispatcher повторяет planning verifier. Tasks имеют
|
||||
Tasks имеют
|
||||
формат `X.Y [area] action` и indented `Covers`/`Verification`; каждый Delta
|
||||
Requirement покрывается точной ссылкой хотя бы один раз, а `workspace` остаётся
|
||||
только owner orchestration/verification. Для `N/A` verifier отклоняет пустой,
|
||||
@@ -126,14 +104,15 @@ affected areas. Второй context mapping не поддерживается.
|
||||
table alignment; Requirement, Scenario, architecture и planned Verification
|
||||
являются semantic changes.
|
||||
|
||||
Перед archive отдельно подтверждаются structural и semantic gates:
|
||||
Перед archive отдельно подтверждаются native structural и semantic gates:
|
||||
|
||||
```bash
|
||||
bash specs/scripts/verify-openspec-authority.sh
|
||||
openspec validate <change> --type change --strict --store wealth-ledger-specs
|
||||
openspec validate --specs --strict --store wealth-ledger-specs
|
||||
```
|
||||
|
||||
Structural success не доказывает соответствие реализации. Project-owned verify workflow сопоставляет реализацию с Proposal, Delta Specs, Design и Tasks, затем требует independent read-only review без Critical и Important findings.
|
||||
Structural success не доказывает соответствие реализации. Semantic verification
|
||||
сопоставляет реализацию с Proposal, Delta Specs, Design и Tasks, затем требуется
|
||||
independent read-only review без Critical и Important findings.
|
||||
|
||||
Archive отклоняется при незавершённом artifact approval, unchecked task, failed affected-area gate, отсутствующей semantic verification или independent review. Confirmation override для этих условий отсутствует. Completion Evidence создаётся только после archive и delivery commits по двухфазному протоколу [Engineering governance](engineering-governance.md); final evidence commit не подменяется незакрытым task.
|
||||
|
||||
Reference in New Issue
Block a user