форма config.yaml сверяется с живым openspec, а не с памятью

Проверка формы знала имя схемы и перечень артефактов константами — и это не наше решение, а состояние чужого инструмента. OpenSpec переименует артефакт: правила под прежним именем перестанут применяться, конфиг останется выглядеть написанным, канон продолжит требовать прежнее. Молчат при этом все три стороны, и заметить расхождение было некому. Сторожем поставлено сравнение версий. check спрашивает openspec --version — десятые доли секунды — и сравнивает major.minor с той, на которой форма сверялась. Разошлось — замечание, не отказ, с именем команды, которая перепроверяет. Патч-версия в сравнение не берётся намеренно: формы она не меняет, а нагоняй на каждый багфикс приучает пролистывать весь блок. Перепроверяет docs.py openspec-form: берёт openspec templates --json, то есть перечень артефактов текущей схемы, и печатает, что разошлось с константами. Дорогой вызов вынесен из check сознательно — он стоит втрое дороже опроса версии, а ответ меняется только вместе с версией. Дешёвая проверка служит воротами дорогой, и дорогая не ржавеет, потому что зовут её не по памяти. Чинится расхождение в плагине, а не в проекте, и команда печатает три адреса правки списком: константы скрипта, скелет, журнал версий канона. Пятой проверкой формы стали ключи под rules: — это имена артефактов, и правило, адресованное несуществующему, не применяется молча. rules.spec вместо rules.specs даёт конфиг, выглядящий написанным и не работающий. Первый вариант этой проверки искал ключи отступом по всему файлу и нашёл их внутри литерального блока context: строки «Language: Russian» и «av-dev-pm:review-pipeline» выглядят ключами. Оба живых проекта из-за этого покраснели на правде. Теперь разбор идёт от строки rules: до следующего ключа нулевой колонки; на тех же проектах чисто, а опечатка в имени артефакта по-прежнему находится. Решение — 48. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 12:07:46 +03:00
parent a79266cfcb
commit 6ff12fedd5
6 changed files with 259 additions and 9 deletions
@@ -429,7 +429,7 @@ kebab-case.** Причина не эстетическая: имя файла с
 знания, где лежит граница домена. Это ровно тот класс, против которого написан
 весь канон, и потому здесь он проверяется машиной, а не чтением.

-Проверяется четыре вещи, и каждая — про молчащий пробел, а не про вкус:
+Проверяется пять вещей, и каждая — про молчащий пробел, а не про вкус:

 1. **`openspec/` есть.** Нет — нет и дома темы `requirements`.
 2. **Имя файла `config.yaml`.** `config.yml` OpenSpec не читает и об этом не
@@ -439,8 +439,22 @@ kebab-case.** Причина не эстетическая: имя файла с
 4. **`context` называет `passport` и `CLAUDE.md`.** Предложение пишется **до**
   того, как кто-либо откроет `docs/`; без этих двух адресов его пишут, не зная
   ни границы домена, ни инвариантов.
+5. **Ключи под `rules:` — имена артефактов схемы** (`proposal`, `specs`,
+   `design`, `tasks`). Правило, адресованное несуществующему артефакту, не
+   применяется и об этом молчит: `rules.spec` вместо `rules.specs` — конфиг,
+   выглядящий написанным и не работающий.

-Пятого — «нет ли здесь пересказа» — машина не проверяет: отличить ссылку от
+**Схема и перечень артефактов — слепок чужого инструмента, и он стареет.**
+OpenSpec переименует артефакт или сменит схему — правила под прежним именем
+перестанут действовать молча, а канон будет продолжать требовать прежнее.
+Поэтому за свежестью слепка следит машина: `check` сравнивает `major.minor`
+установленного OpenSpec с версией, на которой форма сверялась, и при расхождении
+даёт **замечание** (не отказ: патч-версии формы не меняют, а нагоняй на каждый
+багфикс приучает пролистывать блок). Перепроверяет `docs.py openspec-form` — он
+спрашивает сам инструмент и печатает, что разошлось. **Чинится это в плагине, а
+не в проекте:** константы скрипта, скелет и запись в журнал версий канона.
+
+Шестого — «нет ли здесь пересказа» — машина не проверяет: отличить ссылку от
 пересказа она не умеет. Это работа `doc-consistency`, и раздел «Что проверяет
 машина, а что человек» называет её строкой.

