DB.FlowExp_WorkStatistics/dx-flow.md

Конвейер разработки на агентах: этап → исполнение → проверки (dx-flow)

ЖИВАЯ карточка процесса: совершенствуется ретроспективами (dx-retro-1), оценки приёмов пересматриваются по новой фактуре, дописывается доказательной базой следующих проектов. Первая доказательная база — Kit.RAG (2026-10-30…11-01: 3 дня, 90 коммитов, 39 workflow-прогонов ~0,7 млрд токенов, ~26 ревизий; гейт 104→607 монотонно, находки ревизий 53→1–2 low, ускорение модуль к модулю ×3–5). См. readme.md.

Цикл этапа (проверен на 3 модулях)

ТЗ этапа (/stage: «Среда и гейты» B1–B8 + RAG-темы с якорями)
  → ИСПОЛНЕНИЕ: субагенты-workflow параллельно по зонам (или агент напрямую)
  → ИНТЕГРАТОР: полный гейт (build+test решения), точечные — у исполнителей
  → РЕВИЗИЯ СВЕЖИМ КОНТЕКСТОМ: независимый агент без контекста исполнителя;
     сверяет код↔канон, якоря перепроверяет живым запросом (dx-dev-8),
     числа пересчитывает сам (руками/своим парсером)
  → ПРАВКИ по находкам (применить/отклонить с обоснованием)
  → КОНТРОЛЬНЫЙ ГЕЙТ (правки ничего не сломали)
  → КАСКАД статусов (одно место: readme модуля; plan — строка; handoff —
     хвосты/грабли) → GIT-КОММИТ (рецепт — в коммите этапа, B5/D3)

Роли проверок

Роль	Что проверяет	Ключевое свойство
Исполнитель	свою зону (точечные тесты)	не видит чужих зон
Интегратор	сборка целиком, швы (DI/slnx/фикстуры — dx-dev-3)	единственный полный гейт
Ревизор («проверка разработчиком со стороны» + «архитектором»)	код↔канон, псевдо-цитаты, якоря, числа	СВЕЖИЙ контекст — главный источник качества; ловил high, невидимые исполнителю
Главная сессия	эскалации/развилки, инциденты вне зон	решает владелец

Архитектурная проверка решений = протокол dx-dev-1 (до утверждения) + ревизия шага 0 (module_reqs/спеки как документы, B7).

Приёмы (оценки по ретроспективе Kit.RAG; пересматриваются)

Приём	Оценка	Комментарий
Ревизия свежим контекстом + контрольный гейт	ядро, не трогать	находки 53→1–2 low; ловила вне-зонные правки, псевдо-цитаты
Авточемод с эскалациями на развилках	высокоэффективно	темп ×3–5 без потери контуров контроля; вводить ПОСЛЕ обкатки конвейера
Workflow-исполнители этапов	высокоэффективно	цена: капы/redo-прогоны (6/39), кэш-переигрывания — лечится маркером «ТЗ vN»
Honest-skip вместо молчаливого пропуска	высоко	все skip'ы позже сняты живыми прогонами
TCP-стабы внешних сервисов + детерминированные векторы	высоко	приёмочные стабильны и доказательны, не зависят от живой LLM
docChanges-реестр → легализация одним Изм. на замыкании	высоко (клапан)	симптом дрейфа канона — следить за возрастом
Метрики замыкания с независимым пересчётом	высоко	«не замерено честно» — списком, не замалчивать
Повторные полные гейты ×3–4 на этап	условно	после введения файл-лока основания нет — точечные + контрольный
Дублирование статусов в 3+ документах	НЕ окупилось	~68% документационных коммитов; одно место + ссылки

Анти-паттерны (пережито, не повторять)

• Канон утверждается до схождения решений → смена курса после начала кода (Изм. 5: переделка этапа, 53 находки). Лечение: dx-dev-1 до утверждения.
• Вне-процессные правки «по ходу» с самовольной атрибуцией → откат, инцидент. Лечение: изменения — через записи канона/эскалации.
• Закрытый этап «доезжает» потом дважды. Лечение: замыкание = контрольный гейт + хвосты в handoff, не «потом».

Открытые хвосты (совершенствуется)

• Страж-навык d-proc-guard (авто-проверка чек-листа при генерации ТЗ) — решение на замыкании И4 по метрикам.
• Фильтр --tag env:* для search — среда из текста запроса в фильтр.
• Каноническая нарезка (чанк = законченная единица) — в очереди легализации; снимет и недетерминизм LLM-нарезки.
• Формы исполнения вне workflow (короткие этапы) — накопить фактуру.

