агент вычитки переименован в doc-wording и расширен на все документы
Имя пришло из задач, но правила языка относятся ко всем проектным текстам: документам канона, решениям ADR, запискам разведки. Форма записи — вторая половина устава — верна только для файлов docs/tasks/items/, и теперь это сказано заголовком раздела, а не подразумевается. Вход расширен: список файлов или каталог, вперемешку тоже. Обкатка на тестовом наборе из 13 записей показала дыру в пороге вмешательства. Агент нашёл, что раздел «Затрагивает» в нескольких записях называет не только границу, но и её будущее состояние, — и промолчал, объяснив это принятым стилем каталога. Записи писал один агент за один заход: систематичность здесь значит ровно обратное — правило не применялось вовсе. В устав добавлено: одна и та же ошибка в пяти файлах даёт одну находку на весь набор с перечнем, но не даёт права промолчать. Принятым стилем считается только то, что назвал зовущий или что записано в конвенциях проекта. Единственная находка агента попала в слово из собственного скилла. «Цель про станок, а не про игру» — метафора, перенесённая в тестовую запись из tasks/SKILL.md. Проверка показала худшее: «станок» в каноне уже занят, «общий станок» это красная проверка, врывающаяся в замороженный спринт (canon.md, session/SKILL.md). Одно слово в двух смыслах, тот же класс, что и «окружение» в теме 19. Заменено на «работа над инструментом и процессом» — как названа и секция роадмапа. DECISIONS тема 22 (ППП, РРР, следствия 89–90). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
+41
-1
@@ -1486,7 +1486,7 @@ SSS: рубрика на узел без нового понятия порож
|
||||
беклог, заведённый до правила, переоформляют не «заодно» — десятки одинаковых
|
||||
строк научили бы пропускать весь блок.
|
||||
|
||||
**ЗЗЗ. Годность формулировки судит отдельный агент `task-wording`, а не чек-лист
|
||||
**ЗЗЗ. Годность формулировки судит отдельный агент `doc-wording`, а не чек-лист
|
||||
в скилле.** Самопроверка текста слабее всего там, где формулировка казалась
|
||||
удачной при написании, — а пишет и проверяет иначе один и тот же агент в одном
|
||||
контексте. Агент читает пачку записей и возвращает **готовые формулировки на
|
||||
@@ -1595,3 +1595,43 @@ ADR, запискам разведки и сообщениям коммитов
|
||||
записан: прочитать и ничего не переписывать задним числом. Сплошная вычитка
|
||||
старых документов стоит дороже, чем даёт, а правила применяются к тому, что
|
||||
правится сейчас.
|
||||
|
||||
## 22. Обкатка агента вычитки: имя, охват и «так везде» (2026-08-04)
|
||||
|
||||
### Что было
|
||||
|
||||
Агента вычитки прогнали по тестовому набору — 13 записей выдуманного проекта.
|
||||
Устав он читал сам, как обычный подрядчик.
|
||||
|
||||
### Решено
|
||||
|
||||
**ППП. Агент называется `doc-wording`, а не `task-wording`.** Имя пришло из
|
||||
задач, но правила языка относятся ко всем проектным текстам: документам канона,
|
||||
решениям ADR, запискам разведки. Форма записи — вторая половина устава — верна
|
||||
только для файлов `docs/tasks/items/`, и теперь это сказано заголовком раздела,
|
||||
а не подразумевается. Вход агента расширен: список файлов или каталог, вперемешку
|
||||
тоже.
|
||||
|
||||
**РРР. «Так сделано везде» — не оправдание, а признак.** Агент нашёл, что раздел
|
||||
«Затрагивает» в нескольких записях называет не только границу, но и её будущее
|
||||
состояние («источник хода становится двумя»), — и **промолчал**, объяснив это
|
||||
принятым стилем каталога. Записи писал один агент за один заход: систематичность
|
||||
здесь значит ровно обратное — правило не применялось вовсе.
|
||||
|
||||
В устав добавлено: одна и та же ошибка в пяти файлах даёт **одну находку на весь
|
||||
набор** с перечнем, но не даёт права промолчать. Принятым стилем считается
|
||||
только то, что назвал зовущий или что записано в конвенциях проекта.
|
||||
|
||||
### Что из этого следует
|
||||
|
||||
89. **Находка агента попала в слово из собственного скилла.** «Цель про станок,
|
||||
а не про игру» — метафора, которую я перенёс в тестовую запись из
|
||||
`tasks/SKILL.md`. Проверка показала худшее: `станок` в каноне уже занят —
|
||||
«общий станок» это красная проверка, врывающаяся в замороженный спринт
|
||||
(`canon.md`, `session/SKILL.md`). Одно слово в двух смыслах, тот же класс,
|
||||
что и `окружение` в теме 19. В `tasks/SKILL.md` заменено на «работа над
|
||||
инструментом и процессом» — как названа и секция роадмапа.
|
||||
90. **Одна находка на 13 записей — не провал вычитки.** Тексты писались сразу по
|
||||
правилам, и находить в них было почти нечего. Показательно другое: агент
|
||||
удержал порог (вкусовых правок не предложил) и явно сказал, по чему проверял
|
||||
термины, — то есть отработали обе защиты, а не только та, что ищет.
|
||||
|
||||
Reference in New Issue
Block a user