@@ -513,7 +527,8 @@ kebab-case.** Причина не эстетическая: имя файла с
 | маркеры долга — числом | **протухший факт, разошедшийся с кодом** | `doc-code-drift` |
 | миграция изменена, а `database.md` нет | зависимость в манифесте, не названная в обзоре | `doc-code-drift` |
 | capability без упоминания в `architecture.md` | второй способ там, где обзор обещал единственный | `doc-code-drift` |
-| `openspec/config.yaml`: имя, `schema`, незаменённый пример, адреса паспорта и `CLAUDE.md` | **пересказ документа канона в `context` вместо ссылки** | `doc-consistency` |
+| `openspec/config.yaml`: имя, `schema`, незаменённый пример, адреса паспорта и `CLAUDE.md`, ключи `rules` против артефактов схемы | **пересказ документа канона в `context` вместо ссылки** | `doc-consistency` |
+| версия OpenSpec разошлась с той, на которой сверена форма `config.yaml` | придирки валидатора: сменились ли они | никакой — проявляются отказом `openspec validate --strict` |
 | | связность и читаемость | `doc-wording` |

 **Агентов двое, и разведены они по глубине, а не по охвату.** `doc-consistency`
@@ -38,11 +38,17 @@ capability по имени пакета и без единого `SHALL`.
   артефакта**: язык, правила именования capability, придирки валидатора и
   **адреса** документов канона. Пересказ паспорта, инвариантов, конвенций и
   правил ревью в него не переносится.
-3. **`docs.py check` проверяет четыре вещи:** каталог `openspec/` есть; файл
+3. **`docs.py check` проверяет пять вещей:** каталог `openspec/` есть; файл
   называется `config.yaml` (`config.yml` OpenSpec читать не станет и об этом не
   сообщит); `context` и `rules.specs` не остались примером, а правила для
-   `specs` называют `SHALL`; `context` называет `passport` и `CLAUDE.md`.
-4. **Пятое проверяет агент.** Отличить ссылку на документ от пересказа документа
+   `specs` называют `SHALL`; `context` называет `passport` и `CLAUDE.md`; ключи
+   под `rules:` — имена артефактов схемы, а не опечатки.
+4. **За свежестью формы следит машина, а не память.** Схема и перечень
+   артефактов — слепок чужого инструмента; `check` сравнивает `major.minor`
+   установленного OpenSpec с версией, на которой форма сверялась, и при
+   расхождении даёт замечание. Перепроверяет `docs.py openspec-form`, и чинится
+   расхождение **в плагине, а не в проекте**.
+5. **Шестое проверяет агент.** Отличить ссылку на документ от пересказа документа
   машина не умеет — это работа `doc-consistency`, и в таблице «Что проверяет
   машина, а что человек» она стоит строкой.

@@ -490,6 +490,13 @@ rules:
 дополняет своим (стек, разведка, особенности домена), но **адреса паспорта и
 `CLAUDE.md` обязательны** — их отсутствие `docs.py check` называет отказом.

+**Ключи под `rules:` — имена артефактов схемы**, а не свободные слова:
+`proposal`, `specs`, `design`, `tasks`. Правило под чужим именем не применяется
+и об этом не сообщает, поэтому `rules.spec` вместо `rules.specs` даёт конфиг,
+выглядящий написанным и не работающий; `docs.py check` такой ключ называет.
+Перечень артефактов задаёт OpenSpec, а не канон, — за его актуальностью следит
+`docs.py openspec-form`.
+
 ## `docs/.pm.json`

 ```json