TODO переписан с чистого листа; canon и docs остаются раздельно

План описывал мир до раскола: av-dev-pm в живых, каталог задач в docs/, шаги
повышения на каноны 3, 4 и 5 — при том что канон уже 11. Двести с лишним строк, из
них живых полтора десятка, и найти их можно было только прочитав всё.

Умер он двумя способами сразу, и оба записаны в новом заголовке, чтобы не
повторились. Первый: сделанное помечалось галочкой и оставалось в файле — список
из двух сотен [x] перестают читать целиком, и живые пункты в нём теряются. Теперь
сделанное удаляется, след остаётся в коммитах и DECISIONS. Второй: план построчно
повторял записи журнала версий канона, то есть был вторым домом для шагов
повышения, и половина повторов протухла молча. Теперь на журнал стоит ссылка.

Новый план — пять разделов: вернуть живые проекты в рабочее состояние, учёт работ
без спринтов, калибровка, пайплайн одной задачи в три этапа, обкатка. Поимённой
раскладки файлов healthlog в нём нет намеренно: её знает canon adopt, и второй
перечень разошёлся бы со скиллом. Зато названо то, чего скилл не сделает и что
легко потерять — гейт проекта теперь три шага вместо одного, потому что docs.py
перестал тянуть за собой и задачи, и форму config.yaml.

REMAINING ссылался на разделы TODO по номерам — переведён на имена; заодно строка
про непрогнанное на живом проекте дополнена скиллом openspec и оговоркой, что
раскол проверен только на фикстурах и на установке каждого плагина в одиночку.

