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 ``.