секции 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:
+35
-4
@@ -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`, и второго шанса объяснить себя у неё нет.
|
||||
|
||||
Reference in New Issue
Block a user