docs(specs): start token-efficient agent pilot

2026-08-26 16:43:52 +03:00
parent 9a8687feda
commit 0b48b50f4a
7 changed files with 443 additions and 0 deletions
@@ -0,0 +1,60 @@
+## 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.