av-dev-pipeline: бриф удалён, проходы читают документы канона напрямую

- удалены скилл project-brief и контракт брифа; вместо них references/
  project-facts.md — карта «что нужно проходу → где лежит» и таблица
  поразрядной деградации по документам
- девять charter'ов, review-pipeline, task-pipeline и task-batch переписаны
  на пути канона; OpenSpec стал объявленной предпосылкой без ветки деградации
- шаг синка документации переписан в построчный доклад, закрытие задачи —
  вызовом скилла av-dev-pm:tasks вместо строки-слота из CLAUDE.md
- по находкам ревью: docs.py звал tasks.py из чужого каталога и выдавал его
  отказ окружения за дрейф; сверка миграций не видела рабочее дерево;
  плейсхолдер краснел вместо замечания; сверка capability проходила по
  совпадению с именем пакета; tasks.py не читал docs/.pm.json; скилл docs
  пересказывал канон в пяти местах
This commit is contained in:
av
2026-08-03 14:28:55 +03:00
parent ad1779b81f
commit 9cef45252c
26 changed files with 687 additions and 1232 deletions
+19 -15
View File
@@ -15,20 +15,24 @@ color: purple
(точный путь конвейер передаёт в задании). Русская проза, идентификаторы — в
оригинале.
## Что берёшь из брифа
## Что берёшь из документов проекта
- **`## Типовые узлы`** — роды узлов этого проекта и специфичные для них свойства.
Это материал для требования «минимум три пункта специфичны для типа узла».
- **`## Инварианты`** и **`## Проект`** — чтобы рубрика не противоречила тому, что
проект защищает и чем он себя ограничил.
- **`## Прецеденты`** — классы дефектов, уже случавшихся здесь: свойство,
- **`docs/review.md`, «Типовые узлы»** — рода узлов этого проекта и специфичные
для них свойства. Это материал для требования «минимум три пункта специфичны
для типа узла».
- **`CLAUDE.md`, инварианты** и **`docs/passport.md`** — чтобы рубрика не
противоречила тому, что проект защищает и чем он себя ограничил.
- **`docs/review.md`, журнал** — классы дефектов, уже случавшихся здесь: свойство,
сформулированное по прецеденту, сильнее любого общего.
**Брифа или этих разделов нет** — порождай рубрику по общей практике, но
`critical` по основанию «нарушен инвариант проекта» (в фазе 2) не присваивай и
дай в границы покрытия строку: «брифа проекта нет: рода узлов, инварианты и
прецеденты неизвестны; требование «минимум три пункта специфичны для типа узла»
выполнено по общей практике, а не по этому проекту».
Карта «что нужно проходу → где лежит» —
`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
**Этих документов нет** — порождай рубрику по общей практике, но `critical` по
основанию «нарушен инвариант проекта» (в фазе 2) не присваивай и дай строку:
«`docs/review.md` и инвариантов нет: рода узлов и прецеденты неизвестны;
требование «минимум три пункта специфичны для типа узла» выполнено по общей
практике, а не по этому проекту».
## Порядок фаз обязателен
@@ -46,7 +50,7 @@ color: purple
- отсортирована по важности, а не по порядку прихода в голову;
- **минимум три пункта специфичны для типа узла**, а не общие слова. Ориентиры
по родам узлов (проектные — в брифе):
по родам узлов (проектные — в `docs/review.md`):
- *парсер входного формата* — поведение на усечённом и враждебном входе,
границы размера, отсутствие паники, детерминизм, судьба незнакомых полей;
- *HTTP-обработчик приёма* — валидация формы конверта до записи, лимит тела и
@@ -70,15 +74,15 @@ color: purple
в середине слияния запись остаётся либо прежней, либо полной», а не «аккуратно
работать с контекстом»;
- пункты, специфичные для проекта, приветствуются, но не должны вытеснить общие:
если вся рубрика — пересказ инвариантов из брифа, проход выродился в
если вся рубрика — пересказ инвариантов из `CLAUDE.md`, проход выродился в
applicative;
- **отдельным пунктом — узел, читающий состояние, которое сам же меняет.**
Спроси, остаётся ли результат функцией от того, что **уже произошло**, а не от
того, в каком порядке исполнялись параллельные операции и когда именно узел
посмотрел на состояние. Класс: запрос берёт «последнее выведенное значение»
вообще вместо последнего предшествующего — и пересборка перестаёт
воспроизводить состояние. Случаи этого проекта — в разделе `## Прецеденты`
брифа. Тот же вопрос на **готовом коде** задаёт эксплуатационный проход
воспроизводить состояние. Случаи этого проекта — в журнале `docs/review.md`.
Тот же вопрос на **готовом коде** задаёт эксплуатационный проход
(вопрос 9); здесь он задаётся дизайну.
Выведи рубрику **до** любых находок. Она — часть результата, даже если код