канон 4: тип записи стал единственной осью и задаёт схему

Осей было две — тип записи (goal/idea/task) и род работы (kind:<род>
тегом), — и ортогональность у них была фальшивой: из двенадцати клеток
произведения законны шесть. У цели род запрещён, у задачи обязателен, у
идеи пуст и на практике не ставится. Плюс «алгоритм работы над записью
такого типа» крепится не к task, а к fix и research, то есть к роду:
ось, к которой пишется алгоритм, и была настоящим типом. Схлопнуто в
одну ось из пяти значений: goal | feature | fix | chore | research.

Тип idea упразднён отдельно и по другой причине: он значил не род
работы, а незаполненность, а состояние типом быть не может — оно
меняется по мере того, как запись дописывают, а тип меняют командой.
Теперь состояние выводится из заполненности: research без раздела
«Вопрос» это сырьё. В спринт не берётся, как и прежняя идея, лежит в
конце категории, отбирается list --raw.

Дом типа — поле меты «Тип» первой строкой, эмодзи в H1 производна.
Прежнее «отдельного поля типа нет: два места для одного факта
разъезжаются» отменено собственным аргументом: он был против префикса
плюс поля, а при переносе дома место остаётся одно. Эмодзи стоит в H1,
а не в строке индекса, чтобы инвариант «заголовок в индексе дословно»
остался нетронутым.

Поле места названо по типу: «Секция» у цели (часть роадмапа, состояние
очереди), «Категория» у задачи (полка домена, куда её вернёт sprint
drop). Одинаковое переименование закрепило бы конфляцию; какое поле
обязательно, решает тип — то самое, ради чего затевалась правка.

Два новых обязательных раздела выросли из правил, которые были записаны
и которые нечем было проверить. «Не воспроизводится — это research, а не
fix» стояло в каноне: теперь есть раздел «Воспроизведение». Приёмка
разведки — «записанный ответ, а не изменённый код» — тоже стояла, но
sprint take требовал от research два-пять критериев с оракулами, и они
писались ради проверки; вместо них «Вопрос» и «Куда ляжет ответ».

Сортировка «по важности» из заметок не взята: она требует, чтобы кто-то
важность поддерживал, а это приоритет, от которого отказалось правило 4.
Взято только «сырьё в конец категории» — этот порядок выводится из типа
и заполненности, а не назначается человеком, и потому проверяется
машиной.

TYPE_SCHEMA кормит и body_template, и schema_verdict: иначе add кладёт
то, на чём sprint take потом откажет. check --fix мигрирует за один
проход — kind:/[goal]/[idea] в поле «Тип», эмодзи в заголовок, «Секция»
→ «Категория», сырьё в конец. Тип, которого неоткуда взять, не
угадывается: feature от chore машина не отличает, такие записи уходят в
НЕОДНОЗНАЧНО поимённо.

Попутно закрыт класс отказов в --fix: шагов, правящих мету, стало пять,
и второй, перечитавший файл с диска, стирал правку первого. Общий
stage() поверх отложенных правок; до этого корректность держалась на том,
что шагов было мало.

Устав на тип отдельным файлом — references/task-<тип>.md, пять штук:
схема, алгоритм, что видит машина и что человек. Агент task-form получил
правило «тип сходится с тем, что в записи написано» с проверяемыми
расхождениями.

Обкатано на демо-наборе из 13 записей: миграция за один проход, второй
прогон даёт ноль починок; fix без «Воспроизведения» и сырьё в спринт не
идут, годная feature берётся.

DECISIONS тема 27 (ААББ–ЛЛММ, следствия 101–104).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

av-dev-pm/skills/canon/references/canon.md

@@ -240,18 +240,30 @@ kebab-case.
 становится: нормативное поведение живёт в `openspec/specs/`, роадмап отвечает,
 **когда и в каком порядке** оно появилось.
 
-Плюс два требования к записи задачи, потому что от них зависит, можно ли её
-оценить:
+**У каждой записи есть тип, и тип решает, что с ней можно делать.** Дом типа —
+поле меты `Тип` первой строкой; эмодзи в заголовке от него производна. Словарь
+закрыт:
 
-- **род работы** тегом `kind:<род>` из закрытого словаря `feature` | `fix` |
-  `chore` | `research` — у задачи обязателен, у цели запрещён. Он же решает,
-  нужна ли цель: у `feature` обязательна, у остальных нет;
-- **раздел «Затрагивает»** в теле задачи — границы, которых изменение касается
-  (эндпоинт, таблица и миграция, формат на диске, публичный тип пакета).
+| Тип | Что это | Обязательные разделы | Цель |
+| --- | --- | --- | --- |
+| 🎯 `goal` | возможность приложения | `Завершение` | — |
+| ✨ `feature` | снаружи появляется то, чего не было | `Затрагивает`, `Критерии приёмки` | обязательна |
+| 🐞 `fix` | поведение расходится с заявленным | `Воспроизведение`, `Затрагивает`, `Критерии приёмки` | нет |
+| 🧹 `chore` | обслуживание, поведение не меняется | `Затрагивает`, `Критерии приёмки` | нет |
+| 🔬 `research` | исход — знание, а не изменение | `Вопрос`, `Куда ляжет ответ` | нет |
 
