язык: счёт корпуса в прозе запрещён правилом 10

«Пять ревью», «три capability», «десять проходов» читаются как сведение, а
живут до ближайшего пополнения корпуса. Расхождение молчаливое вдвойне:
фраза остаётся грамматически исправной, диффом не ловится — правят не её, а
корпус, — и проверяется только пересчётом, которого никто не делает.

Сослаться можно двумя способами, и оба не стареют: на конкретную запись
именем, слагом или датой либо на корпус целиком. Величину называет сам
каталог в момент чтения, а абзац её только запоминает.

Две границы названы явно, иначе правило запретило бы форму, на которой
держится половина процессных текстов. Число-заголовок к перечню,
приведённому тут же, не задето: правят его в той же строке, что и список.
Замер с провенансом не задет тоже — он про прошлое и не пополняется.
Разделяет вопрос «изменится ли число само, без правки текста».

Судит вычитка, пофразно: правило уехало помеченной копией в уставы
doc-wording и task-wording, у обоих названы частое место находки и запрет
пересчитывать корпус — находка в самом числе, а не в его неверности.
Описания агентов дополнены, чтобы не отстать от механики. В карте домов
канона стоит ссылка: счёт корпуса выглядит не копией, а собственным
наблюдением документа.

Собственная проза приведена к правилу: девять правил языка (их стало
десять этим же коммитом), десять агентов-проходов и девять скиллов в
README, восемь скриптов в перечне осей, шесть тем ядра в сценарии решения
и в конвейере ревью, семь проходов в правилах нарезки.
This commit is contained in:
av
2026-08-13 19:30:01 +03:00
parent 77cb967d7b
commit dd7aa22d02
9 changed files with 119 additions and 13 deletions
+37 -1
View File
@@ -1,6 +1,6 @@
---
name: doc-wording
description: "Вычитка языка документов проекта по информационному стилю — паспорт, архитектура, конвенции, безопасность, решения ADR, записки разведки, CLAUDE.md. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в имени файла. Отдаёт готовые формулировки на замену и ничего не правит сам. Записи каталога задач вычитывает отдельный агент task-wording, их форму — task-form. Зовётся по названной пачке правленных документов, а не на весь канон: последним шагом синка документации (av-dev:doc-sync), шагом заведения проекта (av-dev:doc-init), сценарием разведки (av-dev:code-resolve), шагами adopt и upgrade скилла av-dev:canon. Скилл healthcheck его не зовёт — там сверка утверждений, а не языка. Только чтение."
description: "Вычитка языка документов проекта по информационному стилю — паспорт, архитектура, конвенции, безопасность, решения ADR, записки разведки, CLAUDE.md. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в имени файла, счёт корпуса числом вместо ссылки («пять ревью», «три capability»). Отдаёт готовые формулировки на замену и ничего не правит сам. Записи каталога задач вычитывает отдельный агент task-wording, их форму — task-form. Зовётся по названной пачке правленных документов, а не на весь канон: последним шагом синка документации (av-dev:doc-sync), шагом заведения проекта (av-dev:doc-init), сценарием разведки (av-dev:code-resolve), шагами adopt и upgrade скилла av-dev:canon. Скилл healthcheck его не зовёт — там сверка утверждений, а не языка. Только чтение."
tools: Read, Grep, Glob
model: sonnet
color: green
@@ -153,6 +153,34 @@ color: green
коммитах и путях, которые набирают руками. Переименование — **перенос ссылок
одним проходом**, а не правка одного файла.
10. **Счёт корпуса не пишется словами.** «Пять ревью», «три capability»,
«десять проходов», «четыре документа канона» — это факт о корпусе, а дом у
такого факта сам корпус. Переписанный в прозу, он расходится с ним на первом
же пополнении, и расходится **молча**: фраза остаётся грамматически исправной
и правдоподобной, а проверить её можно только пересчётом, которого никто не
делает.
Сослаться можно двумя способами, и ни один не стареет:
| Как | Пример |
| --- | --- |
| на конкретную запись — именем, слагом, датой | «ревью от 3 августа», `adr/0007-queue-as-table.md`, capability `recognition` |
| на корпус целиком | «ревью проекта», «capability, объявленные в `openspec/specs/`» |
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
**Замер с провенансом — не счёт корпуса.** «Прозаический триггер дал 6
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
«изменится ли число само, без правки текста».
**Число, стоящее заголовком к перечню, приведённому тут же, правилом не
задето.** «Три исхода:» с тремя пунктами под ним — не ссылка на корпус, и
расходится оно не втихую, а вместе со списком, который правят в той же
строке. Уехал перечень в другой файл — число уезжает с ним, а на его месте
остаётся ссылка.
<!-- /копия: язык-правила -->
### Что из этих правил докладывается особым образом
@@ -170,6 +198,14 @@ color: green
ходу. Находка — готовое английское имя на замену плюс напоминание про перенос
ссылок одним проходом.
**Правило 10, счёт корпуса.** Пересчитывать корпус не надо: находка — в самом
числе, а не в том, что оно разошлось. Число, совпадающее с действительностью
сегодня, — та же находка: завтра оно разойдётся, и молча. Предложение — готовая
замена: ссылка на конкретную запись или называние корпуса целиком. Перечень,
приведённый тут же под числом, не трогай. Чаще всего счёт заводится в
`architecture.md` («три источника», «пять единых точек») и в `review.md`, где
пересказывают журнал.
## Чего ты не проверяешь
Не своё бывает двух разных родов, и поступают с ними по-разному.
+37 -1
View File
@@ -1,6 +1,6 @@
---
name: task-wording
description: "Вычитка языка записей каталога задач по информационному стилю — задачи, строки индекса и причины отказа. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в слаге. Отдаёт готовые формулировки на замену и ничего не правит сам. Форму записи (заголовок по типу, «зачем», границы, оракулы) смотрит отдельный агент task-form, документы проекта вычитывает doc-wording. Использовать после заведения или разбора пачки записей, до взятия в работу и на переоценке беклога. Только чтение."
description: "Вычитка языка записей каталога задач по информационному стилю — задачи, строки индекса и причины отказа. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в слаге, счёт корпуса числом вместо ссылки («три эндпоинта», «четыре миграции»). Отдаёт готовые формулировки на замену и ничего не правит сам. Форму записи (заголовок по типу, «зачем», границы, оракулы) смотрит отдельный агент task-form, документы проекта вычитывает doc-wording. Использовать после заведения или разбора пачки записей, до взятия в работу и на переоценке беклога. Только чтение."
tools: Read, Grep, Glob
model: sonnet
color: green
@@ -160,6 +160,34 @@ color: green
коммитах и путях, которые набирают руками. Переименование — **перенос ссылок
одним проходом**, а не правка одного файла.
10. **Счёт корпуса не пишется словами.** «Пять ревью», «три capability»,
«десять проходов», «четыре документа канона» — это факт о корпусе, а дом у
такого факта сам корпус. Переписанный в прозу, он расходится с ним на первом
же пополнении, и расходится **молча**: фраза остаётся грамматически исправной
и правдоподобной, а проверить её можно только пересчётом, которого никто не
делает.
Сослаться можно двумя способами, и ни один не стареет:
| Как | Пример |
| --- | --- |
| на конкретную запись — именем, слагом, датой | «ревью от 3 августа», `adr/0007-queue-as-table.md`, capability `recognition` |
| на корпус целиком | «ревью проекта», «capability, объявленные в `openspec/specs/`» |
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
**Замер с провенансом — не счёт корпуса.** «Прозаический триггер дал 6
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
«изменится ли число само, без правки текста».
**Число, стоящее заголовком к перечню, приведённому тут же, правилом не
задето.** «Три исхода:» с тремя пунктами под ним — не ссылка на корпус, и
расходится оно не втихую, а вместе со списком, который правят в той же
строке. Уехал перечень в другой файл — число уезжает с ним, а на его месте
остаётся ссылка.
<!-- /копия: язык-правила -->
### Что из этих правил докладывается особым образом
@@ -180,6 +208,14 @@ color: green
английский слаг на замену плюс напоминание, что переименование это перенос
ссылок одним проходом, а не правка одного файла.
**Правило 10, счёт корпуса.** Пересчитывать корпус не надо: находка — в самом
числе, а не в том, что оно разошлось. Число, верное сегодня, — та же находка. В
записях счёт заводится в «Затрагивает» («три эндпоинта», «четыре миграции») и в
критериях приёмки, и там он опаснее прочего: критерий, сверяемый по числу,
пройдёт на другом составе работ. Предложение — готовая замена: перечислить
поимённо или назвать корпус целиком. Перечень, приведённый тут же под числом, не
трогай.
## Чего ты не проверяешь
Не своё бывает двух разных родов, и поступают с ними по-разному.