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

3.5 KiB
Raw Blame History

22. Обкатка агента вычитки: имя, охват и «так везде» (2026-08-04)

Что было

Агента вычитки прогнали по тестовому набору — 13 записей выдуманного проекта. Устав он читал сам, как обычный подрядчик.

Решено

Р93. Агент называется doc-wording, а не task-wording. Имя пришло из задач, но правила языка относятся ко всем проектным текстам: документам канона, решениям ADR, запискам разведки. Форма записи — вторая половина устава — верна только для файлов docs/tasks/items/, и теперь это сказано заголовком раздела, а не подразумевается. Вход агента расширен: список файлов или каталог, вперемешку тоже.

Р94. «Так сделано везде» — не оправдание, а признак. Агент нашёл, что раздел «Затрагивает» в нескольких записях называет не только границу, но и её будущее состояние («источник хода становится двумя»), — и промолчал, объяснив это принятым стилем каталога. Записи писал один агент за один заход: систематичность здесь значит ровно обратное — правило не применялось вовсе.

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

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

С89. Находка агента попала в слово из собственного скилла. «Цель про станок, а не про игру» — метафора, которую я перенёс в тестовую запись из tasks/SKILL.md. Проверка показала худшее: станок в каноне уже занят — «общий станок» это красная проверка, врывающаяся в замороженный спринт (canon.md, session/SKILL.md). Одно слово в двух смыслах, тот же класс, что и окружение в теме 19. В tasks/SKILL.md заменено на «работа над инструментом и процессом» — как названа и секция роадмапа.

С90. Одна находка на 13 записей — не провал вычитки. Тексты писались сразу по правилам, и находить в них было почти нечего. Показательно другое: агент удержал порог (вкусовых правок не предложил) и явно сказал, по чему проверял термины, — то есть отработали обе защиты, а не только та, что ищет.