Scorecard: оценки, по которым совершенствуется процесс

Механика влияния на знания. Замер (замыкание итерации, dx-retro-2) → светофор 🟢/🟡/🔴 → порог-триггер → изменение КОНКРЕТНОГО артефакта знаний (карточка _env / правило dx / приём в dx-flow / строка dx-map / наполнение дерева) → коммит std1-ext с указанием источника-замера → переиндексация корпуса. Если правило соблюдается, а метрика хуже цели — пересматривается ОЦЕНКА правила/приёма (понижается, хвост в «Открытых хвостах»). Правки знаний — только через ретроспективу (владелец в контуре утверждения), никогда «по ходу».

Фиксация. Замер — факт в отчёте замыкания итерации проекта (формат: итерация | метрика | значение | светофор | триггер | действие), не редактируется. Светофор и цели — здесь, с датой и источником. Действие — git-коммит std1-ext («ретроспектива ИN, метрика M»). Версионность — git: вся история правил и оценок = история коммитов; откат = git revert правки знаний с обоснованием; замеры-факты не откатываются; корпус пересобирается из git (индекс — производное, не версионируется).

Метрики (база / цель / триггер / текущий светофор 2026-11-02)

#	Метрика	База (И1/И2)	Цель	Триггер (порог действия)	Сейчас
А1	Находки ревизии/этап, медиана	~7 (пик 53) / ~2	≤2, high=0	high на этапе → усилить B-блок ТЗ и фокус ревизии	🟡 (И3-э1: 2 high)
А2	Псевдо-якоря/псевдо-цитаты	0 / 0 (И3-э1: 2)	0	>0 → приём в dx-flow + формулировка dx-dev-8	🟡
А3	Дефекты после замыкания этапа	И1: этап доезжал ×2	0	>0 → ужесточить замыкание (контрольный + хвосты в handoff)	🟡
А4	Повторы известных граблей	И2: 3 (кодировка/лок/байты)	0	1-й повтор → инструмент (dx-retro-3); 2-й → эскалация владельцу	🟡 (проверка И3: инструменты введены)
Б1	Доля документационных коммитов	~70% / ~56%	≤40%	>50% две итерации подряд → упрощать каскад (одно место статусов)	🟡
Б2	Redo-прогоны workflow/этап	4 / 2	≤1	>2 → стабильность скриптов (маркер «ТЗ vN», прогон сниппетов)	🟡
Б3	Wall-clock и токены этапа	база И1/И2 зафиксирована	тренд ↓ на однотипных этапах	рост ×2 → разбор причин	🟢 (ускорение ×3–5)
В1	Возврат правил: батарея top-3	16/16	100%	<100% → чинить корпус/нарезку, не батарею	🟢
В2	Темы с первого захода	2/4 до env-фикса	≥75%	<75% → тюнинг запросов / ускорить --tag env:*	🟡 (контрольный прогон /decision)
В3	Дыры корпуса (темы без находок)	механизм заведён	закрытие в ту же итерацию	каждая → кандидат наполнения дерева	🟢
В4	Возраст docChanges на легализации	до 4 этапов	≤1 итерации	>1 итерации → выносить легализацию чаще	🟡
Г1	Honest-skip'ы сняты к замыканию	И1: все сняты живыми	100%	остаток → в хвосты handoff	🟢
Г2	Эскалации закрыты владельцем	не замерялось	≤1 дня	дольше → выносить в повестку явно	🟢 (эмпирически быстро)
Г3	Инциденты среды: новые → карточка	правило заведено	в тот же день	дольше → помнить о dx-retro-3	🟢

Пересмотр целей — не чаще каждой второй ретроспективы, коммитом с обоснованием. Добавление метрики — через ретроспективу (какие решения она изменит? не изменяет — не заводить).

История светофоров (полная — git log карточки)

• 2026-11-02 — базовая фиксация: А1–А4/Б1/Б2/В2/В4 🟡, Б3/В1/В3/Г* 🟢; источники — ретроспектива Kit.RAG (И1/И2) и живой прогон /decision.

Правило обновления карточки

Ретроспектива проекта (dx-retro-1) дописывает: новые приёмы с оценкой и прецедентом-числом, пересматривает существующие оценки, закрывает хвосты, обновляет светофоры со ссылкой на замер. Числа обязательны («быстрее/лучше» без чисел не принимается, dx-retro-2). Коммит в std1-ext с указанием источника-ретроспективы + переиндексация корпуса. Откат оценки/правила — git revert с обоснованием; замеры-факты последующих итераций не откатываются.