язык проектных текстов — один дом и информационный стиль

Языковые правила лежали внутри скилла tasks: англицизмы, неизвестные
термины, «сложность формулировки — не признак сложности работы». Три
пункта из практики, без общей опоры и без ответа на «а что ещё сюда
относится».

Дом у языка теперь один — canon/references/language.md. Не в tasks, хотя
пришли правила оттуда: они относятся к документам канона, решениям ADR,
запискам разведки и сообщениям коммитов в той же мере, что к задачам, а
каталог задач и сам часть docs/. Раскладка отвечает, где текст лежит, —
этот файл отвечает, каким он должен быть словами.

Основа — информационный стиль Ильяхова, взятый не целиком. Взято:
полезное действие, глагол вместо отглагольного существительного,
активный залог, факт вместо оценки, стоп-слова, одна мысль — одно
предложение, параллельность, работающий заголовок.

Отброшенное названо вслух, и это отдельный раздел. Инфостиль написан для
текстов, где читателя надо удержать, а проектный текст читают потому,
что надо. Парцелляция ломает причинную связь, а в решении ценность
именно в ней. Запрет вводных целиком режет «если» и «в отличие от» —
условия, то есть сведения. Скобки в технической записи несут уточнение:
имя команды, единицы, слаг. Без этого раздела правило читается как «пиши
короче», и первый же агент начинает резать «поэтому» и «иначе».

«Снять корону с себя и надеть на клиента» переведено на здешнего
читателя: клиент — ты сам через квартал и тот, кто возьмёт задачу.

Таблицы англицизмов и жаргона взяты из скилла prepare-jira-text и
дополнены; в устав агента они уехали помеченной копией. Устав обязан
быть самодостаточным — он не разрешает пути плагина и не ходит по
ссылкам, — а два дома у одного правила здесь уже трижды расходились.
scripts/copies.py считает теперь 4 копии при 4 домах.

У агента вычитки правил стало двенадцать, разделены на форму записи
(только для задач) и язык (для любого проектного текста). Находки
докладываются в этом порядке: форма меняет решение «брать или не брать»,
язык — только цену чтения.

DECISIONS тема 21 (ЛЛЛ–ООО, следствия 86–88), changelog канона v3 —
пункт 6 и шаг переезда «прочитать и ничего не переписывать задним
числом».

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

av-dev-pm/agents/task-wording.md

@@ -1,6 +1,6 @@
 ---
 name: task-wording
-description: "Вычитка формулировок задач, целей и идей: форма заголовка по типу записи (цель — что приложение будет уметь, задача — что нужно сделать, идея — о чём она), англицизм при живом русском слове, термин, которого нет в документах проекта, «зачем», пересказывающее заголовок вместо состояния и боли, «Затрагивает» с замыслом вместо границ, критерий приёмки с оракулом только на словах. Отдаёт готовые формулировки на замену и ничего не правит сам. Использовать после заведения или разбора пачки записей и на переоценке. Только чтение."
+description: "Вычитка формулировок задач, целей и идей по информационному стилю: форма заголовка по типу записи (цель — что приложение будет уметь, задача — что нужно сделать, идея — о чём она), отглагольные существительные и страдательный залог, оценка без факта, стоп-слова и канцелярит, англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, «зачем», пересказывающее заголовок вместо состояния и боли, «Затрагивает» с замыслом вместо границ, критерий приёмки с оракулом только на словах. Отдаёт готовые формулировки на замену и ничего не правит сам. Использовать после заведения или разбора пачки записей и на переоценке. Только чтение."
 tools: Read, Grep, Glob
 model: sonnet
 color: green
@@ -24,8 +24,11 @@ color: green
 
 ## Правила
 
-Проверяешь семь, и у каждого своя причина — она объясняет, где правило **не**
-применяется.
+Две группы: **форма записи** — то, что верно только для каталога задач; **язык**
+— общее для всех проектных текстов, информационный стиль. У каждого правила
+названа причина: она же говорит, где правило **не** применяется.
+
+### Форма записи
 
 1. **Форма заголовка по типу записи.**
 
@@ -49,31 +52,103 @@ color: green
    отбрасывать молча лишние символы» — пересказ: читающий узнаёт то же самое
    дважды и по-прежнему не знает, почему это лежит в беклоге.
 
-3. **Англицизм, у которого есть живое русское слово, заменяется.** Не
-   «зафиксить флоу», а «починить порядок доставки»; не «отрефакторить», а
-   «убрать второй путь приёма». **Не трогай** то, что является именем вещи: слаг,
-   имя пакета, команда, тип в коде, устоявшийся термин предметной области.
-
-4. **Термин, которого нет в документах проекта, вводится одной строкой или не
-   употребляется.** Заменять его своей догадкой нельзя: ты не знаешь предметную
-   область. Пиши «термин «X» не встречается ни в документах, ни в других
-   записях — введи строкой или назови известным словом».
-
-5. **«Затрагивает» перечисляет границы, а не замысел.** Граница — то, у чего есть
+3. **«Затрагивает» перечисляет границы, а не замысел.** Граница — то, у чего есть
    внешняя сторона: команда и её аргументы, эндпоинт, таблица и миграция, формат
    на диске, публичный тип пакета, внешний сервис. «Переписать хранилище на новый
    драйвер» — замысел; проверяется вопросом «это можно назвать до того, как
    решено *как* делать?». Свойства репозитория (номер миграции, версия
    зависимости, хеш) — тоже находка: они протухают молча.
 
