av
bf6a173115
- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель; - буквенные метки решений заменены сквозными Р1–Р234, следствия получили префикс С при прежних номерах: схема букв выродилась до пятибуквенных и сломалась — `АЕАКЛ` была занята и темой 53, и темой 65; - 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер означал тему, а слово стояло «решение», формулировка исправлена.
67 lines
6.1 KiB
Markdown
67 lines
6.1 KiB
Markdown
# 21. Язык проектных текстов — информационный стиль (2026-08-04)
|
|
|
|
## Что было
|
|
|
|
Языковые правила лежали внутри скилла `tasks`, в разделе «Как написана задача»:
|
|
англицизмы, неизвестные термины, «сложность формулировки — не признак сложности
|
|
работы». Три пункта, выведенные из практики, без общей опоры и без ответа на
|
|
вопрос «а что ещё сюда относится».
|
|
|
|
Дал ссылку на чужой скилл `prepare-jira-text` — там раздел «Язык» с
|
|
информационным стилем, таблицей англицизмов-калек и таблицей жаргона. Заодно
|
|
попросил найти справку об информационном стиле Максима Ильяхова и адаптировать
|
|
его.
|
|
|
|
## Решено
|
|
|
|
**Р89. У языка появился один дом — `canon/references/language.md`.** Не в
|
|
`tasks`, хотя пришёл он оттуда: правила относятся к документам канона, решениям
|
|
ADR, запискам разведки и сообщениям коммитов в той же мере, что к задачам, а
|
|
каталог задач и сам часть `docs/`. Раскладка отвечает, **где** текст лежит; этот
|
|
файл — **каким он должен быть**. `tasks/SKILL.md` оставил у себя четыре правила,
|
|
которые нарушаются чаще прочих, и ссылку.
|
|
|
|
**Р90. Инфостиль взят не целиком, и отброшенное названо вслух.** Он написан для
|
|
рекламы, статей и писем — текстов, где читателя надо удержать; проектный текст
|
|
читают потому, что надо. Взято: полезное действие, глагол вместо отглагольного
|
|
существительного, активный залог, факт вместо оценки, стоп-слова, «одна мысль —
|
|
одно предложение», параллельность, работающий заголовок. Отброшено:
|
|
**парцелляция** (рубленые фразы ломают причинную связь, а в решении ценность
|
|
именно в ней), **запрет вводных целиком** («если», «иначе», «в отличие от» — это
|
|
условия, то есть сведения), **запрет скобок и точки с запятой** (в технической
|
|
записи скобки несут уточнение — имя команды, единицы, слаг). Многоточие
|
|
запрещено: в проектном тексте оно значит «дописать позже».
|
|
|
|
Раздел «Что отброшено намеренно» написан не для полноты. Без него правило
|
|
читается как «пиши короче», и первый же агент начинает резать «поэтому» и
|
|
«иначе» — то есть ровно то, ради чего текст и писался.
|
|
|
|
**Р91. «Снять корону» переведено на здешнего читателя.** У Ильяхова это «надеть
|
|
корону на клиента». Здесь клиент — **ты сам через квартал** и тот, кто возьмёт
|
|
задачу. Отсюда конкретное требование: называть состояние и остаток, а не
|
|
пересказывать, как было интересно разбираться.
|
|
|
|
**Р92. Таблицы англицизмов и жаргона уехали в агента помеченной копией.** Устав
|
|
агента обязан быть самодостаточным — он не разрешает пути плагина и не ходит по
|
|
ссылкам, — а два дома у одного правила уже трижды расходились. Механизм для
|
|
этого в репозитории есть (`scripts/copies.py`), и это ровно его случай: копия
|
|
дословная и помеченная, проверка ловит расхождение.
|
|
|
|
## Что из этого следует
|
|
|
|
**С86. У агента вычитки правил стало двенадцать, и они разделены на две
|
|
группы.** «Форма записи» верна только для каталога задач, «язык» — для любого
|
|
проектного текста. Разделение не косметическое: находки докладываются группами и
|
|
в этом порядке, потому что форма меняет решение «брать или не брать», а язык —
|
|
только цену чтения.
|
|
|
|
**С87. Порог правки записан дважды и одинаково** — в `language.md` и в уставе
|
|
агента: правка без нарушенного правила не делается. Это единственная защита от
|
|
списка, в котором половина замечаний вкусовые: такой список перестают читать
|
|
целиком, и настоящие находки пропадают вместе с ним.
|
|
|
|
**С88. Переезд на канон 3 языком ничего не требует.** Шаг в changelog так и
|
|
записан: прочитать и ничего не переписывать задним числом. Сплошная вычитка
|
|
старых документов стоит дороже, чем даёт, а правила применяются к тому, что
|
|
правится сейчас.
|