docs(skills): открытые находки холодного ревью — с номерами и доводом

- Зачем:
  - индексы находок жили в скретчпаде и умирают вместе с сессией; из
    прозы handoff'а нельзя было понять, какая находка закрыта, а какая
    ещё ждёт решения.
- Что:
  - FIT-5 убрана из списка оставленных: закрыта коммитом 10f55f3.
  - открытым проставлены номера и довод линии — TECH-3, FIT-4, FIT-11,
    FIT-12; вопросы владельцу помечены как FIT-3 и FIT-10.
  - счётчик коммитов заменён командой: HEAD с тех пор уехал.
- Проверка:
  - git log --oneline c18472e.. ; строк длиннее 80 символов в handoff нет.
This commit is contained in:
Dmitry Dementiev committed 2026-08-04 21:48:25 +03:00
1 parent 10f55f35f2
commit 1fdbcd63df
1 file changed
+27 -17
@@ -3,8 +3,8 @@
Дата: 2026-08-03/04. Контекст: не боевой прогон, а заход на сам скилл.
Начали под `/writing-great-skills` (разбор `references/lessons.md`),
закончили под `/brainstorm-with-docs` (холодное ревью и триаж находок).
Диапазон коммитов — `c18472e..HEAD`, девять штук, `git log --oneline`
даёт список; здесь только то, чего в них нет.
Диапазон коммитов — от `c18472e`; список даёт
`git log --oneline c18472e..`. Здесь только то, чего в них нет.
## Холодное ревью: как было устроено и что от него осталось
@@ -21,13 +21,13 @@
## Открытые вопросы к владельцу (не правки)
1. **Две копии определений субагентов.** `references/claude-agents.md`
1. **Две копии определений субагентов** (FIT-3). `references/claude-agents.md`
(заготовки) и `.claude/agents/*.md` (созданы коммитом `f650451`).
Сегодня совпадают, главная не названа. Расхождение будет тихим:
ступень оркестратор читает из первого, харнесс — из второго.
2. **Вкусовую линию нечем эскалировать.** `craftsman` пришит к `medium`,
единственный более сильный Опус (`deep-reasoner`) описан только как
временный фолбэк при отсутствии `craftsman`. При этом разрыв рангов
2. **Вкусовую линию нечем эскалировать** (FIT-10). `craftsman` пришит к
`medium`, единственный более сильный Опус (`deep-reasoner`) описан
только как временный фолбэк при отсутствии `craftsman`. Разрыв рангов
«Опус medium против Кодекса high» назван в `lessons.md` причиной, ради
которой правились шапки триажа. Вопрос: заводить ли `craftsman`
ступенью выше.
@@ -40,17 +40,27 @@
## Находки, оставленные сознательно
- **Отклонена с доводом:** гонка между проверкой отчёта и `wc` в стороже
(микросекунды, а `STALLED` по тексту — повод посмотреть, не вердикт).
- **Оставлены как решение владельца:** формулировки в
`prompts/triage-header.md` про «прогон без отклонений — повод
перечитать» и про NEEDS_DECISION при собственной правке. Обе линия
ревью считает переусердствованием, но текст согласован с владельцем
2026-08-03 и линия этого не знала.
- **Оставлены после спора:** обоснование переименования рядом с правилом
в `prompt-templates.md` (именно оно удерживает следующего от
«упрощения» имён обратно); стойка «follow it exactly» в начале
определения `craftsman` — территория пользователя.
Всего было 19: 12 по линии уместности (`FIT-*`) и 7 по технической
(`TECH-*`). Закрытые читаются по коммитам диапазона; ниже — открытые, с
номером и доводом, потому что сами индексы живут в скретчпаде и умирают
вместе с сессией.
- **TECH-3, отклонена с доводом:** гонка между проверкой отчёта и `wc` в
стороже — микросекунды, а `STALLED` по тексту и так повод посмотреть, а
не вердикт.
- **FIT-4, решение владельца:** `prompts/triage-header.md`, «прогон без
единого отклонения — повод перечитать принятое на веру». Довод линии:
базовая статистика отдана тому, кто видит ровно один прогон, и даёт
постоянный повод переоткрывать уже принятое; предлагалось оставить
целевое поведение без статистического обоснования. Текст согласован с
владельцем 2026-08-03, линия этого не знала.
- **FIT-11, оставлена после спора:** девять строк обоснования
переименования встали между сборочным блоком и обёрткой вызова в
`prompt-templates.md`. Оставлено намеренно: именно это обоснование
удерживает следующего от «упрощения» имён обратно.
- **FIT-12, оставлена после спора:** `craftsman.md` открывается стойкой
исполнителя («follow it exactly»), тогда как агента зовут и на слепое
ревью. Территория пользователя.
## Не обкатано боем — проверить первым же прогоном