Решение 53: canon и docs остаются двумя скиллами. Довод не про объём, а про
description — это триггер, по которому загрузчик решает, звать ли скилл, и
моменты вызова у этих двух разные. Слитое описание покрывает оба хуже, чем два
покрывают каждое своё.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-09 14:40:16 +03:00
co-authored by Claude Opus 5
parent e408c51ac1
commit c91492e3f0
3 changed files with 132 additions and 214 deletions
+98 -208
View File
@@ -1,227 +1,117 @@
# Работы по итогам разбора
# Что осталось сделать
Порядок и обоснование — [DECISIONS.md](DECISIONS.md), тема 8. Номера в скобках —
следствия оттуда.
**Здесь только работы и их порядок.** Чего здесь нет намеренно:
Замер (шаг 3) — **единственный шаг, который нельзя переставить**: он блокирует
переезд jellybit. Всё остальное можно тасовать.
- **риски, открытые вопросы и принятые пределы** — [REMAINING.md](REMAINING.md);
- **почему решено так** — [DECISIONS.md](DECISIONS.md), записи датированы;
- **шаги повышения проекта с версии канона на версию** — журнал версий
([changelog.md](av-dev-docs/skills/canon/references/changelog.md)). Пересказ их
сюда был бы вторым домом, и прежний план на этом уже разъезжался: он повторял
записи версий 3, 4 и 5 построчно, и половина повторов протухла молча.
## 0. Предусловие
Сделанное отсюда **удаляется, а не помечается галочкой**. След остаётся в
коммитах и в `DECISIONS.md`; список из двух сотен `[x]` перестают читать целиком,
и живые пункты в нём теряются — прежний план умер именно так.
- [x] `git push``092d07c..88c5d97`, 17 коммитов ушли на origin (37)
- [x] `claude plugin marketplace update av-dev-skills` — клон встал на `88c5d97`
и видит `av-dev-pm` и `av-dev-pipeline`
## Где мы сейчас
## 1. Репозиторий плагинов
Плагинов четыре, и каждый ставится отдельно: `av-dev-docs` (канон документов и
их содержимое), `av-dev-tasks` (задачи и цели), `av-dev-pipeline` (SDD и конвейер
ревью, он же заводит OpenSpec), `av-dev-git`. Общее, что нужно нескольким
дословно, живёт домом в `shared/` и уезжает копиями.
### 1.1 Переименование
Канон документов — **версия 11**. Живые проекты стоят на 2–3 и на плагине
`av-dev-pm`, которого больше нет.
- [x] `av-dev-tasks``av-dev-pm`: каталог, `plugin.json`, `marketplace.json` (18)
- [x] пространство имён во всех текстах: `av-dev-tasks:session`
`av-dev-pm:session`, включая ссылку из `task-pipeline` (18)
## 1. Живые проекты — вернуть в рабочее состояние
### 1.2 Канон — единственный дом определения
Блокирует всё остальное: под текущим каноном не стоит ни один проект, и ни один
скилл, кроме `docs.py check`, не исполнялся на живом коде ни разу
(см. REMAINING, «Что ещё не сделано»).
- [x] `av-dev-pm/skills/canon/references/canon.md` — раскладка, роли документов,
правило единственного дома. Читают `init`, `canon`, `docs` (AA)
- [x] `av-dev-pm/skills/canon/references/changelog.md` — журнал версий канона,
версия 1 (26)
### healthlog — первым
### 1.3 Правки существующих скиллов
- [x] `tasks`: убрать слот 6 «Команда учёта задач» (33)
- [x] `tasks`: путь каталога жёсткий `docs/tasks`, убрать цепочку разрешения (F)
- [x] `tasks`: `.tasks.json``docs/.pm.json`, там же версия канона и путь
миграций (23, 30)
- [x] `tasks`: убрать слоты 3 «куда переезжает суть» и 5 «оракулы» — отвечает
канон и семантика гейта (тема 4)
- [x] `session`: убрать слот 7 и слот 4 «где живёт разбор процесса» (33, K)
- [x] `session`: переписать «Стимулы, которые процесс создаёт» — снятая граница
выбила опору у трёх защит (19)
### 1.4 Новые скиллы
- [x] `init` — интервью по брифу → канон нового проекта (R)
- [x] `canon``check` / `adopt` / `upgrade`; поглощает скилл `adopt` (R, 21, 24)
- [x] `docs` — содержимое канона: ADR из архивного `design.md`, промоут
конвенций, запись в `research/` и `review.md`, чистка `architecture.md` (X)
- [x] `docs.py` — раскладка, лишние файлы, битые ссылки, версия, плейсхолдеры,
маркеры долга; сверки миграции ↔ `database.md` и capability ↔
`architecture.md` (T, 31)
### 1.5 av-dev-pipeline
- [x] удалить скилл `project-brief` и `references/{project-brief,brief-template}.md` (13)
- [x] снять ветки деградации OpenSpec в трёх местах: `task-pipeline`,
`review-pipeline`, `task-batch` (1)
- [x] девять charter'ов: разделы брифа → пути канона; `ops`/`adversary`/`reimpl`
обязаны сшивать `research/` и `database.md` (14, 15)
- [x] `review-pipeline`: убрать бриф, поразрядная деградация по документам (16)
- [x] `task-pipeline` шаг 9 → построчный доклад по документам канона (28)
- [x] `task-pipeline`/`task-batch`: закрытие задачи вызовом скилла
`av-dev-pm:tasks`, слот убрать (32, 33)
- [x] `promote.md` шаг 3: перечень механизированного → `conventions/README.md` (29)
- [x] описание плагина: «требует OpenSpec» (2)
### 1.6 Прочее
- [x] `av-dev-backlog` — пометить устаревшим, переписать описание, чтобы не
ловило триггер (Q)
- [x] `README.md` маркетплейса — три плагина, канон, установка
- [x] `HISTORY.md` — сжать `AGENTIC-TASKS.md` до истории решений (CC)
- [x] `REMAINING.md` пересобрать: пункт 2 отменён, четыре вопроса закрыты,
калибровка стала обязательной (38)
### 1.7 Линтеры скриптов (тема 9)
- [x] `pyproject.toml`: ruff + pyrefly через `uv`, версии прибиты (DD, FF)
- [x] запрет внешних зависимостей двумя способами: `banned-api` + пустое
окружение pyrefly (EE)
- [x] `RUF001``RUF003` выключены, `av-dev-backlog` исключён (GG, HH)
- [x] починены 27 находок ruff и 14 pyrefly; `os` из `tasks.py` ушёл (40, 41)
- [x] раздел «Проверка скриптов» в `README.md`
### 1.8 Ревью двумя проходами (тема 10)
- [x] `reopen` берёт текст из `HEAD`, когда коммита удаления ещё нет (JJ)
- [x] шаг 11 коммитит учёт вторым коммитом; батч проверяет чистоту дерева (JJ)
- [x] фиктивный ключ `tasks.sections` убран из четырёх документов (KK)
- [x] `init` пишет конфиг в `docs/.pm.json`; `looks_like_tasks` его читает
- [x] урожай спринта заводится до `sprint close`, слаг — из его отчёта
- [x] ответ на вопрос опустошает раздел «Вопросы» — во всех трёх местах
- [x] путь отчёта триажа переживает архивацию (5 мест)
- [x] `review-specs` получил режим 3 — стык после слияния
- [x] остальные 12 находок: `sprint.md`, «9а», перечень проектных копий,
параллельность в батче, триаж в финальной сверке, триггеры профиля, 8–12
### 1.9 Ревью зависимостей между плагинами (тема 11)
- [x] опоры приёмки названы абстрактно, деградация без конвейера объявлена (MM)
- [x] ветка деградации шага 9 ходит в свой `project-facts.md` (NN)
- [x] `docs` даёт ветку «конвейера нет» для журнала и промоута
- [x] форма журнала дефектов сведена к дому, копия помечена в `changelog.md`
- [x] `specs` вернулся в читатели `docs/research/`; дом списка назначен
- [x] пайплайн не называет `items/` и `SPRINT.md` — их знает `av-dev-pm`
- [x] манифесты объявили `av-dev-pm` опциональным для конвейера (49)
### 1.10 Механическая проверка копий (тема 12)
- [x] `scripts/copies.py`: маркеры дома и копии, побайтовая сверка (OO)
- [x] строгий id, повторяемый в закрывающем маркере (PP)
- [x] помечены два контракта; «когда заводить ADR» сведён к дословному (50)
- [x] раздел «Проверка копий правил» в `README.md`, правило — в обоих домах
## 2. healthlog — первая боевая проверка
- [ ] `canon adopt`; `docs/backlog/``docs/tasks/`
- [ ] `architecture.md` 1662 строки → обзор, остаток маркерами (W)
- [ ] после выноса поведения — замерить остаток `architecture.md`; **решать
больше нечего**: канон 5 разрешил любой теме быть каталогом с `README.md`,
так что жмёт — заводи `docs/architecture/`, и это не смена версии
(тема 16, GGG, 65; закрыто темой 36)
- [ ] завести `security.md` с периметром первой строкой (J)
- [ ] `review-journal.md``review.md` + настройка конвейера (K, L)
- [ ] `conventions.md``conventions/`, `local-research.md``research/` (G)
- [ ] `plan.md``docs/tasks/ROADMAP.md` (E)
- [ ] завести `docs/adr/`
- [ ] `CLAUDE.md`: severity инвариантов, семантика гейта, убрать раздел
«Процесс» (M, N)
- [ ] `docs.py check` в `task gate` (V)
- [ ] почистить `openspec/config.yaml` (C)
- [ ] переустановить плагины: снять `av-dev-pm`, поставить `av-dev-docs` и
`av-dev-tasks`. `marketplace update`, затем `plugin update` — одного шага
мало (README, «Обновление»)
- [ ] удалить проектные копии: `.claude/skills/healthlog-{task,review}-pipeline`
и девять `.claude/agents/healthlog-review-*.md`они прошлого поколения и
после переезда указывают на `docs/conventions.md`, `docs/local-research.md`,
`docs/review-journal.md`, которых уже не будет
и девять `.claude/agents/healthlog-review-*.md`. Они прошлого поколения и
после переезда указывают на документы, которых уже не будет
- [ ] `av-dev-docs:canon` в режиме `adopt` — он приведёт проект к канону 11
сразу, картой и с подтверждением. Файл-в-файл здесь не расписан: раскладку
знает скилл, и второй перечень разошёлся бы с ним
- [ ] каталог задач — в `tasks/` корня (канон 11), не в `docs/tasks/`. Скилл
задач зовётся из `adopt` сам
- [ ] гейт проекта: три шага вместо одного — `docs.py check`, `tasks.py check
--dir tasks`, `openspec.py check`. **Второй и третий раньше не были
нужны:** согласованность задач тянул за собой `docs.py`, форму `config.yaml`
он же. Теперь оба молчат, и без своих шагов дрейф перестанет ловиться
- [ ] разобрать урожай `doc-consistency` и `doc-code-drift` порциями — правило
единственного дома на живом проекте не проверял никто
## 3. Калибровка — блокирует шаг 5
### jellybit — после калибровки
Порядок не произволен: замер (раздел 3) блокирует переезд jellybit, и только его.
- [ ] то же, что у healthlog: плагины, проектные копии, `adopt`, каталог задач,
гейт
- [ ] проектные копии здесь опаснее: скиллы названы `task-pipeline`,
`review-pipeline`, `task-batch` — **ровно как в плагине**, и короткое имя
может увести в устаревшую копию молча (REMAINING)
## 2. Учёт работ без спринтов
Решено: спринты отменяются, беклог и роадмап остаются. Причина — процесс идёт
задача за задачей, и замороженный набор перестал что-либо удерживать.
- [ ] снять спринт: `SPRINT.md`, команды `sprint *`, переходы схемы состояний,
правило «задача живёт в одном индексе за раз» упрощается до беклога
- [ ] **приоритет — явный порядок строк в беклоге.** Правило 4 скилла задач
(«порядка нет, есть цель») переписывается целиком: оно обосновано тем, что
«что делать дальше» отвечает набор спринта, — а набора больше нет.
Записать, что приоритет это **свойство очереди, а не задачи**, и потому его
дом индекс: то же исключение из правила 2, что уже есть у «в каком индексе
лежит задача, знают индексы»
- [ ] **перевесить гейт готовности.** Схема типа (обязательные разделы, ≥2
критерия, границы) проверяется на `sprint take`. Спринта нет — момента нет;
нужен `tasks.py ready <слаг>` или `check --task <слаг>` на входе пайплайна,
иначе задача уедет в работу без критериев приёмки
- [ ] `check --fix`: восстановленная строка индекса теряет позицию, а позиция
теперь и есть приоритет. Класть в конец категории и печатать пометкой, что
приоритет назначен не человеком
- [ ] `session` → скилл груминга внутри `av-dev-tasks`: пересортировка беклога,
разбор вопросов, переоценка. `references/sprint.md` в мусор, `cadence.md`
переписать под ритуал без спринта
- [ ] запись в журнал версий канона: проектам надо снести `SPRINT.md` и
расставить порядок
## 3. Калибровка — блокирует переезд jellybit
- [ ] замер на четырёх находках healthlog: скелет из `null`, откат бинаря,
канонизация в транзакции, `-1 >= -1` (1 из REMAINING, 14)
канонизация в транзакции, `-1 >= -1`. Цена и ожидаемый исход — REMAINING,
«Главный незакрытый риск»
## 4. Обкатка
## 4. Пайплайн одной задачи — три этапа
- [ ] один-два спринта healthlog на новом процессе
Обкатывается на healthlog после разделов 1 и 2. Пайплайн нескольких задач на
паузе намеренно.
## 5. jellybit
- [ ] **этап 1** — первичный ресерч и смысл задачи. Заканчивается дешёвым
подтверждением: две строки «понял так, собираюсь делать это». Без него
проверка «то ли я делаю» приходит после готового дизайна, то есть когда
ошибка стоит дороже всего
- [ ] **этап 2** — propose, дизайн, ревью дизайна, краткое объяснение решения.
Заканчивается полноценным чекпоинтом
- [ ] **этап 3** — код, ревью, архивация. Автоматически: дизайн уже согласован.
Решить, что делает этап, когда ревью находит расхождение **с утверждённым
дизайном**: находка внутри дизайна дожимается сама, находка, отменяющая
дизайн, отменяет и чекпоинт и обязана всплыть к человеку
- [ ] перемерить `review-pipeline` тем же вопросом, что и проект целиком:
сколько из пяти стадий реально смотрятся глазами. 1028 строк, и весь
автоматический этап держится на них
- [ ] `BRIEF.md``docs/passport.md`, обновить
- [ ] `docs/specs/{recognition,review-ux,workflow}.md` — сверить с capability и
удалить как дубли (10)
- [ ] `docs/specs/architecture.md``docs/architecture.md`, `database.md`
`docs/database.md`, `jellyfin-layout.md``docs/research/`
- [ ] `docs/review/journal.md``docs/review.md`
- [ ] `drafts/` растворить: roadmap → `ROADMAP.md`, conventions-backlog → записи
`research` (сырьё: тип есть, «Вопрос» пуст), logical-title-model → ADR (H)
- [ ] `docs/backlog/``docs/tasks/`
- [ ] удалить проектные копии скиллов и агентов (4 из REMAINING)
- [x] `av-dev-backlog` удалить из маркетплейса и снять с проекта (тема 30)
## 5. Обкатка
## 6. Канон версии 3 — повысить живые проекты (тема 17)
Оба проекта стоят на каноне 2 и держат `docs/tasks/PLAN.md`: healthlog 55 задач,
jellybit 43. Шаги повышения — [changelog.md](av-dev-pm/skills/canon/references/changelog.md),
запись «Версия 3»; делаются скиллом `av-dev-pm:canon` в режиме `upgrade`.
- [x] healthlog: `PLAN.md``ROADMAP.md`, ссылки, `"canon": 3` — сделано,
лежит в рабочем дереве проекта некоммитнутым
- [ ] jellybit: то же
- [ ] род работы и раздел «Затрагивает» — **не задним числом**: сперва то, что
идёт в ближайший набор (`sprint take` без них откажет), остальное по ходу
переоценки (PPP)
- [ ] секции роадмапа: `порядок``Запланировано`, `темы``Направления`,
завести `Готово` и `Сопровождение`; прозаические разделы healthlog («Что уже
пройдено», «Почему в таком порядке») разложить — звенья строками в
`Готово`, обоснование очереди прозой внутри `Запланировано` (тема 19, 80).
`check` теперь называет чужую секцию ошибкой, так что шаг обязателен
- [ ] переформулировать цели ответом на «что приложение будет уметь»; цели не
про приложение («Процесс и качество разработки» в jellybit) — в
`Сопровождение`
- [ ] `check --fix` на обоих: поднимет написание канонических секций, поставит
отбивку после заголовков и сведёт секцию в мете файлов с заголовками.
Секции беклога переименовать руками — имена выбирал проект (тема 20, ККК)
- [ ] заголовки задач в форму действия — **не задним числом**: по мере попадания
задачи в работу. `check` печатает их число, `task-form` предложит
формулировки пачкой (тема 20, ЕЕЕ)
**Канон 4** — сверх того (changelog, запись «Версия 4»):
- [ ] healthlog: `## Разработка``## Сопровождение`, поле «Секция» в целях этой
секции, `check --fix` (переставит `Готово` вниз и поправит отбивку),
`"canon": 4`
- [ ] jellybit едет сразу на 4: `Готово` заводить **последней**, секцию
сопровождения — сразу с новым именем, переставлять дважды не нужно
- [ ] типы: `check --fix` переведёт `kind:`/`[goal]`/`[idea]` в поле «Тип», снимет
тег, поставит эмодзи, переименует «Секция» → «Категория» у задач и снесёт
сырьё в конец категорий — **за один проход, вместе с порядком секций**
- [ ] разобрать `НЕОДНОЗНАЧНО` после `--fix`: записи без типа (заведены до
появления рода работы) машина не угадывает — `edit <слаг> --type …`
- [ ] имена файлов: `docs.py check` назовёт кириллицу, не-kebab-case и форму
имени ADR. Переименование ADR — **перенос ссылок одним проходом**: слаг
стоит в `adr/README.md`, в `architecture.md` и в чужих документах
- [ ] первый прогон `doc-consistency` на живом проекте — правило единственного
дома до сих пор не проверял никто, урожай ожидается крупный; разбирать
порциями
- [ ] `doc-code-drift` — на ближайшей сессии между спринтами, с разделом
запретов `CLAUDE.md` на входе
- [ ] новые обязательные разделы — **не задним числом**: `Воспроизведение` у
каждого `fix` и `Вопрос` + `Куда ляжет ответ` у каждого `research` пишутся
по мере того, как задача идёт в набор (`sprint take` без них откажет).
Сколько записей готово к взятию, печатает блок здоровья `check`
- [ ] `docs/review.md`, «Триггеры профиля» — переписать целиком: снести перечень
мест для `deep` (профиль упразднён), а оставшийся перевести на новое
правило — `wide` это крупное или незнакомое изменение, 5–10% задач, плюс
отдельный список мелкого для `quick`. Там же две честные строки в
«перестали проверять сознательно»: форма решения (снят проход независимой
реализации) и всё, что требует запуска (меряющие проходы только в `wide`)
**Канон 5** — сверх того (changelog, запись «Версия 5»):
- [ ] `docs/review.md`: «Вопросы к проходам» → **«Вопросы по темам»**, каждый
вопрос переадресовать теме вместо имени прохода (`requirements`,
`autotests`, `conventions`, `architecture`, `security`, `operations` плюс
свои). «Недоступно проверке» — тоже разнести по темам
- [ ] проверить, не просился ли в `docs/` документ, который раньше считался
лишним: теперь он законен и **становится темой ревью**. Это единственный
способ добавить проверку, которой в конвейере нет
- [ ] `"canon": 5` в `docs/.pm.json` обоих проектов; форму домов не трогать —
обе законны
- [ ] один-два цикла healthlog на новом процессе; наблюдение к первой обкатке —
не выродились ли «границы покрытия» в шаблон (REMAINING, «Открытые
вопросы»)