канон версии 3: роадмап, род работы, границы задачи

Три изменения одной версией, потому что все три про одно — можно ли оценить задачу, не открывая код. PLAN.md → ROADMAP.md. Слово «план» значило в репозитории три разных вещи: оглавление целей, план реализации внутри задачи и PLAN.json разовой адаптации. Переименовано целиком — ключ конфига tasks.plan → tasks.roadmap, --index roadmap, --roadmap-sections, --roadmap. Старый ключ в docs/.pm.json не игнорируется молча: скрипт останавливается кодом 3 и называет переименование, иначе проект искал бы опечатку там, где на самом деле версия канона. Род работы — тег kind:feature|fix|chore|research, вторая ось поверх типа записи. В один префикс их не свести: идея бывает про функцию, эпик функцией и является. Дом — тег, потому что теги здесь единственный механизм разметки, а list --kind работает даром; цена принята — в строку индекса род не попадает. Словарь закрыт, иначе он разъедется на bug/bugfix/fix/defect. Отдельно легализован chore: у него «что станет наблюдаемо иначе» отвечается разработчику, а раньше такие задачи либо не заводились, либо придумывали себе пользовательскую пользу — и это второе хуже, оно проходит проверку. Раздел «Затрагивает» — границы, которых изменение касается: эндпоинт, таблица и миграция, формат на диске, публичный тип пакета. Без него задача оценивается по объёму текста, а не по объёму поверхности. Механизируется только наличие непустого раздела: полноту перечня машина не видит. Род и границы требуются к взятию в спринт, а не к заведению — тот же приём, что уже работает для критериев приёмки, и по той же причине. check о пропаже только напоминает: иначе два живых проекта покраснели бы на 98 задачах, заведённых до этого решения. Плюс правила языка задач: англицизм, у которого есть русское слово, заменяется; термин не из паспорта, архитектуры или конвенций вводится строкой или не употребляется; задача, которую не удаётся сказать просто, чаще всего не одна задача. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 16:49:58 +03:00
parent 84134cac1e
commit b99c0c2366
13 changed files with 452 additions and 136 deletions
@@ -1,6 +1,6 @@
 # Канон документов проекта

-**Версия 2.**
+**Версия 3.**

 Это **единственный дом определения канона**. Скиллы `init`, `canon` и `docs`
 читают его, а не пересказывают: три описания одной раскладки разъедутся, и
@@ -39,7 +39,7 @@ docs/
    template.md
    ADR-ГГГГ-ММ-ДД-slug.md
  review.md                    настройка конвейера под проект + журнал дефектов
-  tasks/                       скилл tasks: items/, PLAN.md, BACKLOG.md,
+  tasks/                       скилл tasks: items/, ROADMAP.md, BACKLOG.md,
                               SPRINT.md, REJECTED.md
 openspec/
  config.yaml                  только нужды генерации артефактов + ссылки
@@ -196,6 +196,22 @@ kebab-case.
 выборка по пометке. Пойманные с оракулом — лучшая опора для прохода: проектные,
 воспроизводимые, однажды оказавшиеся правдой.

+### `tasks/`
+
+Раскладку, форму записи и команды держит скилл `tasks` — канон фиксирует только
+имена файлов (`items/`, `ROADMAP.md`, `BACKLOG.md`, `SPRINT.md`, `REJECTED.md`) и
+два требования к самой записи, потому что от них зависит, можно ли задачу
+оценить:
+
+- **род работы** тегом `kind:<род>` из закрытого словаря `feature` | `fix` |
+  `chore` | `research` — у задачи обязателен, у цели запрещён;
+- **раздел «Затрагивает»** в теле задачи — границы, которых изменение касается
+  (эндпоинт, таблица и миграция, формат на диске, публичный тип пакета).
+
+Оба требуются **к взятию в спринт**, а не к заведению: беклог пополняется чаще,
+чем разбирается, и требование на входе выгоняло бы в заметки то, что должно
+лежать задачей.
+
 ### `CLAUDE.md`

 Что это и стек; **инварианты с severity рядом с формулировкой** — по ним проходы
@@ -234,7 +250,7 @@ kebab-case.
 | почему решено так | `adr/`, источник — архивный `design.md` |
 | граница домена, «чем не является» | `passport.md` |
 | инвариант и его severity | `CLAUDE.md` |
