5.8 KiB
ADDED Requirements
Requirement: Token-efficient execution сохраняет delivery evidence
Project-owned agent guidance SHALL направлять AI-агента к совместному получению независимых read-only evidence, targeted чтению найденных диапазонов, сужению diff по затронутым paths и компактному представлению успешных command results. Такая оптимизация MUST сохранять exit status, существенный observed outcome и всё evidence, необходимое для текущего решения, canonical gate, semantic verification или independent review. При failure, неоднозначности или существенном расхождении workflow SHALL расширить diagnostics соразмерно наблюдаемой проблеме. Предпочтения по batching и размеру output SHALL оставаться guidance и MUST NOT блокировать корректную delivery без отдельного детерминированного hard guardrail.
Scenario: Требуются несколько независимых read-only результатов
- WHEN агент до следующего смыслового решения заранее знает несколько независимых source, status или diff запросов
- THEN workflow направляет получить их одним evidence batch и вернуть только релевантные результаты без промежуточного model round-trip после каждого запроса
Scenario: Canonical gate проходит успешно
- WHEN обязательная verification command завершается успешно и её полный output не нужен для последующего смыслового решения
- THEN agent context сохраняет точную command identity, exit status и существенную итоговую summary без обязательного переноса полного verbose log
Scenario: Verification завершается ошибкой
- WHEN compact command result сообщает failure или не позволяет определить причину
- THEN workflow получает достаточные diagnostics для локализации ошибки и не скрывает необходимые failure details ради соблюдения output budget
Scenario: Independent review требует полный relevant diff
- WHEN reviewer должен проверить весь фактический scope реализации против утверждённых artifacts
- THEN token-efficient guidance не исключает relevant diff или evidence, необходимые для semantic conclusion
Requirement: Token-efficiency оценивается на завершённых фазах вместе с качеством
Token-efficiency pilot SHALL сравнивать resource usage на успешно завершённую SDD-фазу, включая cumulative input, количество model calls, глубину контекста и объём tool outputs, вместе с outcome indicators: результатами обязательных gates, количеством циклов исправления и findings independent review. Снижение resource usage MUST NOT считаться улучшением, если сопоставимая работа чаще не завершается, требует больше исправлений либо ухудшает verification или review outcomes. До накопления репрезентативных сопоставимых наблюдений числовые budgets SHALL оставаться guidance и MUST NOT становиться самостоятельным completion blocker.
Scenario: Resource usage снизился без ухудшения результата
- WHEN pilot показывает меньше cumulative input или model calls на сопоставимую завершённую фазу, а canonical gates, fix cycles и review findings не ухудшились
- THEN изменение может быть представлено Engineering Owner как наблюдаемое улучшение с указанным measurement scope и ограничениями
Scenario: Дешёвая фаза создаёт больше rework
- WHEN вариант workflow использует меньше токенов, но чаще получает failed gates, дополнительные fix cycles или более серьёзные review findings
- THEN pilot не представляет этот вариант как token-efficiency improvement
Scenario: Наблюдений недостаточно для обязательного порога
- WHEN pilot ещё не содержит репрезентативных сопоставимых завершённых фаз или надёжной локальной проверки
- THEN model-call, context-depth и tool-output budgets остаются guidance и не блокируют delivery
Scenario: Числовой budget предлагается как hard guardrail
- WHEN последующий change предлагает сделать token budget обязательным completion condition
- THEN он должен определить защищаемый риск, детерминированную non-mutating проверку и controlled compliant/violation evidence по общему contract Enforceable Engineering Invariant