From adc369be79d1b4b4aad36168a8d32deab6568932 Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Fri, 28 Aug 2026 09:37:45 +0300 Subject: [PATCH] docs: remove useless --- AGENTS.md | 4 +- development/agent-token-efficiency.md | 79 +-------------------------- 2 files changed, 6 insertions(+), 77 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b64d280..99785a6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,7 +14,9 @@ Docs обновляется до фактического проверенног ## Canonical gate -Node 22 обязателен. После lockfile install: +Перед Node-командами активировать `.nvmrc` через `nvm use --silent`; это выбирает +Node 22. Не запускать отдельную проверку версии, кроме диагностики runtime issue. +После lockfile install: ```bash npm ci diff --git a/development/agent-token-efficiency.md b/development/agent-token-efficiency.md index e650677..86c95c9 100644 --- a/development/agent-token-efficiency.md +++ b/development/agent-token-efficiency.md @@ -12,9 +12,9 @@ Raw rollout logs не коммитятся. Числовой budget не бло отдельного утверждённого change, детерминированной non-mutating проверки и controlled positive/negative evidence. -Pilot `optimize-agent-token-workflow` завершён 27.08.2026. Guidance ниже -остаётся в силе как наблюдённая рабочая практика, но не повышается до hard -guardrail без отдельного evidence-backed change. +Guidance ниже остаётся non-blocking: он не заменяет required authority или +verification и не повышается до hard guardrail без отдельного evidence-backed +change. ## Routing context @@ -79,76 +79,3 @@ areas и unresolved failures. Полная история tool calls не пер Статический лимит строк или tool tokens не применяется: он может скрыть единственный диагностический сигнал. Compact output — способ убрать заведомо нерелевантный шум, а не обрезать доказательства. - -## Pilot result - -### Method - -Post-activation observations собирались в local non-authority dataset -`.agent-token-pilot.json` после завершённых фаз SDD. Каждое наблюдение -сохраняло change identity, phase type, краткий scope, context-depth indicators, -canonical-gate outcome, fix cycles, independent-review findings и итог попытки -без raw prompts, source contents или rollout logs в Git. - -### Scope - -- Период наблюдения: 26.08.2026-27.08.2026. -- Completed observations: `17`. -- Distinct changes: `5`. -- Covered phase groups: `proposal` (`4`), `specs` (`3`), `design` (`4`), - `tasks` (`4`), `apply-verify` (`2`). -- Interrupted attempts recorded: `0`. - -### Resource and quality outcomes - -- Все `17/17` completed observations завершились successful canonical gate. -- Совокупно зафиксировано `10` fix cycles; максимум на одно наблюдение: `4`. -- Independent review понадобился для двух `apply-verify` фаз и в обоих случаях - привёл к исправлению реального defect до terminal completion. -- После исправлений не осталось Critical или Important findings. - -### Confounders - -- Dataset охватывает разные phase types и неодинаковый scope, поэтому aggregate - не является строгим сравнением "одинаковая работа до/после". -- Для части ранних planning observations provider-counted cumulative input, - model calls и tool-output volume не были сохранены как числовые поля; pilot - опирается на phase outcome, context-depth indicators, gate success, fix cycles - и review findings. -- Наблюдение проходило на одном workspace и одном agent workflow; результат не - экстраполируется на другие инструменты, модели или quota contracts. - -### Verdict - -Stage- and area-first routing, evidence batching и compact successful command -summaries показали себя как полезное guidance: pilot превысил минимальный порог -в `10` завершённых фаз по `2` changes без ухудшения canonical gates, rework или -independent review outcomes. На наблюдённых данных guidance следует сохранить. -Числовой token budget остаётся non-blocking guidance, потому что pilot не дал -детерминированной локальной проверки и не изолировал сравнимые workloads -достаточно строго для hard guardrail. - -## Pilot protocol - -Pilot change `optimize-agent-token-workflow` завершился после 17 completed -post-activation SDD phases across 5 changes, превысив минимальный порог в 10 -завершённых фаз минимум по двум changes. Для каждой попытки local -non-authority dataset содержит: - -- change identity, phase type и краткий workload scope; -- cumulative input, model calls, context-depth indicators и tool-output volume; -- canonical-gate outcome, fix cycles и independent-review findings; -- completed или interrupted outcome и причину interruption. - -Interrupted attempts учитываются отдельно и не исчезают из quality assessment. -Raw prompts, source contents и rollout logs в Git не добавляются. -Рабочий dataset хранится локально в workspace root как -`.agent-token-pilot.json`; workspace root не является Git-репозиторием, а файл -не является planning, handoff или documentation authority. - -Сравнение выполняется внутри одинаковых phase types и близкого scope, когда это -возможно. Aggregate сопровождается ограничениями неоднородности. Снижение -resource usage считается улучшением только без ухудшения gate success, rework и -review findings. Итоговый versioned report публикует method, scope, aggregates, -confounders и verdict; он не экстраполирует quota или стоимость без provider -contract.