From 202cbdb0d7c6ddc50dfd936828f0cd4bae40ca8b Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Sat, 1 Aug 2026 19:16:03 +0300 Subject: [PATCH] =?UTF-8?q?docs(skills):=20brainstorm-with-docs=20?= =?UTF-8?q?=E2=80=94=20hot=20=D0=B8=20cold=20review=20=D0=BD=D0=B0=D0=B7?= =?UTF-8?q?=D0=B2=D0=B0=D0=BD=D1=8B=20=D0=B2=20=D1=81=D0=B0=D0=BC=D0=BE?= =?UTF-8?q?=D0=BC=20=D1=81=D0=BA=D0=B8=D0=BB=D0=BB=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Скиллом пользуются не только на машинах с глобальным словарём — он должен быть самодостаточным. Шаг 7 называет перечитывание hot review с глоссой оси (полный контекст автора: дёшево, но слепота общая), stop_condition предлагает cold review свежей сессией как следующий шаг при высоких ставках. Тёплое ревью не внесено: скилл им не пользуется. Co-Authored-By: Claude Opus 5 --- agents/.agents/skills/brainstorm-with-docs/SKILL.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/agents/.agents/skills/brainstorm-with-docs/SKILL.md b/agents/.agents/skills/brainstorm-with-docs/SKILL.md index 3c13444..3a045c8 100644 --- a/agents/.agents/skills/brainstorm-with-docs/SKILL.md +++ b/agents/.agents/skills/brainstorm-with-docs/SKILL.md @@ -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. 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 decision-level find — a contradiction with existing docs or between the 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 * update `CONTEXT.md` * 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 * start implementation (only on explicit request)