docs(skills): brainstorm-with-docs — hot и cold review названы в самом скилле
Скиллом пользуются не только на машинах с глобальным словарём — он должен быть самодостаточным. Шаг 7 называет перечитывание hot review с глоссой оси (полный контекст автора: дёшево, но слепота общая), stop_condition предлагает cold review свежей сессией как следующий шаг при высоких ставках. Тёплое ревью не внесено: скилл им не пользуется. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
5671967f4e
commit
202cbdb0d7
1 file changed
+5
-1
@@ -244,7 +244,9 @@ Otherwise use the conventional homes — `CONTEXT.md` at the repo root, ADRs in
|
|||||||
as part of step 6 rather than guessing. Create directories lazily.
|
as part of step 6 rather than guessing. Create directories lazily.
|
||||||
|
|
||||||
After writing, re-read the written file end-to-end as its reader, not its
|
After writing, re-read the written file end-to-end as its reader, not its
|
||||||
author. React by the level of what you find. Text-level defects — wording,
|
author — a **hot review**: the reviewer carries the author's full context,
|
||||||
|
which makes it cheap, and shares the author's blind spots, which is its limit.
|
||||||
|
React by the level of what you find. Text-level defects — wording,
|
||||||
structure drift, template mismatches — fix in place, silently. A
|
structure drift, template mismatches — fix in place, silently. A
|
||||||
decision-level find — a contradiction with existing docs or between the
|
decision-level find — a contradiction with existing docs or between the
|
||||||
artifact's own sections, a hole in coverage, an unhandled scenario — present
|
artifact's own sections, a hole in coverage, an unhandled scenario — present
|
||||||
@@ -300,6 +302,8 @@ user explicitly asks to implement. Offer a small set of next actions, such as:
|
|||||||
* create or update an ADR
|
* create or update an ADR
|
||||||
* update `CONTEXT.md`
|
* update `CONTEXT.md`
|
||||||
* create a runbook
|
* create a runbook
|
||||||
|
* hand the artifact to a **cold review** — a fresh session or agent with no
|
||||||
|
shared context — where the stakes warrant an independent eye
|
||||||
* derive a compact implementation checklist
|
* derive a compact implementation checklist
|
||||||
* start implementation (only on explicit request)
|
* start implementation (only on explicit request)
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user