секции PLAN.md: «линия» и «кусты» стали «порядком» и «темами»

Метафора требовала расшифровки при каждом употреблении, и в текстах она и
расшифровывалась: «звено упорядоченной линии продукта», «тематический куст —
цель, в последовательность не встающая». Если название приходится объяснять
рядом с каждым употреблением, объясняет не название.

Новые имена называют ровно то свойство, которым секции различаются: в первой
очередь значима и обоснована прозой, во второй порядка нет вовсе.

Заголовки строчные, как ядро/инфра в беклоге: имя секции одновременно значение
для --section, и проза приведена к тому же виду, чтобы «--section Порядок» не
выглядело правильным написанием.

Версия канона не меняется: canon.md называет файл PLAN.md и о его секциях не
говорит — их дом заголовки ## индекса, умолчание живёт в tasks.py.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-03 17:14:37 +03:00
co-authored by Claude Opus 5
parent eb10aa4177
commit 5b80ac8ff9
9 changed files with 66 additions and 35 deletions
+35 -4
View File
@@ -134,12 +134,12 @@ jellybit это уже подтвердила на 43 изменениях.
а настоящее ADR-рассуждение (отказ от DuckDB) лежит в разделе «Открытые
вопросы» файла `architecture.md`, потому что больше некуда.
- **Два плана.** `docs/plan.md` healthlog («порядок и его обоснование», 11 шагов)
и `<tasks>/PLAN.md` из `av-dev-tasks`линия целей с обоснованием порядка
прозой») — один артефакт под двумя именами.
и `<tasks>/PLAN.md` из `av-dev-tasks` («цели с обоснованием очереди прозой»)
— один артефакт под двумя именами.
- **Дубли спек у jellybit.** Из шести файлов `docs/specs/` три (`recognition`,
`review-ux`, `workflow`) описывают поведение, уже покрытое capability в
`openspec/specs/`.
- **`docs/drafts/` раскладывается без остатка:** `roadmap.md`линия целей,
- **`docs/drafts/` раскладывается без остатка:** `roadmap.md`цели в «порядок»,
`conventions-backlog.md` → задачи `[idea]`, `logical-title-model.md` (293
строки, итог «сущность `title` не вводим») → намеренный отказ, то есть ADR.
@@ -156,7 +156,7 @@ jellybit это уже подтвердила на 43 изменениях.
порядок больше. Чинить надо не дом, а индекс и критерий промоута.
**E. `docs/plan.md` растворяется в `<tasks>/PLAN.md`.** Файл удаляется, 11 шагов
становятся линией целей, ссылки в `CLAUDE.md` и паспорте переводятся.
становятся целями в «порядке», ссылки в `CLAUDE.md` и паспорте переводятся.
**F. Пути жёсткие, оба проекта приводятся к одному виду.** Плагин знает раскладку
поимённо; указателя вида `.docs.json` нет.
@@ -910,3 +910,34 @@ HTML-комментарии, невидимые в отрендеренном ma
53. **Запись в журнал версий канона проверка не заменяет.** Она видит, что копия
отстала, но не видит, что проект уже унёс старую версию к себе. Это остаётся
на человеке и сказано в обоих домах.
## 13. Секции `PLAN.md` переименованы (2026-08-03)
### Что было
Секции назывались **«линия»** и **«кусты»** — метафора, требующая расшифровки
при каждом употреблении. В текстах она и расшифровывалась: «звено упорядоченной
линии продукта», «тематический куст — цель, в последовательность не встающая».
Если название приходится объяснять рядом с каждым употреблением, объясняет не
название.
### Решено
**SS. «порядок» и «темы».** Заголовок называет ровно то свойство, которым секции
различаются: в первой очередь значима и обоснована прозой, во второй порядка нет
вовсе. Расшифровывать нечего — правило написано в самом имени.
**TT. Записи в журнал версий канона не требуется — канон этих имён не знает.**
`canon.md` называет файл `docs/tasks/PLAN.md` и ничего не говорит о его секциях:
их дом — заголовки `##` индекса, а умолчание живёт в `tasks.py`. Версия канона
поэтому не меняется, и проект вправе называть секции по-своему. Причина названа
вслух, потому что соблазн повысить версию «на всякий случай» здесь сильный, а
повышение обязало бы каждый проект что-то делать — при том что делать нечего.
### Что из этого следует
54. **Умолчание одно и живёт в `DEFAULT_PLAN_SECTIONS`.** Имена секций
по-прежнему настраиваются `--plan-sections`, а домом остаются заголовки `##`
индекса — переименование не трогает механику, только умолчание и тексты.
55. **Метафора — плохое имя для секции индекса.** Секция читается человеком без
контекста, часто из вывода `list`, и второго шанса объяснить себя у неё нет.