задачи: цель упразднена, у проекта появилась стадия
Тип goal и индекс ROADMAP.md убраны: цель — зонтик над параллельными направлениями, а у проекта на одного человека список работ линеен. Роадмап при этом наполовину дублировал беклог, а «что уже умеет» отвечают спеки и git log индекса. Секция «Готово» удалена, а не перенесена. Вместо цели — ось «стадия проекта»: build (беклог это план стройки, порядок строк значит зависимость, секция одна) и support (очередь правок, порядок значит важность, секции — полки домена). Стадия объявляется ключом [tasks] stage, меняется командой stage, без неё check отказывает: порядок строк нечем прочитать. Ушли теги goal:/decomposed, поле «Секция», раздел «Завершение», флаги --goal и edit --section. Версия раскладки 2 → 3, перевод проекта расписан записью журнала.
This commit is contained in:
@@ -22,6 +22,48 @@
|
||||
|
||||
---
|
||||
|
||||
## Версия 3 — 2026-08-13
|
||||
|
||||
Тип записи `goal` и индекс `ROADMAP.md` упразднены; у проекта появилась
|
||||
**стадия** — `build` (беклог это план стройки, порядок строк значит зависимость)
|
||||
или `support` (очередь правок, порядок значит важность).
|
||||
|
||||
Цель была зонтиком над параллельными направлениями — она нужна там, где список
|
||||
работ нельзя выстроить в один порядок. У проекта, который ведёт один человек,
|
||||
такого не бывает, и роадмап при этом наполовину дублировал беклог («чего ещё не
|
||||
умеет» = «что осталось в списке»), а вторую половину («что уже умеет») отвечают
|
||||
`openspec/specs/` и `git log` индекса.
|
||||
|
||||
**Что переехало.** Индекс остался один — `BACKLOG.md`. Поле меты `Секция` стало
|
||||
`Категория`; теги `goal:<слаг>`, `decomposed` и раздел `Завершение` упразднены;
|
||||
команды `list --goal`, `edit --goal`, `edit --section` и ключи `[tasks] roadmap`,
|
||||
`[tasks] completion_heading` — тоже. Появились ключ `[tasks] stage`, команда
|
||||
`tasks.py stage` и флаги `init --stage`, `adopt scan --stage`.
|
||||
|
||||
**Что сделать проекту.**
|
||||
|
||||
1. **Разобрать цели.** У каждой записи типа `goal` в `tasks/items/` два исхода, и
|
||||
выбирает человек: она становится обычной задачей (`edit <слаг> --type
|
||||
feature|fix|chore|research`) либо уходит (`close <слаг> --reason …`). Задачи,
|
||||
носившие её тег, живут дальше сами по себе. Скрипт этого не решает и говорит
|
||||
`НЕОДНОЗНАЧНО`.
|
||||
2. **Перенести содержимое `ROADMAP.md`.** Секция `Готово` **удаляется**: «что
|
||||
приложение умеет» отвечают спеки, «когда это появилось» — `git log`. Строки
|
||||
`Запланировано`, `Направления` и `Сопровождение` — это цели, и они разбираются
|
||||
шагом 1. Затем удалить сам файл и ключ `roadmap` из `.av-dev.toml`, если он там
|
||||
был.
|
||||
3. **Объявить стадию** — `tasks.py stage build` или `tasks.py stage support`.
|
||||
Приложение ещё строится и список работ линеен по зависимости — `build`;
|
||||
работает и правится точечно — `support`. Без ключа `check` отказывает: порядок
|
||||
строк нечем прочитать. На `build` секция беклога обязана остаться **одна** —
|
||||
слить полки надо руками, порядок строк в слитом списке знает только человек.
|
||||
4. **Поднять версию** — `docs.py bump`. Последним шагом.
|
||||
5. `docs.py check` и `tasks.py check --dir <каталог задач>` — до отсутствия
|
||||
дрейфа. Теги `goal:` и `decomposed`, поле `Секция` и старую форму меты снимет
|
||||
`tasks.py check --fix`.
|
||||
|
||||
---
|
||||
|
||||
## Версия 2 — 2026-08-13
|
||||
|
||||
Скилл `doc-canon` стал `canon`: префикс называл материал (`doc-`), а скилл
|
||||
|
||||
Reference in New Issue
Block a user