From a2ba8a3dc563576e151125a6712a0922cd8630c0 Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Sat, 8 Aug 2026 19:00:49 +0300 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D0=BE=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD?= =?UTF-8?q?=D0=B8=D0=B5=20cold=20review=20=D0=B2=20brainstorm-with-docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - расширить методологию ревью артефактов после мозгового штурма. - Что: - добавлен абзац о cold review и порядке работы с его находками в SKILL.md. - Проверка: - git show HEAD:agents/.agents/skills/brainstorm-with-docs/SKILL.md | grep -A 5 'cold review' --- agents/.agents/skills/brainstorm-with-docs/SKILL.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/agents/.agents/skills/brainstorm-with-docs/SKILL.md b/agents/.agents/skills/brainstorm-with-docs/SKILL.md index 3a045c8..41a9c60 100644 --- a/agents/.agents/skills/brainstorm-with-docs/SKILL.md +++ b/agents/.agents/skills/brainstorm-with-docs/SKILL.md @@ -254,6 +254,17 @@ to the user instead: neither fix it silently nor suppress it. Reopening a decision is the user's call. This re-read is cheap and regularly catches both kinds. +A **cold review** — a fresh agent with no shared context — inverts that trade: +it reads the artifact and the repository, never the conversation, so it is +strong on facts and contradictions and weak on fit — on proportion, on what +belongs here, and on what the user already settled. Its findings are evidence, +not orders: verify each against the artifact and the repo, then dispose of it +by the same split as above. Rejecting a finding is a normal outcome. A finding +that argues against something the user settled in conversation is a reviewer +working without that turn, not a defect — report the argument as a +decision-level find. A pass where you rejected nothing is a reason to re-read +what you took on trust. + Then go to ``.