-Оба требуются **к взятию в спринт**, а не к заведению: беклог пополняется чаще,
+Схема требуется **к взятию в спринт**, а не к заведению: беклог пополняется чаще,
 чем разбирается, и требование на входе выгоняло бы в заметки то, что должно
-лежать задачей.
+лежать задачей. Запись, не собравшая разделы своего типа, — законное состояние
+беклога; невзятой её делает `sprint take`.
+
+Отдельного типа для незаполненной записи нет: «ещё не описано» — состояние, а не
+род работы, и называется оно **`research` без раздела «Вопрос»**. Такая запись в
+спринт не берётся и лежит в конце своей категории.
+
+Раскладку, форму записи и алгоритм работы над каждым типом держит скилл `tasks`
+(`references/task-<тип>.md`); канон фиксирует только словарь типов и то, от чего
+зависит, читается ли проект как продукт.
 
 ### `CLAUDE.md`
 
@@ -324,7 +336,7 @@ kebab-case.
 | --- | --- |
 | `docs/review-brief.md` | документы канона и есть бриф; остаток — в `review.md` |
 | `docs/specs/` | `openspec/specs/` (поведение) и `architecture.md` (обзор) |
-| `docs/drafts/` | идея → задача `[idea]`; отказ → ADR; порядок → `ROADMAP.md`; размышление → `opsx:explore` |
+| `docs/drafts/` | идея → запись `research`; отказ → ADR; порядок → `ROADMAP.md`; размышление → `opsx:explore` |
 | `docs/plan.md` | `docs/tasks/ROADMAP.md` |
 | `BRIEF.md` | `passport.md` |
 | `docs/backlog/` | `docs/tasks/` |
@@ -364,10 +376,14 @@ kebab-case.
 `database.md`. `tasks` — настройки каталога задач, переехавшие сюда из прежнего
 `<tasks>/.tasks.json`: **один конфиг на весь канон, а не по одному на каталог**.
 Внутри `tasks` — **только имена файлов и заголовков** (`items`, `backlog`,
-`plan`, `sprint`, `rejected`, `sprint_section`, `questions_heading`,
-`criteria_heading`, `oracle_word`), и ключ пишется, лишь когда имя отличается от
-умолчания. **Секций беклога здесь нет:** их дом — заголовки `##` самого индекса,
-и второй список сразу разошёлся бы с первым. Неизвестный ключ `tasks.py`
+`roadmap`, `sprint`, `rejected`, `sprint_section`, `oracle_word` и заголовки
+разделов тела: `criteria_heading`, `surface_heading`, `questions_heading`,
+`completion_heading`, `repro_heading`, `question_heading`, `answer_heading`,
+`scope_heading`), и ключ пишется, лишь когда имя отличается от умолчания.
+**Словаря типов здесь нет** — он закрыт каноном, а не настраивается проектом:
+настраиваемый словарь типов разъехался бы на синонимах ровно так же, как
+открытый. **Категорий беклога здесь тоже нет:** их дом — заголовки `##` самого
+индекса, и второй список сразу разошёлся бы с первым. Неизвестный ключ `tasks.py`
 отвергает кодом 3, поэтому лишнее слово в этом объекте останавливает работу с
 задачами целиком.
 

av-dev-pm/skills/canon/references/changelog.md

@@ -13,17 +13,25 @@ upgrade` идёт по записям снизу вверх от версии п
 
 ---
 
-## Версия 4 — 2026-08-04
+## Версия 4 — 2026-08-05
 
-Одна секция роадмапа переименована, и вместе с именем расширен её смысл;
-достигнутое переехало вниз. Плюс общий словарь для трёх мест канона, которые
-говорят про одну тему разными словами. Раскладка не меняется, файлов не
-прибавляется.
+Две правки, обе про то, как читается каталог задач. Первая — секция роадмапа
+переименована, и вместе с именем расширен её смысл; достигнутое переехало вниз.
+Вторая — **у каждой записи появился тип, и тип определяет, что с записью можно
+делать**. Раскладка не меняется, файлов канона не прибавляется.
 
-**Что переехало:** секция роадмапа `Разработка` → **`Сопровождение`** (англ.
-`Tooling` → **`Operations`**). Прежнее имя называло слишком много: роадмап
-**весь** про разработку, и секция с таким именем не отличалась от остальных
-ничем.
+**Что переехало:**
+
+- секция роадмапа `Разработка` → **`Сопровождение`** (англ. `Tooling` →
+  **`Operations`**). Прежнее имя называло слишком много: роадмап **весь** про
+  разработку, и секция с таким именем не отличалась от остальных ничем;
+- **тип записи** — из префикса заголовка (`[goal]`/`[idea]`) и тега
+  `kind:<род>` в **поле меты `Тип`** первой строкой. Эмодзи в заголовке от него
+  производна;
+- **поле места** у задачи: `Секция` → **`Категория`**. У цели остаётся `Секция`:
+  у задачи поле называет полку домена, в которую она вернётся из спринта, у цели
+  — часть роадмапа, то есть состояние очереди. Одно имя на два смысла было
+  конфляцией.
 
 **Что добавилось:**
 
@@ -51,6 +59,28 @@ upgrade` идёт по записям снизу вверх от версии п
 5. **Заголовок секции отбивается пустой строкой с обеих сторон.** Прежде
    проверялась только строка после заголовка; перестановка секций двигает целые
    блоки, и два заголовка оказываются вплотную. Правит `check --fix`.