-| порядок работ и его обоснование | `docs/tasks/PLAN.md` |
+| порядок работ и его обоснование | `docs/tasks/ROADMAP.md` |
 | измеренное число | `research/` |
 | настройка с числовым значением | `database.md` |
 | периметр и модель угроз | `security.md` |
@@ -267,8 +283,8 @@ kebab-case.
 | --- | --- |
 | `docs/review-brief.md` | документы канона и есть бриф; остаток — в `review.md` |
 | `docs/specs/` | `openspec/specs/` (поведение) и `architecture.md` (обзор) |
-| `docs/drafts/` | идея → задача `[idea]`; отказ → ADR; порядок → `PLAN.md`; размышление → `opsx:explore` |
-| `docs/plan.md` | `docs/tasks/PLAN.md` |
+| `docs/drafts/` | идея → задача `[idea]`; отказ → ADR; порядок → `ROADMAP.md`; размышление → `opsx:explore` |
+| `docs/plan.md` | `docs/tasks/ROADMAP.md` |
 | `BRIEF.md` | `passport.md` |
 | `docs/backlog/` | `docs/tasks/` |
 | `docs/review-journal.md`, `docs/review/journal.md` | `docs/review.md` |
@@ -13,6 +13,47 @@ upgrade` идёт по записям снизу вверх от версии п

 ---

+## Версия 3 — 2026-08-04
+
+Оглавление целей переименовано, у задач появился род работы и раздел
+«Затрагивает». Раскладка меняется в одном файле, но переименование тянет за
+собой ссылки, поэтому шаги делаются одним заходом.
+
+**Что добавилось:**
+
+1. **Род работы** — тег `kind:<род>` в мете задачи, словарь закрыт:
+   `feature` | `fix` | `chore` | `research`. Обязателен у задачи, у цели
+   запрещён. `sprint take` без него отказывает, `check` о пропаже напоминает
+   замечанием. Определение — [canon.md](canon.md), раздел `tasks/`; смысл и
+   причина, почему тегом, — в SKILL.md скилла `tasks`, раздел «Род работы».
+2. **Раздел «Затрагивает»** в теле задачи — перечень границ, которых изменение
+   касается (эндпоинт, таблица и миграция, формат на диске, публичный тип). Как
+   и критерии приёмки, требуется к взятию в спринт, а не к заведению.
+
+**Что переехало:** `docs/tasks/PLAN.md` → `docs/tasks/ROADMAP.md`. Вместе с
+файлом переименован ключ конфига `tasks.plan` → `tasks.roadmap` и токены
+команд: `--index plan` → `--index roadmap`, `init --plan-sections` →
+`--roadmap-sections`, `init --plan` → `--roadmap`. Старый ключ в
+`docs/.pm.json` не игнорируется молча — `tasks.py` останавливается и называет
+переименование.
+
+**Что удалено:** ничего.
+
+**Что сделать проекту:**
+
+1. `git mv docs/tasks/PLAN.md docs/tasks/ROADMAP.md`.
+2. Починить ссылки на прежнее имя: `grep -rn 'PLAN\.md' docs/ CLAUDE.md` —
+   заголовок самого файла («# План» → «# Роадмап»), строка в `docs/tasks/BACKLOG.md`,
+   упоминания в `docs/passport.md` и в телах задач.
+3. `docs/.pm.json`: ключ `tasks.plan`, если он там был, — в `tasks.roadmap`.
+4. Проставить род работы живым задачам: `python3 tasks.py check --dir docs/tasks`
+   перечислит те, у кого его нет. Задним числом весь беклог не переоформляется —
+   род нужен к взятию, так что порядок такой: сперва то, что берётся в ближайший
+   спринт, остальное по ходу переоценки.
+5. Дописать раздел «Затрагивает» — тем же порядком и по той же причине: сперва
+   набор спринта, остальное по мере того, как задача попадает в работу.
+6. `docs/.pm.json`: `"canon": 3`.
+
 ## Версия 2 — 2026-08-03

 Шапка записи ADR — мета-блоком общей формы, и у статуса появился объявленный
@@ -29,7 +29,7 @@
 # Паспорт проекта

 Зачем это и для кого. [architecture.md](architecture.md) отвечает «как
-устроено», [tasks/PLAN.md](tasks/PLAN.md) — «в каком порядке», паспорт —
+устроено», [tasks/ROADMAP.md](tasks/ROADMAP.md) — «в каком порядке», паспорт —
 «зачем и для кого».

 ## Цель