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. Контекст: не боевой прогон, а заход на сам скилл.
|
Дата: 2026-08-03/04. Контекст: не боевой прогон, а заход на сам скилл.
|
||||||
Начали под `/writing-great-skills` (разбор `references/lessons.md`),
|
Начали под `/writing-great-skills` (разбор `references/lessons.md`),
|
||||||
закончили под `/brainstorm-with-docs` (холодное ревью и триаж находок).
|
закончили под `/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`).
|
(заготовки) и `.claude/agents/*.md` (созданы коммитом `f650451`).
|
||||||
Сегодня совпадают, главная не названа. Расхождение будет тихим:
|
Сегодня совпадают, главная не названа. Расхождение будет тихим:
|
||||||
ступень оркестратор читает из первого, харнесс — из второго.
|
ступень оркестратор читает из первого, харнесс — из второго.
|
||||||
2. **Вкусовую линию нечем эскалировать.** `craftsman` пришит к `medium`,
|
2. **Вкусовую линию нечем эскалировать** (FIT-10). `craftsman` пришит к
|
||||||
единственный более сильный Опус (`deep-reasoner`) описан только как
|
`medium`, единственный более сильный Опус (`deep-reasoner`) описан
|
||||||
временный фолбэк при отсутствии `craftsman`. При этом разрыв рангов
|
только как временный фолбэк при отсутствии `craftsman`. Разрыв рангов
|
||||||
«Опус medium против Кодекса high» назван в `lessons.md` причиной, ради
|
«Опус medium против Кодекса high» назван в `lessons.md` причиной, ради
|
||||||
которой правились шапки триажа. Вопрос: заводить ли `craftsman`
|
которой правились шапки триажа. Вопрос: заводить ли `craftsman`
|
||||||
ступенью выше.
|
ступенью выше.
|
||||||
@@ -40,17 +40,27 @@
|
|||||||
|
|
||||||
## Находки, оставленные сознательно
|
## Находки, оставленные сознательно
|
||||||
|
|
||||||
- **Отклонена с доводом:** гонка между проверкой отчёта и `wc` в стороже
|
Всего было 19: 12 по линии уместности (`FIT-*`) и 7 по технической
|
||||||
(микросекунды, а `STALLED` по тексту — повод посмотреть, не вердикт).
|
(`TECH-*`). Закрытые читаются по коммитам диапазона; ниже — открытые, с
|
||||||
- **Оставлены как решение владельца:** формулировки в
|
номером и доводом, потому что сами индексы живут в скретчпаде и умирают
|
||||||
`prompts/triage-header.md` про «прогон без отклонений — повод
|
вместе с сессией.
|
||||||
перечитать» и про NEEDS_DECISION при собственной правке. Обе линия
|
|
||||||
ревью считает переусердствованием, но текст согласован с владельцем
|
- **TECH-3, отклонена с доводом:** гонка между проверкой отчёта и `wc` в
|
||||||
2026-08-03 и линия этого не знала.
|
стороже — микросекунды, а `STALLED` по тексту и так повод посмотреть, а
|
||||||
- **Оставлены после спора:** обоснование переименования рядом с правилом
|
не вердикт.
|
||||||
в `prompt-templates.md` (именно оно удерживает следующего от
|
- **FIT-4, решение владельца:** `prompts/triage-header.md`, «прогон без
|
||||||
«упрощения» имён обратно); стойка «follow it exactly» в начале
|
единого отклонения — повод перечитать принятое на веру». Довод линии:
|
||||||
определения `craftsman` — территория пользователя.
|
базовая статистика отдана тому, кто видит ровно один прогон, и даёт
|
||||||
|
постоянный повод переоткрывать уже принятое; предлагалось оставить
|
||||||
|
целевое поведение без статистического обоснования. Текст согласован с
|
||||||
|
владельцем 2026-08-03, линия этого не знала.
|
||||||
|
- **FIT-11, оставлена после спора:** девять строк обоснования
|
||||||
|
переименования встали между сборочным блоком и обёрткой вызова в
|
||||||
|
`prompt-templates.md`. Оставлено намеренно: именно это обоснование
|
||||||
|
удерживает следующего от «упрощения» имён обратно.
|
||||||
|
- **FIT-12, оставлена после спора:** `craftsman.md` открывается стойкой
|
||||||
|
исполнителя («follow it exactly»), тогда как агента зовут и на слепое
|
||||||
|
ревью. Территория пользователя.
|
||||||
|
|
||||||
## Не обкатано боем — проверить первым же прогоном
|
## Не обкатано боем — проверить первым же прогоном
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user