34 lines
8.0 KiB
Markdown
34 lines
8.0 KiB
Markdown
# Актуальные рекомендации kit-dev-flow (обновлено: 2026-11-06)
|
||
|
||
Полная версия с таблицей сверки метрик А1–Г3, статусами исполнения и
|
||
источниками: [recommendations/2026-11-06-рекомендации.md](recommendations/2026-11-06-рекомендации.md)
|
||
|
||
Контекст периода: карточек в петле по-прежнему 1 — новых за 2026-11-05→06
|
||
нет (срез `--kind этап-модуля` — 0). Светофор от 2026-11-02 без изменений
|
||
(А1–А4, Б1, Б2, В2, В4 🟡; Б3, В1, В3, Г1–Г3 🟢). Ни одна R1–R9 прошлого
|
||
анализа не исполнена (решения у владельца Р-1..Р-8); механические дефекты
|
||
перепроверены построчно и на месте; новый факт периода — многострочные уроки
|
||
теряют хвост при агрегации (R9). Окно Р-1 («формат карточки до первого
|
||
прогона этап-модуля») ещё открыто — утверждение P4+P5 остаётся самым дешёвым
|
||
по цене момента действием.
|
||
|
||
## TOP-рекомендации
|
||
|
||
| # | Рекомендация | Тип | Доказательство (кратко) | Как проверить |
|
||
|---|---|---|---|---|
|
||
| R1 | Формат полей карточки по README: `project`/`step` — короткие идентификаторы (не пути), `<шаг>` в имени файла, конвенция «не зафиксировано» | механическая | карточка 10fa0e8f:3–4 — полные пути (перепроверено 06.11); README:25,30–31 — `<дата>-<проект>-<шаг>-<hash>`, `project: kit-rag`; `_summary.md:12` — урок с путём дважды, «проектов: 1» = путь | следующая карточка с короткими project/step и `<шаг>` в имени; две карточки одного проекта → «проектов: 1» |
|
||
| R2 | Поля `findings`/`findings_high`/`redo`/`tokens` (+ темы эскалаций) в шапку карточки и NUM_FIELDS парсера | механическая | revisions 0 при коллизии А1/Б2; duration «-», токенов нет — Б3 неизмерима; урок: разбивка 10 эскалаций не попадает в формат; whitelist flow_stats.py:23–25 без изменений (проверено 06.11) | фикстура с новыми полями проходит парсер; средние findings/redo в `_summary.md` по kind=этап-модуля — сверка с А1/Б2 |
|
||
| R3 | Атрибуция журнала при прогонах над ним: baseline HEAD (`journal_base`) в карточке и/или журнал в areas исполнителя | семантическая | урок карточки: 2 вне-зонных коммита (075f063, e6c9559), контролёр «коммитов не делал», решение Р-8; сам прогон 06.11 baseline тоже не зафиксировал | в карточке прогона над журналом есть базовая ревизия; diff base..HEAD объясим зонами |
|
||
| R4 | Канон словаря kind в README и SKILL.md (`db`, не «БД»), нормализация в парсере | механическая | README:32 `db` (на месте, проверено 06.11) vs SKILL.md:127 «БД»; flow_stats.py:93–94 — строгое равенство 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:37–49 без строки (проверено 06.11) | приём с числом-прецедентом в dx-flow; следующий прогон: А2=0, за контрольным гейтом — diff правки |
|
||
| R8 | Исполнить сработавшие триггеры Б1 (70→56 % при цели ≤40 %, две итерации >50 %) и В4 (docChanges до 4 этапов): каскад в одно место, легализация на каждом замыкании — через ретроспективу | семантическая | Б1: И1 ~70 %, И2 ~56 %, 🟡; В4: до 4 этапов при цели ≤1 итерации; по правилу светофора (dx-flow:76–79) — пересмотр оценки правила на ретроспективе | замер git log: доля док-коммитов ≤50 % к следующей итерации; возраст docChanges ≤1 итерации |
|
||
| R9 | Механика журнала: битая ссылка dx-flow.md:8, пустая таблица форм при 0 карточек, обрезка «#» в значениях (flow_stats.py:60), обрезка многострочных уроков (flow_stats.py:73–74) — новое за период | механическая | ссылка ведёт вне репозитория; пустая таблица наблюдена сегодня в `--kind этап-модуля`; НОВОЕ: `_summary.md:12–13` — уроки обрываются на «: 2» и «:», хвосты («2 локальных коммита 075f063, e6c9559…») потеряны | ссылка заменена явным путём; отчёт без пустых таблиц; урок в `_summary.md` читается целиком до конца пункта |
|
||
|
||
Правило отбора: метрика хуже цели dx-flow (А1–А4, Б1, Б2, В2, В4 — все 🟡)
|
||
→ кандидат; плюс неизмеримость 🟢-метрик карточкой (Б3, Г2) и механические
|
||
дефекты журнала. Ранжирование и номера R1–R9 сохранены с 2026-11-05 —
|
||
фактуры периода для переранжирования нет (0 новых карточек, 0 новых
|
||
замеров). В2 (контур RAG) и А4/Б2 (ждут данных петли) в TOP не вошли.
|