журнал решений: разложен по теме на файл, метки решений стали номерами

- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
This commit is contained in:
av
2026-08-13 12:40:56 +03:00
parent b411d4edb8
commit bf6a173115
72 changed files with 4253 additions and 4053 deletions
+54
View File
@@ -0,0 +1,54 @@
# 32. Сквозной проход по словарю: пять слов сняты, девять закрыты списком (2026-08-05)
Проход упрощения ([тема 31](31-pm-coverage-product-review.md)) уткнулся в один и
тот же класс у всех пяти агентов: слово, живущее в трёх-шести файлах разом.
Правка в одном месте развела бы словарь, правка во всех — уже не упрощение
текста скилла. Каждый агент честно остановился и записал слово в свой отчёт, и
одни и те же слова всплыли в разных отчётах. Разобрано отдельным проходом.
**Р131. «Слово прижилось» не проверяется, поэтому заменено списком.** Оговорка в
`language.md` звучала так: не переводится «термин, у которого нет точного
русского эквивалента и который в команде уже прижился». Проверить это на глаз
нельзя — прижившимся выглядит любое слово, встреченное трижды, и ровно так пять
агентов подряд и рассудили. Оговорка заменена **закрытым списком из девяти
терминов** с колонкой «что называет»: интейк, триаж, провенанс, дедуп, чек-лист,
дифф, промпт, сущности OpenSpec, роды проходов ревью. Слово не из списка и не из
таблицы имён вещей — находка, а не принятый стиль.
Список заведён домом `язык-словарь` в `language.md` и копией в уставе
`doc-wording`. Копия обязательна: агент работает в репозитории проекта, где
плагина может не быть, и без списка предъявил бы «интейк» как англицизм.
**Р132. Пять слов сняты, и все пятеро выглядели словарём, не будучи им.**
`конфляция` → смешение (4 места), `декорреляция` → разведённость (6),
`непоймание` → почему не поймали (9), `эвал-сет` → проверочный набор (4), `гайд`
→ руководство (6). Латинизм или калька при живом русском слове в каждом случае.
Разбор `декорреляции` показателен: проект **уже владел** нужным словом — «агенты
разведены по глубине», «разведены по охвату» — и держал рядом латинский синоним
того же понятия. Это не англицизм, а второй дом для слова.
`непоймание` снято ещё и потому, что форма журнала дефектов, которую канон кладёт
в проекты, спрашивает «Почему не поймали» — а проза рядом называла это
«причиной непоймания». Скелет и проза о скелете говорили разными словами.
**Р133. Снятое записано вместе с оставленным, в одном списке.** Иначе снятое
возвращается: слово уходит из текстов, но ничто не мешает следующему проходу
завести его заново — оно ведь короткое и точное. Пять слов названы поимённо с
заменой каждого.
## Что из этого следует
**С124. Escape hatch без перечня — это разрешение, а не исключение.** «Термин,
который прижился» освобождает от правила любое слово: проверка «прижился ли»
возвращает «да» всякий раз, когда слово встретилось. Исключение из правила
обязано быть списком, иначе оно съедает правило.
**С125. Слово, от которого агент отказался править, — материал для отдельного
прохода, а не мусор отчёта.** Пять независимых агентов сошлись на одном наборе
слов, ни разу друг друга не видя. Список «что не тронул» оказался полезнее
списка правок именно этим.
**С126. Снятое слово называется вместе с заменой и остаётся записанным.** Убрать
из текстов недостаточно: без записи «это снято и вот чем заменено» слово
возвращается первым же, кто найдёт его удачным.