docs(ai): adopt task-driven scoped context

This commit is contained in:
2026-09-09 16:23:11 +03:00
parent 7166ee51d1
commit b7a56b1eb5
17 changed files with 502 additions and 676 deletions
@@ -4,6 +4,21 @@ status: accepted
# Native OpenSpec SDD и минимальная local orchestration
## Статус: историческое решение
[ADR 012](012-task-driven-development-with-scoped-context.md) отменяет обязательный
SDD lifecycle. Native OpenSpec остаётся optional инструментом; repo gates сохраняются.
### Прежняя частичная замена
[ADR 011](011-native-openspec-lifecycle-with-repository-gates.md) заменяет части
этого решения о schema v3, custom verifiers и dispatcher. Выбор native OpenSpec,
независимых repository gates и исходное rationale сохраняются. Ниже оставлено
историческое описание прежней реализации; действующую процедуру определяют
authorities, указанные в ADR 011. Version contract этим уточнением не меняется.
## Исторический контекст и решение
WealthLedger использует project-local schema `wealth-ledger-sdd` version 3 с
последовательностью `Proposal → Delta Specs → Design → Tasks → Apply`, один exact
OpenSpec CLI contract из `.cli-version` и тонкие non-mutating verifiers. Это
@@ -20,7 +35,7 @@ monorepo control plane для четырёх независимых Git-репо
agent entrypoints отклонены для текущего масштаба: они добавляют отдельный
projection lifecycle поверх уже достаточных schema, docs и scripts.
## Последствия
## Исторические последствия
OpenSpec CLI закреплён exact version contract; новая stable release не включает
auto-upgrade, а смена contract является отдельным SDD change со staged
@@ -0,0 +1,52 @@
---
status: superseded
---
# Native OpenSpec lifecycle и repository gates
Обязательность описанной ниже процедуры заменена
[ADR 012](012-task-driven-development-with-scoped-context.md). Текст сохраняет
историческое решение; current policy — прямая работа по задаче.
## Контекст
[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 направляют к ней.
Отслеживаемый [`.cli-version`](../../specs/openspec/.cli-version) существует и
содержит `1.10.0`. Версия schema и CLI contract — разные сведения. Наличие этого
файла не доказывает запуск прежних verifiers; это решение не меняет CLI pin,
version contract, schema или требования к tooling.
## Решение
Частично заменить ADR 010 в части прежней schema version и orchestration.
Canonical SDD store остаётся `wealth-ledger-specs` в `specs/openspec`.
Действующая процедура принадлежит существующим owners:
- [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 сохраняют описание своего времени.
Structural success не подтверждает решение Change Owner, semantic compliance
или независимый PASS. Approval bindings, полный применимый context/Design
package, независимая Validation и отдельная Finalization сохраняются.
Замена orchestration не ослабляет gates и не разрешает изменение незатронутых
main-spec requirements о tooling.
@@ -0,0 +1,33 @@
# 012. Прямая разработка с контекстом по задаче
**Status:** Accepted; supersedes обязательный lifecycle из ADR 010/011.
## Context
Обязательная цепочка OpenSpec artifacts не обеспечила соответствие исходному
намерению: суженный change мог пройти все проверки, оставив backend и основные
рекомендации исследований вне реализации. Владелец проекта выбрал прямую
разработку без обязательного OpenSpec/SDD.
## Decision
Задача пользователя определяет результат. Root/local AGENTS задают короткий
рабочий процесс; CONVENTIONS выбирает темы; SOURCES и docs/specs indexes указывают
точных владельцев фактов. Frontend/backend guides содержат решения, безопасные
пути, exceptions и реальные примеры. Общие rules и contract workflow не дублируются.
[Engineering governance](../development/engineering-governance.md) и
[context discipline](../development/agent-token-efficiency.md) описывают текущую
работу. Repo gates, trust-boundary checks, migration safety и semantic review
сохраняются. OpenSpec используется только по явному запросу; history сохраняется.
## Consequences
Обычная задача не требует planning artifacts, role handoffs, approval fingerprints
и archive. Сложные public/security/data решения уточняются по существу до опасной
операции. Правильность routing проверяется на задачах и counterexamples; качество
агента оценивается по наблюдаемым outcomes, а не по числу файлов или checkboxes.
Имена файлов и примерные context budgets из исследований адаптируются к
WealthLedger: FSD без widgets, Nest как OpenAPI source, существующие локальные
gates. Новые services, CI и checkers ради context architecture не добавляются.
+3 -1
View File
@@ -11,4 +11,6 @@
- [007 — React Query fetch policy](007-react-query-fetch-policy.md)
- [008 — Pino backend logging](008-pino-backend-logging.md)
- [009 — Concurrent refresh rotation policy](009-concurrent-refresh-rotation-policy.md)
- [010 — Native OpenSpec SDD и local orchestration](010-native-openspec-sdd-and-local-orchestration.md)
- [010 — Native OpenSpec SDD и local orchestration](010-native-openspec-sdd-and-local-orchestration.md) — исторический; частично заменён ADR 011, обязательность SDD отменена ADR 012.
- [011 — Native OpenSpec lifecycle и repository gates](011-native-openspec-lifecycle-with-repository-gates.md) — заменён ADR 012 в части обязательного lifecycle.
- [012 — Прямая разработка с контекстом по задаче](012-task-driven-development-with-scoped-context.md)