задачи: цель упразднена, у проекта появилась стадия

Тип goal и индекс ROADMAP.md убраны: цель — зонтик над параллельными направлениями, а у проекта на одного человека список работ линеен. Роадмап при этом наполовину дублировал беклог, а «что уже умеет» отвечают спеки и git log индекса. Секция «Готово» удалена, а не перенесена. Вместо цели — ось «стадия проекта»: build (беклог это план стройки, порядок строк значит зависимость, секция одна) и support (очередь правок, порядок значит важность, секции — полки домена). Стадия объявляется ключом [tasks] stage, меняется командой stage, без неё check отказывает: порядок строк нечем прочитать. Ушли теги goal:/decomposed, поле «Секция», раздел «Завершение», флаги --goal и edit --section. Версия раскладки 2 → 3, перевод проекта расписан записью журнала.
2026-08-13 14:26:21 +03:00
parent 0627199a1a
commit 3849f084be
26 changed files with 1128 additions and 1485 deletions
@@ -1,4 +1,4 @@
-# Формат записей и индексов
+# Формат записей и индекса

 Заголовок, мета-блок и строку индекса ставит `tasks.py add` — руками их не
 пишут. Этот файл описывает **общую форму** любой записи и то, что проверяет
@@ -9,7 +9,6 @@

 | Тип | Файл | Одной строкой |
 | --- | --- | --- |
-| 🎯 `goal` | [task-goal.md](task-goal.md) | возможность приложения |
 | ✨ `feature` | [task-feature.md](task-feature.md) | снаружи появляется то, чего не было |
 | 🐞 `fix` | [task-fix.md](task-fix.md) | поведение расходится с заявленным |
 | 🧹 `chore` | [task-chore.md](task-chore.md) | обслуживание, поведение не меняется |
@@ -25,7 +24,6 @@
 - **Тип:** fix
 - **Категория:** Ядро — вернулась из работы: остаток писал нерешённое в журнал
 - **Зачем:** ввод «а1б2» ходит в a1 — игрок не видит, что ошибся, и винит игру
- **Теги:** goal:merge-robustness

 Разбор хода читает первые два символа и молча выбрасывает остаток строки.

@@ -55,8 +53,8 @@
  **эмодзи типа**, и она **производна**: её ставит `add` и чинит `check --fix`
  по полю меты. Второго дома у типа нет — эмодзи это его отображение, как
  строка индекса это отображение файла.
- **Форма заголовка — по типу.** Цель отвечает на «что приложение будет уметь»;
-  `feature`, `fix` и `chore` — на «что нужно сделать», глаголом в неопределённой
+- **Форма заголовка — по типу.** `feature`, `fix` и `chore` отвечают на «что
+  нужно сделать», глаголом в неопределённой
  форме, перед ним допускается «не»; `research` называет предмет разведки и
  формы действия **не несёт намеренно**. Почему так — SKILL.md, «Как написана
  задача». `check` считает заголовки не в форме действия и печатает число в
@@ -67,9 +65,8 @@
  теги необязательны. Нераспознанные поля сохраняются: скрипт правит свои и не
  трогает чужие.
 - **Тип — первым полем.** Он решает, что у записи вообще может быть: какие
-  разделы обязательны, нужна ли цель, берётся ли она в работу, — и читается
-  раньше всего остального. Словарь **закрыт**: `goal` | `feature` | `fix` |
-  `chore` | `research`. Не подходит ни один — это сигнал, что в записи их два и
+  разделы обязательны и берётся ли она в работу, — и читается раньше всего
+  остального. Словарь **закрыт**: `feature` | `fix` | `chore` | `research`. Не подходит ни один — это сигнал, что в записи их два и
  её надо разделить.
 - **«Зачем» отвечает на «зачем нужна эта задача»** — состояние, остаток, боль.
  Не пересказ задачи: пересказ уже есть по ссылке. Живёт здесь, а не только в
@@ -86,19 +83,16 @@
 Тело — не план реализации и не спецификация: принятое и реализованное переезжает
 в документацию проекта, а файл задачи удаляется.

-### Поле места: «Категория» и «Секция»
+### Поле места: «Категория»

-Поле называет, **где числится строка**, и имя у него **зависит от типа**:
+Поле называет **секцию беклога, в которой числится строка** — полку домена
+(`Ядро`, `Инфра`, …), куда задачу положили и куда вернут, если она уйдёт в работу
+и вернётся. **На стройке секция одна**, и поле называет её же: различать ей
+нечего, но производность от заголовка индекса сохраняется и там.