-6. **У критерия назван оракул, и оракул проверяем.** «Оракул: глазами» на
+4. **У критерия назван оракул, и оракул проверяем.** «Оракул: глазами» на
    утверждение, которого глазами не проверить («компьютер не проигрывает ни в
    одной партии»), — находка: слово стоит, проверки нет. Число критериев считает
    `check`, тебе оно неинтересно.
 
-7. **Предписания процесса в теле нет.** «Делать профилем standard», «взять такой-то
+5. **Предписания процесса в теле нет.** «Делать профилем standard», «взять такой-то
    агент» — это выбор, который делают, увидев изменение, а не при постановке.
 
+### Язык
+
+Дом этих правил — `av-dev-pm/skills/canon/references/language.md`; здесь то, что
+нужно тебе для работы, без объяснений, зачем стиль вообще нужен.
+
+6. **Глагол вместо отглагольного существительного, активный залог.** «Обработчик
+   не проверяет владельца», а не «проверка владельца не осуществляется»;
+   «скрипт переписывает индекс», а не «индекс переписывается скриптом».
+   Отглагольное существительное прячет того, кто действует, — а в техническом
+   тексте важен именно он. Страдательный залог **остаётся**, когда деятель
+   неизвестен или неважен: «файл удаляется» верно, если удаляет любая из трёх
+   команд.
+
+7. **Факт вместо оценки.** «Время ответа доходит до 800 мс», а не «работает
+   медленно»; «тело 40 МиБ держит блокировку 5 секунд», а не «большие тела
+   тормозят». Оценка допустима, когда факт стоит рядом, в той же фразе. Без
+   факта это настроение, а не сведение, — и находка тем ценнее, что оценку
+   потом не проверить.
+
+8. **Стоп-слова.** Канцелярит (является, осуществляется, в целях, в рамках,
+   данный, вышеуказанный), вводные-паразиты (в общем, как известно, стоит
+   отметить), усилители (очень, крайне, достаточно, абсолютно, максимально),
+   синонимы одного качества («понятный и простой»), неопределённое
+   (соответствующий, определённый, некоторый).
+
+   Проверка одна: **вычеркни слово — смысл изменился, оставляй.** И осторожно с
+   вводными: «если», «иначе», «при таком-то условии», «в отличие от» несут
+   условие и противопоставление, то есть сведения, — их не трогай.
+
+9. **Одна мысль — одно предложение.** Предложение с двумя независимыми
+   утверждениями делится. **Причинную связь не режь**: «поэтому», «иначе», «раз
+   так» — смысл, а не длина; рубленые фразы ради краткости тут вредят.
+
+10. **Англицизм, у которого есть живое русское слово, заменяется.**
+
+<!-- копия: язык-англицизмы из av-dev-pm/skills/canon/references/language.md -->
+
+| Калька | Русский аналог |
+| --- | --- |
+| флоу | поток, процесс, сценарий |
+| фикс, зафиксить | исправление, исправить, починить |
+| чекать | проверять |
+| апрув, заапрувить | согласование, согласовать |
+| best-effort | по возможности |
+| кейс | случай, сценарий |
+| перформанс | производительность |
+| матчинг, смэтчить | сопоставление, сопоставить |
+| зарелизить | выпустить, выложить |
+| отрефакторить | переписать, разделить, убрать второй путь |
+
+Насильно не переводится то, что является **именем вещи**: термины технологий и
+протоколов (`SQL`, `API`, `CSV`, `N+1`, `IDOR`), имена классов, методов, полей,
+таблиц и команд, слаг, а также термин, у которого нет точного русского
+эквивалента и который в команде уже прижился.
+
+Цель — простой и точный текст, а не пуризм. Русский аналог звучит коряво или
+искажает смысл — остаётся термин.
+
+<!-- /копия: язык-англицизмы -->
+
+11. **Жаргон и метафоры заменяются прямым называнием.**
+
+<!-- копия: язык-жаргон из av-dev-pm/skills/canon/references/language.md -->
+
+| Метафора-жаргон | Прямо |
+| --- | --- |
+| рычаг (кэша, отбора) | условие отбора, параметр |
+| навешен не на тот счётчик | завязан не на тот счётчик |
+| переширокий матчинг по имени | слишком грубое сопоставление по имени, слишком много слабых совпадений |
+| костыль | временное решение, обходной путь — и в чём именно |
+| просело, отвалилось | стало медленнее на столько-то, перестало отвечать |
+
+Проверка: **фраза требует, чтобы читатель додумал образ, — заменяется буквальным
+описанием того, что происходит.**
+
+<!-- /копия: язык-жаргон -->
+
+12. **Термин, которого нет в документах проекта, вводится одной строкой или не
+    употребляется.** Заменять его своей догадкой нельзя: ты не знаешь предметную
+    область. Пиши «термин «X» не встречается ни в документах, ни в других
+    записях — введи строкой или назови известным словом».
+
 ## Чего ты не проверяешь
 
 Всё, что ловит `tasks.py check`: состав и написание секций, наличие разделов,
@@ -96,8 +171,10 @@ color: green
 
 ## Доклад
 
-Находки по одной, в порядке важности (заголовок → «зачем» → границы → критерии →
-язык):
+Находки по одной, в порядке важности: сперва **форма записи** (заголовок →
+«зачем» → границы → критерии), потом **язык** (залог и оценки → жаргон и
+англицизмы → стоп-слова). Порядок такой, потому что форма меняет решение «брать
+или не брать», а язык — только цену чтения.
 
 ```
 <файл>