Files
specs/openspec/changes/optimize-agent-token-workflow/proposal.md
T

61 lines
4.7 KiB
Markdown

## Why
Недавний аудит Codex-сессий показал, что основной расход лимитов WealthLedger
создаёт не генерация кода и не обязательные SDD-артефакты, а большое количество
последовательных model/tool циклов на уже разросшемся контексте. Полное чтение
нерелевантных документов, повторные широкие diff и logs, а также продолжение
нескольких SDD-фаз в одной длинной сессии многократно переносят накопленный
контекст без соразмерного прироста качества. Это повышает риск преждевременной
компакции и исчерпания лимита именно в поздних фазах реализации и проверки.
Процессу нужна измеримая token-efficient discipline, которая уменьшает
повторную передачу контекста, но сохраняет существующие authority, approval
gates, semantic verification и независимый review.
## What Changes
- Установить фазовые границы agent-сессий вокруг утверждённых SDD-артефактов,
чтобы следующая фаза продолжалась из canonical artifacts и явного решения
Change Owner, а не из полной истории обсуждения.
- Сделать загрузку проектного контекста целевой: сначала определять текущую
стадию и affected areas, затем читать только применимые authority и
релевантные диапазоны материалов.
- Сократить model/tool round-trips за счёт совместного получения независимых
evidence и компактного представления успешных command results, сохраняя
доступ к необходимым diagnostics при ошибке или семантической проверке.
- Провести pilot и сравнивать расход контекста на успешно завершённую SDD-фазу
вместе с качественными ограничителями: результатами canonical gates,
количеством циклов исправления и findings независимого review.
- Считать числовые budgets и пороги guidance до появления репрезентативных
данных и детерминированной локальной проверки; pilot не вводит новый hard
guardrail и не блокирует корректную работу только по объёму токенов.
Не входят в change: удаление или объединение SDD-стадий, ослабление owner
approvals, semantic verification, canonical gates или independent review;
создание параллельного handoff/planning artifact; изменение пользовательского
поведения frontend или backend; управление тарифами, quota, моделями или
системным контекстом Codex; запрет tools или subagents как класса; немедленное
введение обязательного token cap без результатов pilot.
## Capabilities
### New Capabilities
Нет.
### Modified Capabilities
- `openspec-authority-and-lifecycle`: сделать переход между SDD-фазами и
загрузку agent context целевыми, сохраняя canonical artifacts и явные
approval gates единственным основанием продолжения работы.
- `engineering-change-governance`: определить измеримую token-efficient
guidance и условия, при которых будущая рекомендация может стать
проверяемым hard guardrail без снижения качества поставки.
## Impact
Изменение затрагивает Engineering Owner и AI-агентов, которые планируют,
реализуют и проверяют WealthLedger changes. Оно меняет нормативный SDD workflow,
agent routing и as-built process documentation, но не изменяет frontend,
backend, пользовательское поведение, данные или runtime API contracts.