-| Тип | Поле | Значения | Что это |
-| --- | --- | --- | --- |
-| `goal` | **Секция** | `Запланировано`, `Направления`, `Сопровождение` | часть роадмапа: состояние очереди |
-| прочие | **Категория** | секции беклога проекта (`Ядро`, `Инфра`, …) | полка домена, на которой задача лежит |
-
-Разные имена потому, что это **разные вещи**. У задачи это полка: куда её
-положили и куда вернут, если она уйдёт в работу и вернётся. У цели оно называет
-не полку, а место в очереди работ. Одно имя на два смысла их и смешивало; `check` называет
-несовпадение дрейфом, `check --fix` переименовывает.
+Прежнее имя поля — **«Секция»**: так оно называлось у целей, указывая на часть
+роадмапа. Разбор его по-прежнему принимает, `check` называет дрейфом, `check
+--fix` переименовывает.

 Имя самого места принадлежит **заголовку индекса** — файл на него лишь
 ссылается, и принадлежность сверяется по нижнему регистру.
@@ -111,7 +105,8 @@
 | --- | --- |
 | префикс `[goal]` / `[idea]` в H1 | поле **Тип** + эмодзи в H1; `[idea]` → `research` |
 | тег `kind:<род>` | поле **Тип** (род работы стал типом) |
-| поле **Секция** у задачи | поле **Категория** |
+| поле **Секция** | поле **Категория** |
+| теги `goal:<слаг>` и `decomposed` | сняты: целей больше нет |
 | поле **Хук** | поле **Зачем** |
 | мета одной строкой через `·` | мета списком, поле на строку |

@@ -147,8 +142,8 @@
 забыли назвать, она от отсутствующей не отличает. Раздела нет — отказ во взятии:
 оценивать нечем.

-**У `goal` и `research` раздела нет** — у первой границы называют её задачи, у
-второй они становятся известны, когда из разведки родятся задачи.
+**У `research` раздела нет** — её границы становятся известны, когда из разведки
+родятся задачи.

 ### Критерии приёмки

@@ -166,8 +161,7 @@
 что проверено больше проверенного, хуже, чем не проверять вовсе.

 **У `research` критериев нет** — её приёмка это записанный ответ, и описывается
-она разделами «Вопрос» и «Куда ляжет ответ». **У `goal` их заменяет
-«Завершение».**
+она разделами «Вопрос» и «Куда ляжет ответ».

 **Критерии — пол, но расхождение с ними есть дефект критериев.** Если приёмщик
 видит, что критерии закрыты, а суть задачи не достигнута, он **правит критерии и
@@ -210,44 +204,6 @@
 на снятый тег при непустом разделе посоветует тег вернуть. Снять тег, не
 опустошив раздел, — значит закольцевать себя между двумя советами.

-## Файл цели
-
-Форма та же, разделы и алгоритм — [task-goal.md](task-goal.md).
-
-```markdown
-# 🎯 Исход слияния не зависит от порядка доставки
-
- **Тип:** goal
- **Секция:** Направления
- **Теги:** decomposed
-
-Ради чего: точки из разных доставок сходятся в один часовой объект, и сегодня
-исход столкновения зависит от порядка доставки, а не от содержания.
-
-## Завершение
-
- повторная доставка тех же точек в другом порядке даёт то же состояние;
- накопительная метрика за сутки не уменьшается после повторной доставки;
- в логе видно, какая из двух точек выиграла и почему.
-```
-
- **Задачи цели здесь не перечисляются.** Перечень даёт
-  `tasks.py list --goal <слаг>`; хранимый список стал бы третьим индексом и
-  поехал бы на первой же закрытой задаче.
- **Тег `decomposed`** отличает «цель ещё не разобрана» от «все её задачи
-  закрыты» — два состояния, у которых снаружи один и тот же признак: задач нет.
-  Пометка именно **тегом**, а не строкой в теле: только так она проверяется.
-  `check` напоминает о нём у цели без задач замечанием — неразобранная цель
-  законна и зелёного прогона не ломает; `check --fix` сам ставит его цели, у
-  которой задачи есть, а цель с тегом и без задач — прямое приглашение закрыть.
- Цель живёт в `ROADMAP.md` и **никогда** — в `BACKLOG.md`.
- **Достигнутая цель не исчезает.** `close <слаг> --implemented` удаляет файл и
-  переносит строку в секцию `Готово` с датой:
-  `- 2026-08-04 \`merge-order\` — Исход слияния не зависит от порядка доставки. …`
-  Ссылки на файл в ней нет — файл удалён, а битая ссылка это ошибка `check`.
-  Поведение живёт в спеках проекта; роадмап отвечает, **когда и в каком порядке**
-  оно появилось.
-
 ## Слаг

 Латиница и цифры, kebab-case, без ведущих, хвостовых и двойных дефисов
