specs/openspec/changes/archive/2026-08-27-optimize-agent-token-workflow/tasks.md

1. Policy, routing и baseline

• 1.1 [docs] Сохранить исходный session-token audit как immutable dated snapshot, добавить его в audits index и создать lazy development playbook с routing matrix, handoff envelope, evidence-batching boundaries, failure expansion и pilot protocol без копирования OpenSpec artifacts
  • Covers: openspec-authority-and-lifecycle — Agent context следует текущей SDD-фазе; openspec-authority-and-lifecycle — Session handoff сохраняет approval boundary; engineering-change-governance — Token-efficient execution сохраняет delivery evidence; engineering-change-governance — Token-efficiency оценивается на завершённых фазах вместе с качеством
  • Verification: Сверить source/snapshot checksum и byte count, затем выполнить scoped review playbook против всех четырёх Requirements и проверить links обоих indexes.
• 1.2 [docs] Обновить engineering governance и OpenSpec lifecycle documentation до durable policy stage/area-first context, explicit approval handoff, guidance-only output budgets и quality-coupled pilot, оставив подробные операции в lazy playbook
  • Covers: openspec-authority-and-lifecycle — Agent context следует текущей SDD-фазе; openspec-authority-and-lifecycle — Session handoff сохраняет approval boundary; engineering-change-governance — Token-efficient execution сохраняет delivery evidence; engineering-change-governance — Token-efficiency оценивается на завершённых фазах вместе с качеством
  • Verification: Провести read-only ownership review updated policy, lifecycle и playbook и подтвердить одно authoritative место для каждого правила без blanket duplication.
• 1.3 [specs] Сделать specs-local agent routing stage-scoped и compact, сохранив fixed store, one-artifact approvals, current-stage instructions и conditional pointer к lazy playbook без встраивания подробного token guidance в каждый schema artifact
  • Covers: openspec-authority-and-lifecycle — Agent context следует текущей SDD-фазе; openspec-authority-and-lifecycle — Session handoff сохраняет approval boundary
  • Verification: Получить instructions Proposal, Specs, Design, Tasks и Apply из project schema, затем подтвердить current-stage authority, approval boundary, fixed store и отсутствие повторённого full playbook в prefix inputs.
• 1.4 [workspace] Заменить root blanket reads на compact stage/affected-area-first routing и conditional triggers для governance, architecture, domain и audit material, добавив короткий handoff и evidence-batching pointer без создания versioned workspace artifact
  • Covers: N/A — workspace root routing оркестрирует применение repository-owned policy и не является самостоятельным behavior contract или repository implementation.
  • Verification: На read-only routing matrix для scoped repository work, cross-area architecture, domain semantics, audit-derived work и failed verification подтвердить минимальный initial context и обязательную загрузку каждого relevant authority trigger.

2. Pilot observation и verdict

• 2.1 [workspace] Активировать approved guidance и собрать local non-authority dataset для 10 последующих завершённых SDD-фаз минимум по двум changes, отдельно учитывая interrupted attempts, phase/scope, input, model calls, context depth, tool output, gate outcome, fix cycles и review findings
  • Covers: N/A — workspace task собирает observation inputs для docs-owned pilot verdict и не подменяет repository-owned implementation Requirements.
  • Verification: Проверить 10 completed observations минимум для двух change identities, наличие всех resource/quality fields, отдельный перечень interrupted attempts и отсутствие raw rollout content в Git.
• 2.2 [docs] Опубликовать агрегированный pilot result с method, scope, comparable phase groups, resource и quality outcomes, confounders и verdict; обновить guidance только в пределах наблюдаемых данных и не продвигать numeric budget в hard guardrail
  • Covers: engineering-change-governance — Token-efficiency оценивается на завершённых фазах вместе с качеством
  • Verification: Пересчитать агрегаты из local pilot dataset, сопоставить verdict с gate/fix/review outcomes и проверить отсутствие unsupported quota, cost или causal claims.

3. Affected-area gates и итоговая проверка

• 3.1 [specs] Выполнить canonical specs checks для compact routing и полного planning change после завершения pilot
  • Covers: N/A — задача проверяет specs delivery уже покрытых lifecycle Requirements и не вводит самостоятельное observable behavior.
  • Verification: Запустить OpenSpec version preflight, schema validation, planning verifier, strict change validation, strict main-spec validation, authority verifier и git diff --check в specs.
• 3.2 [docs] Выполнить canonical docs gate и scoped проверку baseline snapshot, development indexes, policy/playbook links и pilot result
  • Covers: N/A — задача проверяет docs delivery уже покрытых Requirements и не создаёт новый behavior contract.
  • Verification: Запустить npm run verify в docs, подтвердить affected local links и повторно сверить immutable baseline checksum.
• 3.3 [workspace] Выполнить canonical cross-area dispatcher с Delivery Map specs/docs=affected, frontend/backend=N/A и Contract Gate runtime-openapi=N/A
  • Covers: N/A — workspace task оркестрирует affected-area gates и не подменяет repository-owned implementation.
  • Verification: Запустить bash specs/scripts/verify-workspace-change.sh optimize-agent-token-workflow и проверить наблюдаемый выбор только утверждённых affected areas и gates.
• 3.4 [workspace] Провести semantic verification реализации и pilot verdict против Proposal, всех 4 Delta Requirements, 14 Scenarios, Design и Tasks, затем independent read-only review без Critical или Important findings
  • Covers: N/A — terminal semantic verification и independent review проверяют change целиком, но не реализуют отдельный Requirement.
  • Verification: Зафиксировать observed coverage каждого Requirement/Scenario и устранить blocking findings до archive eligibility.