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