DB.FlowExp_WorkStatistics/_recommendations.md

Актуальные рекомендации kit-dev-flow (обновлено: 2026-11-05)

Полная версия с таблицей сверки метрик А1–Г3 и источниками: recommendations/2026-11-05-рекомендации.md

Контекст недели: карточек в петле 1 — первая (kind документ, form preset, result fail, revisions 0, escalations 10, duration «-»); срез --kind этап-модуля — 0. До-петлевая фактура — baseline (93 прогона, 3 проекта, все generated). Новых замеров А1–Г3 нет (светофор 2026-11-02: А1–А4, Б1, Б2, В2, В4 🟡; Б3, В1, В3, Г1–Г3 🟢), но первая карточка показала: А1/Б2/Б3/Г2 карточкой пока не измеряются, а качество полей отклонилось от README (пути вместо имён проекта/шага).

TOP-рекомендации

#	Рекомендация	Тип	Доказательство (кратко)	Как проверить
R1	Формат полей карточки по README: project/step — короткие идентификаторы (не пути), <шаг> в имени файла, конвенция «не зафиксировано»	механическая	карточка 10fa0e8f:3–4 — полные пути; README:25,30–31 — <дата>-<проект>-<шаг>-<hash>, project: kit-rag; _summary.md уже показывает «проект»-путь	следующая карточка с короткими project/step и <шаг> в имени; две карточки одного проекта → «проектов: 1»
R2	Поля findings/findings_high/redo/tokens (+ темы эскалаций) в шапку карточки и NUM_FIELDS парсера	механическая	revisions 0 («у пресета нет циклов ревизии») при коллизии А1/Б2; duration «-», токенов нет — Б3 неизмерима; урок карточки: разбивка 10 эскалаций не попадает в формат; whitelist flow_stats.py:23–25 теряет новые поля	фикстура с новыми полями проходит парсер; средние findings/redo в _summary.md по kind=этап-модуля — сверка с А1/Б2
R3	Атрибуция журнала при прогонах над ним: baseline HEAD в карточке и/или журнал в areas исполнителя	семантическая	урок карточки: 2 вне-зонных коммита (075f063, e6c9559) в окне прогона, контролёр «коммитов не делал», решение владельца Р-8	в карточке прогона над журналом есть базовая ревизия; diff base..HEAD объясним зонами
R4	Канон словаря kind в README и SKILL.md (db, не «БД»), нормализация в парсере	механическая	README:32 db vs SKILL.md:127 «БД»; flow_stats.py:93 — строгое равенство kind	карточка kind: БД попадает в --kind db; класс в отчёте один
R5	Каркас пресета — до модального паттерна: интегратор-гейт, ревизор свежим контекстом, контрольный гейт, финальная стадия «карточка+commit»	семантическая	первый preset-прогон: revisions 0, escalations 10 при 4 агентах, result fail; в пресетах нет ролей интегратора/ревизора (baseline §2.5), модальный паттерн Kit.RAG = эталон dx-flow	grep ролей в kit-dev-process.dwf.ts; следующий пресетный прогон — findings в карточке, эскалации без разбухания approvals
R6	Правило класса аналитических задач (sd-анализ): ТЗ → аудит по ТЗ → доработка → независимый контроль → сдача владельцу	семантическая	урок карточки: правила нет, c-tst/db-tst/d-tst неприменимы, этапы шли «по общему каркасу» без норматива	следующая аналитическая задача ссылается на правило; контрольный гейт класса — формализованный чек-лист
R7	Исполнить триггеры А2/А3: приём «якоря — живым запросом (dx-dev-8), числа — пересчётом» в dx-flow; находки контрольного гейта закрываются правкой артефакта	семантическая	А2=2 (И3-э1); петлевой факт: аудит приписал 2 из 4 маркеров (grep ×0), находка LOW не закрыта правкой — дефект живёт после замыкания	приём с числом-прецедентом в dx-flow; следующий прогон: А2=0, за контрольным гейтом — diff правки
R8	Исполнить сработавшие триггеры Б1 (70→56 % при цели ≤40 %, две итерации >50 %) и В4 (docChanges до 4 этапов): каскад статусов в одно место, легализация на каждом замыкании — через ретроспективу	семантическая	Б1: И1 ~70 %, И2 ~56 %, 🟡; В4: до 4 этапов при цели ≤1 итерации; по правилу светофора — пересмотр оценки правила на ретроспективе	замер git log: доля док-коммитов ≤50 % к следующей итерации; возраст docChanges ≤1 итерации
R9	Механика журнала: битая ссылка dx-flow.md:8 (../../readme.md), пустая таблица форм при 0 карточек, обрезка «#» в значениях (flow_stats.py:60)	механическая	ссылка из корня журнала ведёт вне репозитория; пустая таблица наблюдена в --kind этап-модуля этого прогона; split(" #") режет значения	ссылка заменена явным путём к эталону; отчёт без пустых таблиц; значения шапки читаются целиком

Правило отбора: метрика хуже цели dx-flow (А1–А4, Б1, Б2, В2, В4 — все 🟡) → кандидат; плюс первые петлевые факты: неизмеримость 🟢-метрик карточкой (Б3, Г2) и механические дефекты журнала. Ранжировано по стоимости для петли. В2 (контур RAG) и А4/Б2 (ждут данных петли) в TOP не вошли.