+6. **Тип — единственная ось записи, закрытый словарь из пяти значений:**
+   `goal` | `feature` | `fix` | `chore` | `research`. Осей было две — тип записи
+   (`goal`/`idea`/`task`) и род работы (`kind:` тегом), — но из двенадцати
+   клеток произведения законны были шесть, а алгоритм работы крепится к роду, а
+   не к типу. Оси схлопнуты.
+7. **Тип задаёт схему тела:** какие разделы обязательны, какие допустимы, нужна
+   ли цель, берётся ли запись в спринт. Проверяет `sprint take`, замечания даёт
+   `check`. Два раздела новые: **`Воспроизведение`** у `fix` (не
+   воспроизводится — это `research`, а не `fix`; правило было записано и не
+   проверялось) и **`Вопрос` + `Куда ляжет ответ`** у `research` вместо
+   критериев приёмки (приёмка разведки — записанный ответ, и критерии в форме
+   «оракул: тест» ей натянуты).
+8. **Тип `idea` упразднён.** Он значил не род работы, а состояние
+   незаполненности, а состояние типом быть не может. Теперь оно называется
+   честно: `research` без раздела «Вопрос» — **сырьё**. В спринт не берётся, как
+   и прежняя идея, лежит **в конце своей категории** (проверяет `check`,
+   переставляет `--fix`) и отбирается `list --raw`. Порядка «по важности» в
+   беклоге по-прежнему нет: этот порядок производен от типа, а не назначен
+   человеком.
+9. **Алгоритм работы над каждым типом** — отдельным файлом,
+   `skills/tasks/references/task-<тип>.md`: схема, что проверяет машина, что
+   человек, и порядок шагов.
 
 **Что сделать проекту:**
 
@@ -63,10 +93,22 @@ upgrade` идёт по записям снизу вверх от версии п
    docs/tasks` покажет расхождение поимённо.
 3. Перечитать состав секции: цели про выкладку, метрики, логи и инфраструктуру,
    если они лежали в `Направлениях` за неимением места, переезжают сюда.
-4. Прогнать `python3 tasks.py check --dir docs/tasks --fix`: он переставит
-   секции роадмапа в канонический порядок (`Готово` уедет вниз вместе со всем
-   содержимым) и поправит отбивку заголовков.
-5. `docs/.pm.json`: `"canon": 4`.
+4. Прогнать `python3 tasks.py check --dir docs/tasks --fix`. За один проход он
+   переставит секции роадмапа в канонический порядок (`Готово` уедет вниз вместе
+   со всем содержимым), поправит отбивку заголовков и **переведёт записи на
+   типы**: перенесёт значение из тега `kind:` и префикса `[goal]`/`[idea]` в поле
+   `Тип`, снимет тег, поставит эмодзи в заголовок, переименует `Секция` →
+   `Категория` у задач и снесёт сырьё в конец категорий.
+5. Разобрать то, что `--fix` вернул пометкой `НЕОДНОЗНАЧНО`. Главный случай —
+   **записи без типа**: заведённые до появления рода работы, они не несут ни
+   тега, ни префикса, и машина их не угадывает (`feature` от `chore` не
+   отличает). Проставить руками: `edit <слаг> --type …`.
+6. Дописать новые обязательные разделы у задач, которые собираются в спринт:
+   `Воспроизведение` у каждого `fix`, `Вопрос` и `Куда ляжет ответ` у каждого
+   `research`. Не «заодно по всему беклогу», а порциями переоценки: `check`
+   ошибкой это не считает, отказывает только `sprint take`. Сколько задач готово
+   к взятию, печатает блок здоровья `check`.
+7. `docs/.pm.json`: `"canon": 4`.
 
 ## Версия 3 — 2026-08-04
 

av-dev-pm/skills/canon/scripts/docs.py

@@ -70,7 +70,7 @@ RETIRED = {
     "local-research.md": "→ docs/research/",
     "research.md": "→ docs/research/",
     "specs": "поведение → openspec/specs/, обзор → docs/architecture.md",
-    "drafts": "идея → задача [idea], отказ → ADR, порядок → ROADMAP.md",
+    "drafts": "идея → запись research, отказ → ADR, порядок → ROADMAP.md",
     "backlog": "→ docs/tasks/",
     "review": "→ docs/review.md",
 }