Files
dev-skills/decisions/23-wording-split-two-passes.md
T
av bf6a173115 журнал решений: разложен по теме на файл, метки решений стали номерами
- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
2026-08-13 12:40:56 +03:00

4.7 KiB
Raw Blame History

23. Вычитка разделена на два прохода (2026-08-04)

Что было

В уставе агента вычитки стоял заголовок «Форма записи — только для docs/tasks/items/». Условная половина устава: на документе канона она молчит, на задаче включается.

Решено

Р95. Проходов два: task-form и doc-wording. Разделены не по охвату — по глубине. Язык проверяется по словам и фразам, поштучно, и это подметание: залог, оценки, стоп-слова, англицизмы, жаргон. Форма записи требует понять, что задача делает, и открыть файл цели, на которую она ссылается, чтобы сверить, какую строку «Завершения» задача двигает. Слитый проход одну половину делает дорогой, а вторую — поверхностной.

Отсюда и разные модели: doc-wording — sonnet, task-form — opus. Первый подметает, второй судит смысл, и ровно на суждении обкатка показала провал — агент сам себе объяснил находку «принятым стилем каталога» (тема 22).

Р96. Условная половина устава — плохая конструкция сама по себе. Правило, которое «применяется только если», агент применяет по своему усмотрению, а усмотрение и есть то, чего от него не ждут. Два коротких устава без условий надёжнее одного длинного с ними — и это довод, годный за пределами этого случая.

Р97. Каждый устав отказывается от чужой половины прямо. «Увидел не по своей части — скажи строкой в границах покрытия, не находкой». Без такого отказа две проверки одного места расходятся и начинают спорить, а разнимать их потом дороже, чем не сводить. Исключение ровно одно и названо: неудачное слово в заголовке судит task-form, потому что заголовок целиком его.

Р98. Порог правки переехал в дом и копируется в оба устава. Он теперь в language.md помеченным домом порог-правки: правка без нарушенного правила не делается, систематичность нарушения — не довод в его пользу. Дублировать его руками в двух уставах значило бы получить два разных порога через месяц.

Что из этого следует

С91. Шестое правило task-form — единственное, что читает больше одного файла. Оно же единственное, что смотрит набор, а не запись: строка «Завершения», к которой не относится ни одна поданная задача, докладывается отдельным блоком. Это граница между вычиткой и разбором, и она проведена внутри правила, а не между агентами.

С92. Порядок вызова — сперва task-form. Его находки меняют решение «брать или не брать», а язык — только цену чтения; и переписанный заголовок бессмысленно вычитывать до того, как он переписан.

С93. Помеченных копий стало шесть при пяти домах. Механизм scripts/copies.py впервые используется не для скелетов канона, а чтобы удержать одно правило в двух уставах подрядчиков. Случай тот же: текст обязан быть на месте, потому что подрядчик по ссылкам не ходит.