docs(ai): adopt task-driven scoped context
This commit is contained in:
@@ -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
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user