refactor(brainstorm-with-docs): понимание ведёт, артефакт — запись

- Зачем:
  - гравитация скилла тянула к «выдать артефакт»; управляющие документы
    раздувались деталями реализации (диагностировано на живом тесте — ADR
    с инлайном SQL).
- Что:
  - gate/stop: «готово» = общее понимание + рекомендованное направление,
    записанное минимально-достаточно, а не «артефакт произведён»; определение
    в одном месте (stop_condition), gate на него ссылается.
  - core_rules: минимально-достаточный артефакт + барьер высоты (без инлайна
    исполняемых артефактов) + single source of truth; приоритет над
    конвенциями репозитория.
  - шаг 2: артефакт(ы) выбираются ПОСЛЕ понимания, набором по жанрам.
  - adr.md/spec.md: Lifetime test → Scope test (ADR↔spec по охвату, не сроку);
    detailed plan — transient и вне scope скилла.
  - description + README: формулировки-цели ведут пониманием, не артефактом.
- Проверка:
  - grep: старый framing (lifetime/transient) убран; cross-ref Scope test
    сходится; определение «готово» не дублируется; витрина не artifact-first.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Dmitry DementievandClaude Opus 4.8 committed 2026-06-08 18:56:30 +03:00
1 parent 14adf77424
commit 6f9de57b0c
4 files changed
+48 -22

No files matched your search

@@ -3,8 +3,9 @@
A manually-invoked skill for **brainstorming, design alignment, and durable
documentation** — grounded in a project's existing docs and vocabulary. It takes
an unclear engineering, DevOps, architecture, migration, integration, research,
or documentation problem and turns it into the *smallest useful* durable
artifact: a spec, ADR, runbook, research note, or `CONTEXT.md` glossary update.
or documentation problem and drives it to shared understanding and a recommended
direction — recorded in the *smallest useful* durable artifact: a spec, ADR,
runbook, research note, or `CONTEXT.md` glossary update.
It is deliberately **not** an implementation skill. It reads project files and
proposes documentation, but stops before code, config, or infrastructure changes
@@ -22,8 +23,9 @@ It combines four things that are usually separate:
- **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.
- **durable output** — the understanding is the deliverable; it's recorded in 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