32 lines
7.3 KiB
Markdown
32 lines
7.3 KiB
Markdown
# Актуальные рекомендации kit-dev-flow (обновлено: 2026-11-05)
|
||
|
||
Полная версия с таблицей сверки метрик А1–Г3 и источниками:
|
||
[recommendations/2026-11-05-рекомендации.md](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 не вошли.
|