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