язык: счёт корпуса в прозе запрещён правилом 10
«Пять ревью», «три capability», «десять проходов» читаются как сведение, а живут до ближайшего пополнения корпуса. Расхождение молчаливое вдвойне: фраза остаётся грамматически исправной, диффом не ловится — правят не её, а корпус, — и проверяется только пересчётом, которого никто не делает. Сослаться можно двумя способами, и оба не стареют: на конкретную запись именем, слагом или датой либо на корпус целиком. Величину называет сам каталог в момент чтения, а абзац её только запоминает. Две границы названы явно, иначе правило запретило бы форму, на которой держится половина процессных текстов. Число-заголовок к перечню, приведённому тут же, не задето: правят его в той же строке, что и список. Замер с провенансом не задет тоже — он про прошлое и не пополняется. Разделяет вопрос «изменится ли число само, без правки текста». Судит вычитка, пофразно: правило уехало помеченной копией в уставы doc-wording и task-wording, у обоих названы частое место находки и запрет пересчитывать корпус — находка в самом числе, а не в его неверности. Описания агентов дополнены, чтобы не отстать от механики. В карте домов канона стоит ссылка: счёт корпуса выглядит не копией, а собственным наблюдением документа. Собственная проза приведена к правилу: девять правил языка (их стало десять этим же коммитом), десять агентов-проходов и девять скиллов в README, восемь скриптов в перечне осей, шесть тем ядра в сценарии решения и в конвейере ревью, семь проходов в правилах нарезки.
This commit is contained in:
@@ -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`, где
|
||||
пересказывают журнал.
|
||||
|
||||
## Чего ты не проверяешь
|
||||
|
||||
Не своё бывает двух разных родов, и поступают с ними по-разному.
|
||||
|
||||
Reference in New Issue
Block a user