@@ -261,9 +217,9 @@
 проходом по всем местам, где слаг упомянут, иначе останутся битые ссылки,
 которых никто не проверяет.

-## Индексы
+## Индекс

-Строка везде одной формы:
+Строка одной формы:

 ```markdown
 - [🐞 Заголовок дословно](items/slug.md) — зачем
@@ -276,52 +232,47 @@

 | Файл | Что отвечает | Секции |
 | --- | --- | --- |
-| `ROADMAP.md` | что приложение уже умеет и чего ещё не умеет | канонические и в этом порядке: `Запланировано`, `Направления`, `Сопровождение`, `Готово` (англ. `Planned`, `Directions`, `Operations`, `Done`) |
-| `BACKLOG.md` | что **можно взять** — только задачи, **в порядке очереди** | категории проекта (по умолчанию Ядро/Инфра) |
+| `BACKLOG.md` | что **можно взять**, в значимом порядке | называет проект; на стройке ровно одна (умолчание `План`), на доработке сколько нужно (умолчание `Ядро`/`Инфра`) |
 | `REJECTED.md` | что ушло без реализации и почему | — |

 Секции — **единственные заголовки `##` в индексе**: любой другой `##` в
 преамбуле проверка сочтёт секцией.

-**Порядок строк внутри секции беклога значим: это очередь.** Первая строка — то,
-что делают следующим; назначает порядок человек на груминге, и двигают его
-`move --after` и `move --first`. Одно место из очереди изъято и **производно от
-типа и заполненности**: **сырьё** (`research` без раздела «Вопрос») стоит в конце
-своей секции, потому что его не берут, и между берущимся оно каждый раз требует
+**Порядок строк внутри секции значим, и стадия решает, что он значит:** на
+стройке зависимость, на доработке важность (SKILL.md, «Две стадии»). Назначает
+его человек — раскладывая шаги или на груминге, — и двигают его `move --after`
+и `move --first`. Одно место из очереди изъято и **производно от типа и
+заполненности**: **сырьё** (`research` без раздела «Вопрос») стоит в конце своей
+секции, потому что его не берут, и между берущимся оно каждый раз требует
 открыть файл, чтобы это понять. Проверяет `check`, переставляет `check --fix`,
-и человек этот порядок не назначает — иначе он был бы приоритетом, которого
-здесь нет.
+и человек этот порядок не назначает — иначе он был бы решением, которого здесь
+нет.

 **Секции «блокеры» среди них нет.** Блокер — состояние, а не полка: он живёт до
 ответа человека, а следы остаются вопросами в файлах задач.
 Постоянно пустая секция со старой семантикой «разбираются пачками» противоречила
 бы правилу «эскалируем немедленно», поэтому `init` её не заводит, а `check`
-говорит о ней в чужом беклоге. Переезжаешь с такой секцией — удали её. В секции
-**`Запланировано`** очередь значима и обосновывается прозой; двигают строку
-`move <slug> --section Запланировано --after <другой>`. В секции **`Готово`**
-строки не той формы, что у прочих индексов: дата, слаг, заголовок — как в
-`REJECTED.md`, и по той же причине (файла уже нет, ссылаться некуда).
+говорит о ней в чужом беклоге. Переезжаешь с такой секцией — удали её.

-**Секции роадмапа закреплены** — состав, полнота, единство языка и **порядок**
-проверяются `check`; категории беклога проект называет сам. Почему так —
-SKILL.md. Порядок закреплён потому, что `Готово` копится: стоя первым,
-достигнутое отодвигает за экран то, ради чего роадмап открывают чаще всего.
+**Имена секций проект выбирает сам, а количество ограничено стадией:** на
+стройке секция одна, потому что порядок там зависимость, и разложенный по полкам
+список перестаёт быть планом. Проверяет `check`; слить секции сам он не берётся —
+в каком порядке пойдут строки слитых полок, знает только человек.

 **Заголовок секции пишется с прописной и отбивается пустой строкой с обеих
-сторон** — во всех индексах, включая категории беклога, имена которых выбирает
-проект. Написание канонических секций и отбивку правит `check --fix`; он же
-сводит написание места в мете файла с заголовком индекса.
+сторон.** Отбивку правит `check --fix`; он же сводит написание места в мете файла
+с заголовком индекса.

-Индексы **производны**: расходятся с файлом — правим индексы (`check --fix`).
+Индекс **производен**: расходится с файлом — правим индекс (`check --fix`).
 Строку руками не пишут.

 Отсюда же ответ на «а если оборвётся посередине». Мутация сперва проверяет всё
 и складывает правки, и только потом пишет: сначала все временные файлы, потом
 переименования подряд. Полной транзакции на несколько файлов файловая система не
 даёт, но окно сжато до цепочки переименований, а **всё, что в нём может
