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:
1 parent
10f55f35f2
commit
1fdbcd63df
1 file changed
+27
-17
+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»), тогда как агента зовут и на слепое
|
||||
ревью. Территория пользователя.
|
||||
|
||||
## Не обкатано боем — проверить первым же прогоном
|
||||
|
||||
|
||||
Reference in new issue
Block a user