словарь: пять слов сняты, девять закрыты списком вместо оговорки «прижилось»

Проход упрощения уткнулся в один класс у всех пяти агентов: слово, живущее в
трёх-шести файлах разом. Правка в одном месте развела бы словарь, правка во
всех — уже не упрощение текста скилла. Каждый честно остановился и записал слово
в отчёт, и одни и те же слова всплыли в разных отчётах. Разобрано этим проходом.

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

Список заведён домом язык-словарь в language.md и копией в уставе doc-wording.
Копия обязательна: агент работает в репозитории проекта, где плагина может не
быть, и без списка предъявил бы интейк как англицизм.

Снято пять слов, 29 мест: конфляция → смешение, декорреляция → разведённость,
непоймание → почему не поймали, эвал-сет → проверочный набор, гайд →
руководство. Латинизм или калька при живом русском слове в каждом случае.

Разбор декорреляции показателен: проект уже владел нужным словом — «агенты
разведены по глубине», «разведены по охвату» — и держал рядом латинский синоним
того же понятия. Это не англицизм, а второй дом для слова.

Непоймание снято ещё и потому, что форма журнала дефектов, которую канон кладёт
в проекты, спрашивает «Почему не поймали», а проза рядом называла это «причиной
непоймания». Скелет и проза о скелете говорили разными словами.

Снятое записано вместе с оставленным, в одном списке и с заменой каждого. Иначе
слово возвращается: из текстов оно уходит, но ничто не мешает следующему проходу
завести его заново — оно ведь короткое и точное на вид.

Тема 32 в DECISIONS.md, следствия 124-126. Нумерация правил в уставе doc-wording
сдвинута: словарь встал шестым, жаргон и далее уехали на единицу.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-05 15:35:06 +03:00
co-authored by Claude Opus 5
parent 47a2f3de63
commit cbfae90f3f
19 changed files with 152 additions and 39 deletions
+56 -3
View File
@@ -261,7 +261,7 @@ jellybit — секреты в `conventions/config.md`. **Периметра н
проверять сознательно` требует ссылки на его запись.
**L. Журнал расширяется до всех воспроизведённых дефектов** с пометкой
«проскочил / пойман ревью». Эвал-сет для калибровки — выборка по пометке.
«проскочил / пойман ревью». Проверочный набор для калибровки — выборка по пометке.
*Причина:* пойманные дефекты с оракулом (768 МиБ пика, 5.019 с удержания
блокировки) сегодня не сохраняются нигде, кроме отчётов триажа в архиве change, а
@@ -1031,7 +1031,7 @@ HTML-комментарии, невидимые в отрендеренном ma
**AAA. Ребро — это порядок, никогда не данные.** В обычном графе задач ребро
тянет за собой вывод предшественника; здесь это запрещено: проход, увидевший
чужие находки, соглашается с ними, и декорреляция — вся ценность конвейера —
чужие находки, соглашается с ними, и разведённость — вся ценность конвейера —
обнуляется. Сказано в самом правиле, потому что графовый словарь провоцирует
ровно эту ошибку. Исключение одно и оно же сток: триаж.
@@ -1879,7 +1879,7 @@ ADR, запискам разведки и сообщениям коммитов
**ЖЖЗЗ. Поле места назвали по типу, а не одним словом на всех.** «Категория»
вместо «Секции» — просьба заметки, но одинаковое переименование закрепило бы
конфляцию: у задачи поле называет полку домена, в которую она вернётся из
смешение: у задачи поле называет полку домена, в которую она вернётся из
спринта, у цели — часть роадмапа, то есть состояние очереди. Разные имена
(`Категория` / `Секция`) выбраны именно потому, что **какое поле обязательно,
решает тип** — то самое, ради чего затевалась вся правка.
@@ -2205,3 +2205,56 @@ dev-skills — **маркетплейс плагинов**: скилл комм
тот же проход, что делал шаги, — и двигает независимо от того, все ли
сделаны. Механической проверки существа нет; там, где её нет, ставится
судья, а не отметка.
## 32. Сквозной проход по словарю: пять слов сняты, девять закрыты списком (2026-08-05)
Проход упрощения (тема 31) уткнулся в один и тот же класс у всех пяти агентов:
слово, живущее в трёх-шести файлах разом. Правка в одном месте развела бы
словарь, правка во всех — уже не упрощение текста скилла. Каждый агент честно
остановился и записал слово в свой отчёт, и одни и те же слова всплыли в разных
отчётах. Разобрано отдельным проходом.
**ААББЛЛ. «Слово прижилось» не проверяется, поэтому заменено списком.** Оговорка
в `language.md` звучала так: не переводится «термин, у которого нет точного
русского эквивалента и который в команде уже прижился». Проверить это на глаз
нельзя — прижившимся выглядит любое слово, встреченное трижды, и ровно так пять
агентов подряд и рассудили. Оговорка заменена **закрытым списком из девяти
терминов** с колонкой «что называет»: интейк, триаж, провенанс, дедуп, чек-лист,
дифф, промпт, сущности OpenSpec, роды проходов ревью. Слово не из списка и не из
таблицы имён вещей — находка, а не принятый стиль.
Список заведён домом `язык-словарь` в `language.md` и копией в уставе
`doc-wording`. Копия обязательна: агент работает в репозитории проекта, где
плагина может не быть, и без списка предъявил бы «интейк» как англицизм.
**ААББММ. Пять слов сняты, и все пятеро выглядели словарём, не будучи им.**
`конфляция` → смешение (4 места), `декорреляция` → разведённость (6),
`непоймание` → почему не поймали (9), `эвал-сет` → проверочный набор (4), `гайд`
→ руководство (6). Латинизм или калька при живом русском слове в каждом случае.
Разбор `декорреляции` показателен: проект **уже владел** нужным словом — «агенты
разведены по глубине», «разведены по охвату» — и держал рядом латинский синоним
того же понятия. Это не англицизм, а второй дом для слова.
`непоймание` снято ещё и потому, что форма журнала дефектов, которую канон кладёт
в проекты, спрашивает «Почему не поймали» — а проза рядом называла это
«причиной непоймания». Скелет и проза о скелете говорили разными словами.
**ААББНН. Снятое записано вместе с оставленным, в одном списке.** Иначе снятое
возвращается: слово уходит из текстов, но ничто не мешает следующему проходу
завести его заново — оно ведь короткое и точное. Пять слов названы поимённо с
заменой каждого.
### Что из этого следует
124. **Escape hatch без перечня — это разрешение, а не исключение.** «Термин,
который прижился» освобождает от правила любое слово: проверка «прижился ли»
возвращает «да» всякий раз, когда слово встретилось. Исключение из правила
обязано быть списком, иначе оно съедает правило.
125. **Слово, от которого агент отказался править, — материал для отдельного
прохода, а не мусор отчёта.** Пять независимых агентов сошлись на одном
наборе слов, ни разу друг друга не видя. Список «что не тронул» оказался
полезнее списка правок именно этим.
126. **Снятое слово называется вместе с заменой и остаётся записанным.** Убрать
из текстов недостаточно: без записи «это снято и вот чем заменено» слово
возвращается первым же, кто найдёт его удачным.