-разъехаться, — производное**: файлы целы, индексы восстанавливает `check --fix`.
+разъехаться, — производное**: файлы целы, индекс восстанавливает `check --fix`.
 Поэтому отказ на второй задаче из пяти не оставляет первую переписанной при
-нетронутых индексах.
+нетронутом индексе.

 ## `REJECTED.md`

@@ -346,27 +297,24 @@ SKILL.md. Порядок закреплён потому, что `Готово`
 Разметка сверх типа. Тип полем, потому что он один и обязателен; теги — потому
 что их много и `list --tag` уже умеет отбирать по ним порцию разбора.

- `goal:<слаг>` — цель, которой служит задача. Обязателен **у `feature`**:
-  новая возможность и есть содержание цели. У `fix`, `chore` и `research` его
-  может не быть — они служат работоспособности, а не направлению.
 - `question` — в файле есть неразобранный раздел «Вопросы».
- `decomposed` — на цели: разложена на задачи (см. «Файл цели»).

-Тега `kind:<род>` больше нет: род работы стал типом. Оставшийся в файле `check`
-называет дрейфом, а `check --fix` снимает, перенеся значение в поле «Тип».
+Тегов `kind:<род>`, `goal:<слаг>` и `decomposed` больше нет: род работы стал
+типом, а цели упразднены. Оставшиеся в файле `check` называет дрейфом, а `check
+--fix` снимает (значение `kind:` при этом переезжает в поле «Тип»).

 Отбор — `list --tag a,b`: перечисленные через запятую теги требуются **все
 сразу** (это И, не ИЛИ). Тег, которого нет ни у одной задачи, `list` называет
 вслух: молчаливый ноль читается как «таких задач нет», а чаще это опечатка.

 Свои теги проект заводит свободно (партия ревью `review-ГГГГ-ММ-ДД`, тема,
-источник) — словарь не фиксирован. В индексы теги не выносим: индексы
-производны, отбор делает `list --tag`, а не глаза.
+источник) — словарь не фиксирован. В индекс теги не выносим: он
+производен, отбор делает `list --tag`, а не глаза.

 ## Тест «готова к взятию»

-Задача готова, если из файла отвечаются четыре вопроса. Первый и четвёртый —
-общие, второй и третий у каждого типа свои и перечислены в его файле.
+Задача готова, если из файла отвечаются три вопроса. Первый общий, второй и
+третий у каждого типа свои и перечислены в его файле.

 1. **Что станет наблюдаемо иначе**, когда она сделана — снаружи: пользователю,
   владельцу сервиса или разработчику. «Отрефакторить X» — не ответ; «перестанет
@@ -379,26 +327,13 @@ SKILL.md. Порядок закреплён потому, что `Готово`
   `chore` — `Затрагивает`.
 3. **По чему видно, что закончено** — критерии приёмки с оракулами;
   у `research` вместо них `Куда ляжет ответ`.
-4. **Какую часть «Завершения» своей цели она двигает** — у задачи с целью.
-   Строкой: «двигает пункт 2 «Завершения» — накопительная метрика перестаёт
-   уменьшаться». Это и есть защита от задачи «отрефакторить X»: она проваливает
-   тест не потому, что невидима снаружи, а потому, что не находит строки, к
-   которой относится. Заодно видно обратное — достаточен ли набор задач для
-   цели: строка «Завершения», к которой не относится ни одна задача, это
-   незакрытая часть возможности.
-
-   **У задачи без цели** (`fix`, `chore`, `research`) вопрос не задаётся: они
-   служат работоспособности, а не направлению.
-
-Не отвечается первый, второй или третий вопрос → это ещё не задача, а **сырьё**:
-тип `research` без раздела «Вопрос», место — конец секции, работа над ним —
-штурм. Не отвечается четвёртый у `feature` → либо цель есть и не проставлена,
-либо это не новая возможность.
+Не отвечается любой из трёх → это ещё не задача, а **сырьё**: тип `research` без
+раздела «Вопрос», место — конец секции, работа над ним — штурм.

 Отвечается всё, но задача не делается одним заходом и не мерджится целиком →
-это **несколько задач под одной целью**, дроби сразу. Промежуточного зонтика
-между целью и задачей нет: тип `[epic]` упразднён, потому что зонтиком стала
-сама цель.
+это **несколько задач**, дроби сразу и ставь их в списке подряд. Промежуточного
+зонтика между планом и задачей нет: тип `[epic]` упразднён, и цель, ставшая
+зонтиком после него, упразднена тоже.

 Тест применяется при заведении и при переоценке. К старым задачам, которых
 операция не касается, задним числом не применяется — беклог не переоформляют