|
|
|
@@ -13,6 +13,61 @@ upgrade` идёт по записям снизу вверх от версии п
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Версия 4 — 2026-08-04
|
|
|
|
|
|
|
|
|
|
Одна секция роадмапа переименована, и вместе с именем расширен её смысл;
|
|
|
|
|
достигнутое переехало вниз. Плюс общий словарь для трёх мест канона, которые
|
|
|
|
|
говорят про одну тему разными словами. Раскладка не меняется, файлов не
|
|
|
|
|
прибавляется.
|
|
|
|
|
|
|
|
|
|
**Что переехало:** секция роадмапа `Разработка` → **`Сопровождение`** (англ.
|
|
|
|
|
`Tooling` → **`Operations`**). Прежнее имя называло слишком много: роадмап
|
|
|
|
|
**весь** про разработку, и секция с таким именем не отличалась от остальных
|
|
|
|
|
ничем.
|
|
|
|
|
|
|
|
|
|
**Что добавилось:**
|
|
|
|
|
|
|
|
|
|
1. **Смысл секции расширен.** Было «инструмент и процесс», стало «чем держат
|
|
|
|
|
проект: инструмент, процесс, эксплуатация». Метрики, логи, инфраструктура,
|
|
|
|
|
выкладка и дежурство — сюда же. Расширение не косметическое: английское
|
|
|
|
|
`Operations` при узком смысле обещало бы эксплуатацию, а внутри лежал бы
|
|
|
|
|
линтер.
|
|
|
|
|
2. **Общий словарь трёх мест** — [canon.md](canon.md), раздел «Сопровождение и
|
|
|
|
|
эксплуатация». Сопровождение — всё, чем держат проект; эксплуатация — его
|
|
|
|
|
часть, работа системы на проде. `ROADMAP.md`, секция `Сопровождение` — план
|
|
|
|
|
работ; `architecture.md`, раздел «Эксплуатация» — как устроено сейчас;
|
|
|
|
|
эксплуатационный проход ревью — оптика проверки. Слить их в одно слово
|
|
|
|
|
нельзя: они отвечают на разные вопросы. Слово **«поддержка» не употребляется
|
|
|
|
|
вовсе** — в нём слышится помощь пользователю.
|
|
|
|
|
3. **Граница с возможностями проходит по тому, кто наблюдает.** «Приложение
|
|
|
|
|
сообщает о своём состоянии» — возможность приложения, её место среди прочих
|
|
|
|
|
целей. «Дежурный видит состояние на одном экране» — сопровождение. Одни и те
|
|
|
|
|
же метрики попадают в разные секции роадмапа, и это верно.
|
|
|
|
|
4. **Порядок секций стал каноническим**, и `Готово` переехало **вниз**:
|
|
|
|
|
`Запланировано` | `Направления` | `Сопровождение` | `Готово`. Достигнутое
|
|
|
|
|
копится — через год этой секции больше, чем всех остальных вместе, — и стоя
|
|
|
|
|
первой она отодвигает за экран то, ради чего роадмап открывают чаще всего.
|
|
|
|
|
Порядок проверяет `tasks.py check`, переставляет `check --fix`.
|
|
|
|
|
5. **Заголовок секции отбивается пустой строкой с обеих сторон.** Прежде
|
|
|
|
|
проверялась только строка после заголовка; перестановка секций двигает целые
|
|
|
|
|
блоки, и два заголовка оказываются вплотную. Правит `check --fix`.
|
|
|
|
|
|
|
|
|
|
**Что сделать проекту:**
|
|
|
|
|
|
|
|
|
|
1. Переименовать заголовок секции в `docs/tasks/ROADMAP.md`: `## Разработка` →
|
|
|
|
|
`## Сопровождение` (или `## Tooling` → `## Operations`, если индекс
|
|
|
|
|
английский). **`check --fix` этого не сделает**: регистр канонической секции
|
|
|
|
|
он правит сам, а чужую секцию только называет ошибкой — смысл за человеком.
|
|
|
|
|
2. Поправить поле `- **Секция:**` в файлах целей, которые в ней лежат. Порядок
|
|
|
|
|
именно такой: сперва заголовок, потом `python3 tasks.py check --dir
|
|
|
|
|
docs/tasks` покажет расхождение поимённо.
|
|
|
|
|
3. Перечитать состав секции: цели про выкладку, метрики, логи и инфраструктуру,
|
|
|
|
|
если они лежали в `Направлениях` за неимением места, переезжают сюда.
|
|
|
|
|
4. Прогнать `python3 tasks.py check --dir docs/tasks --fix`: он переставит
|
|
|
|
|
секции роадмапа в канонический порядок (`Готово` уедет вниз вместе со всем
|
|
|
|
|
содержимым) и поправит отбивку заголовков.
|
|
|
|
|
5. `docs/.pm.json`: `"canon": 4`.
|
|
|
|
|
|
|
|
|
|
## Версия 3 — 2026-08-04
|
|
|
|
|
|
|
|
|
|
Роадмап стал **состоянием проекта**, а не очередью работ: цель — возможность
|
|
|
|
@@ -34,9 +89,8 @@ upgrade` идёт по записям снизу вверх от версии п
|
|
|
|
|
3. **Секции роадмапа** — четыре вместо двух и **канонические**, в отличие от
|
|
|
|
|
секций беклога: `Готово` (достигнутые цели строкой с датой, без ссылки на
|
|
|
|
|
файл), `Запланировано` (очередь значима), `Направления` (очереди нет),
|
|
|
|
|
`Сопровождение` (чем держат проект: инструмент, процесс, эксплуатация —
|
|
|
|
|
не возможности приложения). Английский
|
|
|
|
|
вариант — `Done` | `Planned` | `Directions` | `Operations`, один язык на весь
|
|
|
|
|
`Разработка` (инструмент и процесс, не возможности приложения). Английский
|
|
|
|
|
вариант — `Done` | `Planned` | `Directions` | `Tooling`, один язык на весь
|
|
|
|
|
индекс. Переименованию проектом не подлежат: у каждой свой смысл, и в первую
|
|
|
|
|
пишет сам `close`; `tasks.py check` проверяет состав.
|
|
|
|
|
4. **Форма заголовка записи** — по типу: задача отвечает на «что нужно сделать»
|
|
|
|
@@ -93,7 +147,9 @@ upgrade` идёт по записям снизу вверх от версии п
|
|
|
|
|
идентичности**, — и убрать остальное, иначе проект возвращает себе прежнюю
|
|
|
|
|
частоту полного набора уточнением.
|
|
|
|
|
7. Переименовать секции роадмапа: `порядок` → `Запланировано`, `темы` →
|
|
|
|
|
`Направления`; завести `Готово` **первой** и `Сопровождение` последней.
|
|
|
|
|
`Направления`; завести `Готово` **первой** и `Разработка` последней
|
|
|
|
|
(порядок секций поменялся в версии 4 — если едешь сразу на неё, заводи
|
|
|
|
|
`Готово` последней и не переставляй дважды).
|
|
|
|
|
Прозаические разделы вроде «Что уже пройдено», которые велись руками,
|
|
|
|
|
разложить: звенья — строками в `Готово` (дата, слаг, что стало возможно),
|
|
|
|
|
обоснование очереди оставить прозой в `Запланировано`. Любой `##` в индексе
|
|
|
|
@@ -101,7 +157,7 @@ upgrade` идёт по записям снизу вверх от версии п
|
|
|
|
|
8. Переформулировать цели ответом на **«что приложение будет уметь»**: не
|
|
|
|
|
«Работа со слиянием», а «Исход слияния не зависит от порядка доставки».
|
|
|
|
|
Свойство поведения — законная цель. Цель, которая не про приложение
|
|
|
|
|
(процесс, инструмент, эксплуатация), переезжает в `Сопровождение`.
|
|
|
|
|
(процесс, инструмент), переезжает в `Разработка`.
|
|
|
|
|
9. `[epic]`, если он в проекте заводился: это либо цель, либо набор задач под
|
|
|
|
|
общей целью. `check` назовёт его неизвестным типом.
|
|
|
|
|
10. Прогнать `python3 tasks.py check --dir docs/tasks --fix`: он поднимет
|
|
|
|
|
Claude Opus 5