агент вычитки переименован в 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:
@@ -24,7 +24,7 @@ description: Привести проект к канону документов
|
||||
информационный стиль, применённый к проектным текстам, таблицы англицизмов и
|
||||
жаргона. Раскладка отвечает, где текст лежит, — этот файл отвечает, каким он
|
||||
должен быть. Правила общие для документов канона, задач, решений ADR и
|
||||
записок разведки.
|
||||
записок разведки; вычитывает их отдельным проходом агент `doc-wording`.
|
||||
- [references/changelog.md](references/changelog.md) — журнал версий канона.
|
||||
|
||||
## Три правила, из которых всё следует
|
||||
|
||||
@@ -43,7 +43,7 @@ upgrade` идёт по записям снизу вверх от версии п
|
||||
символы»), цель — на «что приложение будет уметь», идея просто называет, о
|
||||
чём она. `check` считает заголовки не в форме действия и печатает число в
|
||||
блоке здоровья. Годность формулировки — не машине: её смотрит новый агент
|
||||
`task-wording` (вычитка формулировок, только чтение).
|
||||
`doc-wording` (вычитка формулировок, только чтение).
|
||||
5. **Заголовки секций — с прописной, после заголовка пустая строка**, во всех
|
||||
индексах. Написание канонических секций и отбивку правит `check --fix`; он
|
||||
же сводит написание секции в мете файла с заголовком индекса.
|
||||
@@ -108,7 +108,7 @@ upgrade` идёт по записям снизу вверх от версии п
|
||||
секцию в мете файлов с заголовками индексов. Секции беклога проект
|
||||
переименовывает сам — их имена он выбирал, и трогать их скрипт не вправе.
|
||||
11. Переписать заголовки задач в форму действия — по мере того, как задача
|
||||
попадает в работу, а не «заодно»: `check` печатает их число, а `task-wording`
|
||||
попадает в работу, а не «заодно»: `check` печатает их число, а `doc-wording`
|
||||
предложит формулировки на замену пачкой.
|
||||
12. Прочитать [language.md](language.md) — и **ничего не переписывать задним
|
||||
числом**. Правила языка применяются к тому, что пишется и правится сейчас;
|
||||
|
||||
@@ -173,8 +173,9 @@ stateDiagram-v2
|
||||
только, чтобы формулировка отвечала на «что приложение делает», а не на «какую
|
||||
часть кода мы трогаем».
|
||||
|
||||
**Что целью не является — работа над станком.** Инструмент, процесс, сборка,
|
||||
сам этот скилл: на вопрос «что приложение будет уметь» они не отвечают. Им
|
||||
**Что целью не является — работа над инструментом и процессом.** Сборка,
|
||||
проверки, сам этот скилл: на вопрос «что приложение будет уметь» они не
|
||||
отвечают. Им
|
||||
отведена отдельная секция роадмапа, чтобы они были видны в том же экране и при
|
||||
этом не читались как возможности продукта.
|
||||
|
||||
@@ -472,9 +473,11 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
|
||||
|
||||
### Вычитка формулировок
|
||||
|
||||
Язык записей судит **отдельный проход** — агент `task-wording`, а не тот же
|
||||
Язык записей судит **отдельный проход** — агент `doc-wording`, а не тот же
|
||||
агент, который их только что написал: самопроверка текста слабее всего ровно
|
||||
там, где формулировка казалась удачной при написании.
|
||||
там, где формулировка казалась удачной при написании. Агент общий для всех
|
||||
проектных текстов (отсюда имя), а форма записи — половина его устава, которая
|
||||
включается только на файлах `items/`.
|
||||
|
||||
Зовётся он **пачкой, а не на каждую запись**: после заведения нескольких задач,
|
||||
после разбора находок ревью и на переоценке. Ему передаётся список файлов и —
|
||||
|
||||
@@ -45,7 +45,7 @@
|
||||
«Не отбрасывать молча лишние символы»); цель — на «что приложение будет
|
||||
уметь»; идея просто называет, о чём она. Почему так — SKILL.md, «Как написана
|
||||
задача». `check` считает заголовки не в форме действия и печатает число в
|
||||
здоровье; годность формулировки смотрит агент `task-wording`.
|
||||
здоровье; годность формулировки смотрит агент `doc-wording`.
|
||||
- **Мета-блок** — список сразу после заголовка, **поле на строку**. Обязательна
|
||||
секция, причина после тире желательна (именно она объясняет, почему задача
|
||||
здесь оказалась — в том числе «вышла из спринта: …»), «зачем» и теги
|
||||
|
||||
Reference in New Issue
Block a user