av
ee90653c11
- DECISIONS.md: 29 решений по восьми темам, каждое с причиной; две отменённые версии сохранены с объяснением отмены - TODO.md: план в порядке выката, замер блокирует переезд jellybit
111 lines
6.5 KiB
Markdown
111 lines
6.5 KiB
Markdown
# Работы по итогам разбора
|
||
|
||
Порядок и обоснование — [DECISIONS.md](DECISIONS.md), тема 8. Номера в скобках —
|
||
следствия оттуда.
|
||
|
||
Замер (шаг 3) — **единственный шаг, который нельзя переставить**: он блокирует
|
||
переезд jellybit. Всё остальное можно тасовать.
|
||
|
||
## 0. Предусловие
|
||
|
||
- [ ] `git push` — четыре коммита с `av-dev-tasks` и `av-dev-pipeline` не
|
||
отправлены на origin, поэтому маркетплейс их не видит (37)
|
||
- [ ] `claude plugin marketplace update av-dev-skills` — повторно, после push
|
||
|
||
## 1. Репозиторий плагинов
|
||
|
||
### 1.1 Переименование
|
||
|
||
- [ ] `av-dev-tasks` → `av-dev-pm`: каталог, `plugin.json`, `marketplace.json` (18)
|
||
- [ ] пространство имён во всех текстах: `av-dev-tasks:session` →
|
||
`av-dev-pm:session`, включая ссылку из `task-pipeline` (18)
|
||
|
||
### 1.2 Канон — единственный дом определения
|
||
|
||
- [ ] `av-dev-pm/skills/canon/references/canon.md` — раскладка, роли документов,
|
||
правило единственного дома. Читают `init`, `canon`, `docs` (AA)
|
||
- [ ] `av-dev-pm/skills/canon/references/changelog.md` — журнал версий канона,
|
||
версия 1 (26)
|
||
|
||
### 1.3 Правки существующих скиллов
|
||
|
||
- [ ] `tasks`: убрать слот 6 «Команда учёта задач» (33)
|
||
- [ ] `tasks`: путь каталога жёсткий `docs/tasks`, убрать цепочку разрешения (F)
|
||
- [ ] `tasks`: `.tasks.json` → `docs/.pm.json`, там же версия канона и путь
|
||
миграций (23, 30)
|
||
- [ ] `tasks`: убрать слоты 3 «куда переезжает суть» и 5 «оракулы» — отвечает
|
||
канон и семантика гейта (тема 4)
|
||
- [ ] `session`: убрать слот 7 и слот 4 «где живёт разбор процесса» (33, K)
|
||
- [ ] `session`: переписать «Стимулы, которые процесс создаёт» — снятая граница
|
||
выбила опору у трёх защит (19)
|
||
|
||
### 1.4 Новые скиллы
|
||
|
||
- [ ] `init` — интервью по брифу → канон нового проекта (R)
|
||
- [ ] `canon` — `check` / `adopt` / `upgrade`; поглощает скилл `adopt` (R, 21, 24)
|
||
- [ ] `docs` — содержимое канона: ADR из архивного `design.md`, промоут
|
||
конвенций, запись в `research/` и `review.md`, чистка `architecture.md` (X)
|
||
- [ ] `docs.py` — раскладка, лишние файлы, битые ссылки, версия, плейсхолдеры,
|
||
маркеры долга; сверки миграции ↔ `database.md` и capability ↔
|
||
`architecture.md` (T, 31)
|
||
|
||
### 1.5 av-dev-pipeline
|
||
|
||
- [ ] удалить скилл `project-brief` и `references/{project-brief,brief-template}.md` (13)
|
||
- [ ] снять ветки деградации OpenSpec в трёх местах: `task-pipeline`,
|
||
`review-pipeline`, `task-batch` (1)
|
||
- [ ] девять charter'ов: разделы брифа → пути канона; `ops`/`adversary`/`reimpl`
|
||
обязаны сшивать `research/` и `database.md` (14, 15)
|
||
- [ ] `review-pipeline`: убрать бриф, поразрядная деградация по документам (16)
|
||
- [ ] `task-pipeline` шаг 9 → построчный доклад по документам канона (28)
|
||
- [ ] `task-pipeline`/`task-batch`: закрытие задачи вызовом скилла
|
||
`av-dev-pm:tasks`, слот убрать (32, 33)
|
||
- [ ] `promote.md` шаг 3: перечень механизированного → `conventions/README.md` (29)
|
||
- [ ] описание плагина: «требует OpenSpec» (2)
|
||
|
||
### 1.6 Прочее
|
||
|
||
- [ ] `av-dev-backlog` — пометить устаревшим, переписать описание, чтобы не
|
||
ловило триггер (Q)
|
||
- [ ] `README.md` маркетплейса — три плагина, канон, установка
|
||
- [ ] `HISTORY.md` — сжать `AGENTIC-TASKS.md` до истории решений (CC)
|
||
- [ ] `REMAINING.md` пересобрать: пункт 2 отменён, четыре вопроса закрыты,
|
||
калибровка стала обязательной (38)
|
||
|
||
## 2. healthlog — первая боевая проверка
|
||
|
||
- [ ] `canon adopt`; `docs/backlog/` → `docs/tasks/`
|
||
- [ ] `architecture.md` 1611 строк → обзор, остаток маркерами (W)
|
||
- [ ] завести `security.md` с периметром первой строкой (J)
|
||
- [ ] `review-journal.md` → `review.md` + настройка конвейера (K, L)
|
||
- [ ] `conventions.md` → `conventions/`, `local-research.md` → `research/` (G)
|
||
- [ ] `plan.md` → `docs/tasks/PLAN.md` (E)
|
||
- [ ] завести `docs/adr/`
|
||
- [ ] `CLAUDE.md`: severity инвариантов, семантика гейта, убрать раздел
|
||
«Процесс» (M, N)
|
||
- [ ] `docs.py check` в `task gate` (V)
|
||
- [ ] почистить `openspec/config.yaml` (C)
|
||
|
||
## 3. Калибровка — блокирует шаг 5
|
||
|
||
- [ ] замер на четырёх находках healthlog: скелет из `null`, откат бинаря,
|
||
канонизация в транзакции, `-1 >= -1` (1 из REMAINING, 14)
|
||
|
||
## 4. Обкатка
|
||
|
||
- [ ] один-два спринта healthlog на новом процессе
|
||
|
||
## 5. jellybit
|
||
|
||
- [ ] `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 → `PLAN.md`, conventions-backlog → задачи
|
||
`[idea]`, logical-title-model → ADR (H)
|
||
- [ ] `docs/backlog/` → `docs/tasks/`
|
||
- [ ] удалить проектные копии скиллов и агентов (4 из REMAINING)
|
||
- [ ] `av-dev-backlog` удалить из маркетплейса
|