docs(brainstorm-with-docs): обновлена документация скилла

- Зачем:
  - README и ROADMAP должны отражать текущую модель скилла без устаревшего handoff.
- Что:
  - удален временный DEV-HANDOFF.md.
  - README уточняет отличие от grill-me и роль grill-with-docs как upstream influence.
  - ROADMAP фиксирует R2/F4 как landed и описывает F1 как cheap frame-challenger.
- Проверка:
  - git diff --check -- agents/.agents/skills/brainstorm-with-docs.

agents/.agents/skills/brainstorm-with-docs/README.md

@@ -12,15 +12,25 @@ proposes documentation, but stops before code, config, or infrastructure changes
 
 ## Why this exists
 
-It combines three things that are usually separate:
+It combines four things that are usually separate:
 
 - **shared domain language** (glossary / `CONTEXT.md`) and **lightweight ADRs** —
   the discipline of capturing terminology and durable decisions as they crystallise;
 - **active grilling** — not just extracting requirements, but pressure-testing
   them: challenging terms against the glossary, sharpening fuzzy language, probing
   with edge-case scenarios, cross-checking claims against the code;
-- **option exploration** — always comparing 2-3 viable approaches with trade-offs
-  before recommending a direction.
+- **option exploration** — comparing 2-3 viable approaches within the user's
+  framing, plus at least one framing-challenger so the agent does not only
+  optimise inside the first shape of the problem;
+- **durable output** — turning the useful thinking into the smallest appropriate
+  artifact: glossary entry, spec, ADR, runbook, research note, or PRD.
+
+The closest day-to-day comparison is `grill-me`: use `grill-me` when you mainly
+want the agent to pull understanding out of you and align on a plan in the
+conversation. Use `brainstorm-with-docs` when the discussion must be grounded in
+the repository and leave behind project documentation. `grill-with-docs` is an
+upstream influence for glossary and ADR discipline, but this skill is not trying
+to follow that methodology wholesale.
 
 ## Usage
 
@@ -59,15 +69,16 @@ Templates are split per type so the agent loads only what's relevant
 ## Roadmap
 
 - **v1 (current):** working hybrid — context inspection, glossary/ADR discipline,
-  active grilling, option comparison, durable artifacts, stop-before-implementation.
-- **v2 (planned):** a *divergence phase* before option synthesis (an
-  idea-generation toolkit plus the rule "at least one option the user didn't
-  already imply"), a "design for isolation" lens, and fuller multi-context
-  support. A `<!-- SEAM -->` marker in `SKILL.md` step 5 marks where it slots in.
+  active grilling, option comparison with an additive framing-challenger, durable
+  artifacts, stop-before-implementation.
+- **v2 (planned):** tiered fuller divergence for heavier decisions, an
+  idea-generation toolkit, a "design for isolation" lens, and fuller
+  multi-context support. A `<!-- SEAM -->` marker in `SKILL.md` step 5 marks where
+  it slots in.
 
 See [ROADMAP.md](ROADMAP.md) for the full backlog, pending decisions, and what
-has been considered and rejected. (Dev-phase docs — `ROADMAP.md` and any
-`DEV-HANDOFF.md` — can be removed once the skill stabilises.)
+has been considered and rejected. `ROADMAP.md` is development memory and can be
+removed once the skill stabilises.
 
 ## Attribution
 
@@ -77,7 +88,9 @@ from two MIT-licensed projects:
 - **grill-with-docs / grill-me** by Matt Pocock —
   <https://github.com/mattpocock/skills> (MIT, © 2026 Matt Pocock).
   Source of the glossary/`CONTEXT.md` discipline, lightweight ADRs, and the
-  active grilling techniques.
+  active grilling techniques. This skill deliberately diverges from
+  `grill-with-docs` where the user's workflow needs broader artifact creation and
+  option exploration.
 - **brainstorming** by Jesse Vincent (obra), from Superpowers —
   <https://github.com/obra/superpowers> (MIT, © 2025 Jesse Vincent).
   Source of the explore-context → question → compare-options → present-design flow