docs(brainstorm-with-docs): уточнены границы артефактов по внешнему ревью
- Зачем:
- внешнее ревью выявило риск двойной записи решений (spec/ADR) и
терминологическую путаницу; правки документные, поведение не меняют.
- Что:
- adr.md и spec.md: добавлен lifetime-критерий ADR vs spec (ADR — для
решений, переживающих спеку; локальные остаются в спеке).
- spec.md: разведены Options considered (до выбора) и Decisions (после).
- SKILL.md: блок <validation> переименован в <self_review>, чтобы не
путать с секцией ## Validation в spec.md.
- README.md: честнее описано авто-срабатывание на Codex.
- SKILL.md: у SEAM зафиксирован TODO(F1) про строку дивергенции
(отложена ради чистого baseline на обкатке).
- Проверка:
- python3 yaml-парс frontmatter; нет висячих ссылок на <validation>.
This commit is contained in:
1 parent
50640d8cb5
commit
f24b342123
4 files changed
+37
-10
No files matched your search
@@ -33,7 +33,10 @@ Invoke manually:
|
||||
On **Claude Code** the skill is manual-only (`disable-model-invocation: true`) —
|
||||
it never auto-triggers; you always call it. On **Codex** that field is ignored
|
||||
(Codex reads only `name` + `description`), so it may auto-trigger on matching
|
||||
design tasks; the negative triggers in the description keep that disciplined.
|
||||
design tasks. The negative triggers in the description discourage that, but the
|
||||
description's positive surface is broad (architecture / DevOps / research), so
|
||||
expect it to fire more eagerly on Codex than on Claude. If that gets noisy,
|
||||
narrow the description.
|
||||
|
||||
## Layout
|
||||
|
||||
|
||||
Reference in new issue
Block a user