вычитка раздвоилась: doc-wording для документов, task-wording для записей

Решение ППП говорило: агент называется doc-wording, а не task-wording, потому что
правила языка относятся ко всем проектным текстам, а не к одним задачам.
Утверждение верно и сегодня — оно и есть причина, по которой правила уехали в
shared/. Но из общности правила не следует общность прохода: docs и tasks
расходятся самодостаточными плагинами, а самодостаточный плагин не может
зависеть от агента соседа. ППП отменено, и отменено не по своей оси.

Проходов теперь два, и разведены они по охвату — впервые в этом репозитории. И
task-form против вычитки, и doc-consistency против doc-code-drift разведены по
глубине; здесь глубина одна, а входы разные. doc-wording читает документы канона,
конвенции, ADR, записки разведки и CLAUDE.md; task-wording — items/ и строки
индексов, а документы проекта открывает только как словарь, чтобы отличить
неизвестный термин от известного.

Разрез по охвату дублирует устав, и потому весь общий текст стал домом. Оба
судят по одним и тем же девяти правилам; отличаются входом, соседями по границе,
машинной проверкой, о которой молчат (docs.py против tasks.py), и способом
подстановки — команда edit у задач, редактор у документов. Копий в каждом уставе
151 строка, своего непустого текста 61 и 75.

Домом стал и формат доклада — блок вычитка-доклад: форма находки, границы
покрытия, пустой доклад. Это контракт прохода, а не правило языка, но лежит он в
shared/language.md отдельным разделом: заводить под пятнадцать строк отдельный
файл дороже, чем назвать раздел честно. Признак дома здесь не тема, а число
потребителей больше одного при обязательной дословности — разойдись два прохода
формой доклада, зовущий скилл разбирал бы два формата вместо одного.

Ссылки разведены в семи местах: tasks/SKILL.md (таблица двух проходов),
task-form (описание и обе границы), doc-code-drift, canon.md (сравнение разрезов),
canon/SKILL.md, README дважды. doc-consistency и таблицы канона оставлены на
doc-wording — они про документы.

Гейт зелёный: копии 13 при 7 домах, фронтматтеров 24, диаграммы. Решение — 50.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-09 13:54:46 +03:00
co-authored by Claude Opus 5
parent c669215fc8
commit 86e22d932c
10 changed files with 391 additions and 54 deletions
+6 -5
View File
@@ -13,17 +13,18 @@
- `init` — новый проект: интервью по свободному описанию замысла → первичная
документация;
- `canon` — привести проект к канону документов: `check` / `adopt` /
`upgrade`, плюс скрипт `docs.py`. Там же живёт язык проектных текстов —
информационный стиль, англицизмы, жаргон. Смысловую часть, которой скрипт
не видит, судят два агента: `doc-consistency` (документы между собой и с
openspec) и `doc-code-drift` (документы против кода);
`upgrade`, плюс скрипт `docs.py`. Там же лежит копия языка проектных
текстов — информационный стиль, англицизмы, жаргон; дом у него общий,
`shared/language.md`. Смысловую часть, которой скрипт не видит, судят три
агента: `doc-consistency` (документы между собой и с openspec),
`doc-code-drift` (документы против кода) и `doc-wording` (язык документов);
- `docs` — содержимое канона по ходу разработки: ADR из архивного
`design.md`, промоут конвенций, запись в разведку и журнал ревью, чистка
архитектуры;
- `tasks` — задачи и цели каталогом markdown-файлов, у каждой записи тип
(`goal`, `feature`, `fix`, `chore`, `research`), и тип задаёт её схему;
вычитывают их два отдельных прохода: `task-form` (форма записи) и
`doc-wording` (язык);
`task-wording` (язык записей);
- `session` — ритуал между спринтами и ведение спринта.
- **av-dev-pipeline** — исполнение. **Требует OpenSpec.**
- `task-pipeline` — задача через полный цикл SDD, от постановки до коммита;