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:
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:
|
||||
|
||||
Reference in new issue
Block a user