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
@@ -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).
Эти материалы отражают последующее упрощение процесса, а не восстанавливают
обязательность исторической процедуры.