docs(skills): brainstorm-with-docs — правки по холодному ревью

README перестал объявлять скилл ручным: model-invocation — намеренное
текущее состояние (триггер — форма задачи, не область). Жёсткий гейт
получил исключение для глоссария (спорил с шагом 4) и стал единственным
владельцем запрета на реализацию; дубли правил схлопнуты к владельцам.
Отложенные находки (шов self_review, критерий конца интервью, версионные
пометки в шаблонах) — в Pending decisions ROADMAP.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Dmitry DementievandClaude Opus 5 committed 2026-08-01 18:40:38 +03:00
1 parent e3021ce372
commit d10ad6981c
3 files changed
+70 -39

No files matched your search

@@ -106,6 +106,47 @@ skill router matches it; (b) a repo-side routing line in the project's
future repos. The third-party grilling skill stays unforked; this skill owns
the fan practice.
## Landed (2026-08-01, from cold review)
A fresh-session reviewer (no shared context, writing-great-skills lens) read
the skill cold. Applied same day:
- **README "manual-only" claim was stale** — the worst kind of sediment: a
wrong statement about the skill's invocation mode. The skill started life
with `disable-model-invocation: true`; the owner deliberately made it
model-invoked after live use showed the value is in the agent reaching it
unprompted. Usage section rewritten; the Codex-behaviour paragraph (built on
the manual-only premise) removed.
- **Hard gate contradicted step 4** on inline `CONTEXT.md` capture ("once the
user agrees on the direction" vs "as it happens"). The gate now carries an
explicit exception for additive glossary capture; step 4 owns the rule.
- **Implementation ban deduplicated** — it lived in four places (description,
"Do not use" list, twice inside the gate, stop_condition). The gate is the
single owner: its two internal lists collapsed into one, stop_condition
defers to it. The description keeps its one-line negative trigger and the
"Do not use" list stays — those do invocation routing, not run-time
restraint.
- **Rule/step duplicates collapsed** — minimum-sufficient is owned by the core
rule (step 7 defers); "what NOT to do now" is owned by step 5 Converge (core
rule removed). Same move as the fan-composition prune.
- **README domain list aligned** with the shape-not-domain trigger decision;
README Roadmap section reduced to a pointer at this file (it had become a
second source of truth).
## Pending decisions (2026-08-01 cold review, deferred by owner)
- **Step 7 / self_review seam.** Review runs "before presenting" but after the
file is written; unclear what happens to the written artifact if review sends
the run back to the interview. Candidate fixes: review the draft before
writing, or state honestly "write → review → patch; if a gap opens, back to
the interview, then update the artifact".
- **Interview stop criterion.** "Clear enough to synthesize" is vague; candidate
hardening: problem, constraints, and success criteria named + no open forks
left.
- **Version notes in templates.** `artifacts/context.md` carries "(Multi-context
handling is deliberately light in v1.)" — development history in agent-facing
text; belongs here, not there.
## v2 — remaining
Kept from before: