docs: make project documentation self-contained
This commit is contained in:
@@ -13,40 +13,46 @@ status: superseded
|
||||
[ADR 010](010-native-openspec-sdd-and-local-orchestration.md) сохраняет rationale
|
||||
выбора native OpenSpec и независимых repository gates. Его описание schema v3,
|
||||
custom authority/planning verifiers и dispatcher относится к прежней реализации.
|
||||
Текущая project-local [schema wealth-ledger-sdd](../../specs/openspec/schemas/wealth-ledger-sdd/schema.yaml)
|
||||
имеет version 5 и граф `Proposal → Delta Specs → Design → Tasks → Apply`.
|
||||
Native instructions и общие authorities уже определяют действующую процедуру;
|
||||
optional entrypoints направляют к ней.
|
||||
На момент решения проектная schema `wealth-ledger-sdd`
|
||||
имела version 5 и граф `Proposal → Delta Specs → Design → Tasks → Apply`.
|
||||
Порядок работы определялся средствами OpenSpec и общими правилами проекта;
|
||||
дополнительные точки входа служили навигацией по единой процедуре.
|
||||
|
||||
Отслеживаемый [`.cli-version`](../../specs/openspec/.cli-version) существует и
|
||||
содержит `1.10.0`. Версия schema и CLI contract — разные сведения. Наличие этого
|
||||
файла не доказывает запуск прежних verifiers; это решение не меняет CLI pin,
|
||||
Версия OpenSpec CLI была зафиксирована как `1.10.0`.
|
||||
Версия schema и CLI contract — разные сведения. Фиксация версии
|
||||
не доказывает запуск прежних проверок; это решение не меняет CLI pin,
|
||||
version contract, schema или требования к tooling.
|
||||
|
||||
## Решение
|
||||
|
||||
Частично заменить ADR 010 в части прежней schema version и orchestration.
|
||||
Canonical SDD store остаётся `wealth-ledger-specs` в `specs/openspec`.
|
||||
Действующая процедура принадлежит существующим owners:
|
||||
Единым хранилищем согласования оставался `wealth-ledger-specs`.
|
||||
Процедура разделяла следующие ответственности:
|
||||
|
||||
- [Engineering governance](../development/engineering-governance.md) — роли, отдельные approvals, Delivery Map, обязательность проверок и completion safeguards.
|
||||
- [OpenSpec lifecycle](../development/openspec-authority-and-lifecycle.md) — native planning/apply, strict structural validation, semantic sync и completion procedure.
|
||||
- [Context discipline](../development/agent-token-efficiency.md) — выбор и повторная сверка inputs, fingerprints, recovery и evidence reuse.
|
||||
- Согласование ролей, подтверждений, объёма поставки и обязательных проверок.
|
||||
- Планирование и применение изменений, структурную проверку и смысловое согласование требований.
|
||||
- Выбор и повторную сверку исходных знаний, восстановление контекста и повторное использование свидетельств.
|
||||
|
||||
Native OpenSpec получает structure и contextFiles текущего artifact или Apply.
|
||||
Каждый affected repository владеет своим gate через local AGENTS. Выполнение
|
||||
Каждое изменяемое приложение владело своей проверкой качества. Выполнение
|
||||
процедуры не зависит от custom verifier, dispatcher, skill или session adapter;
|
||||
optional entrypoints остаются navigation, без второго workflow engine.
|
||||
|
||||
## Последствия
|
||||
|
||||
Агент и человек используют один актуальный lifecycle. Отдельный порядок команд
|
||||
в ADR не поддерживается: точные команды находятся у lifecycle и repository
|
||||
owners. Исходные альтернативы и rationale остаются в ADR 010; historical
|
||||
archives, audits и evidence сохраняют описание своего времени.
|
||||
Люди и автоматизированные инструменты следовали единой процедуре, а каждый
|
||||
репозиторий отвечал за собственные проверки. ADR фиксировал причину этого
|
||||
разделения ответственности. Исходные альтернативы и rationale остаются
|
||||
в ADR 010; historical archives, audits и evidence сохраняют описание своего времени.
|
||||
|
||||
Structural success не подтверждает решение Change Owner, semantic compliance
|
||||
или независимый PASS. Approval bindings, полный применимый context/Design
|
||||
package, независимая Validation и отдельная Finalization сохраняются.
|
||||
Замена orchestration не ослабляет gates и не разрешает изменение незатронутых
|
||||
main-spec requirements о tooling.
|
||||
|
||||
Текущие принципы сопровождения описаны в
|
||||
[engineering governance](../development/engineering-governance.md), роль
|
||||
сохранённых требований — в [OpenSpec](../development/openspec-authority-and-lifecycle.md).
|
||||
Эти материалы отражают последующее упрощение процесса, а не восстанавливают
|
||||
обязательность исторической процедуры.
|
||||
|
||||
Reference in New Issue
Block a user