мета задачи — блоком, «хук» стал полем «Зачем»

Строкой через · мета уезжала за экран уже на трёх полях, а сам разделитель
приходилось запрещать в тексте причины и «зачем». Списком поле занимает свою
строку, запрещать нечего, и проверка длины схлопнулась до одной строки.

«Хук» переименован в «Зачем» — поле отвечает на вопрос «зачем нужна эта
задача». Слово «цель» под это не годится: оно уже занято [goal]-файлами и
тегом goal:<слаг>, и в одном блоке значило бы две разные вещи.

Хирург мета-строки — самая мутная функция скрипта, резавшая строку на куски с
запоминанием пробелов каждого, — заменён на «прочитать поля и собрать блок
заново». Тем же ходом старая форма переезжает в новую: check называет её
дрейфом, check --fix переписывает списком, Хук становится Зачем. Чужие
нераспознанные поля пересборку переживают.

Проверено на восьми сценариях: add, edit, move с причиной, sprint take/drop,
close --reason + reopen (мета собирается из текста, поднятого из git),
миграция старой формы вместе с чужим полем, отказ на мете без секции.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-03 17:30:57 +03:00
co-authored by Claude Opus 5
parent 5b80ac8ff9
commit d7f9b06e5e
7 changed files with 257 additions and 208 deletions
+20 -20
View File
@@ -25,9 +25,9 @@ description: Ведение задач и целей как каталога mar
2. **Файл — источник истины, индексы производны.** Разошлись — неправы индексы.
Согласованность механизируема и проверяется командой, а не вниманием: всё,
что ловит `tasks.py check`, не должно попадать ни в чек-лист, ни в промпт.
Поэтому **хук живёт в мета-строке файла**, а строка индекса его лишь
повторяет: пока хук лежал только в индексе, восстановление пропавшей строки
теряло его молча и навсегда. Единственное исключение намеренное: **в каком
Поэтому **«зачем» живёт в мете файла**, а строка индекса его лишь
повторяет: пока поле лежало только в индексе, восстановление пропавшей
строки теряло его молча и навсегда. Единственное исключение намеренное: **в каком
индексе лежит задача, знают индексы** — «в спринте» это свойство спринта, а
не файла, поля-состояния нет.
3. **Причина переживает запись.** Выкинутая без причины задача вернётся через
@@ -93,7 +93,7 @@ docs/tasks/
- **Статус цели выводится.** Цель закрыта, когда у неё не осталось открытых
задач; `[x]`/`[~]` руками не ведутся, а `close` цели с живыми задачами
скрипт запретит. Единственная оговорка: цель без задач неотличима — «ещё не
разобрана» или «всё закрыто». Различает **тег `decomposed`** в мета-строке
разобрана» или «всё закрыто». Различает **тег `decomposed`** в мете
цели: он ставится, когда цель разложена на задачи. Тег, а не строка в теле —
потому что проверяется механически: `check` **напоминает** о нём у пустой цели
(замечанием, не ошибкой — неразобранная цель это законное состояние), а `check
@@ -111,10 +111,10 @@ docs/tasks/
```
python3 $tk check --dir D # согласованность индексов + здоровье
python3 $tk check --dir D --fix # + починить дрейф (секция, заголовок, дубли, хук, дом)
python3 $tk check --dir D --fix # + починить дрейф (секция, заголовок, дубли, «зачем», форма меты)
python3 $tk list --dir D [--stale] [--section S] [--type T] [--tag a,b] [--goal S] [--index …] [--questions]
python3 $tk add --dir D --slug S --title T [--type goal|idea|epic] [--section S] [--goal G] [--hook H] [--tag a,b]
python3 $tk edit S --dir D [--title T] [--hook H] [--type T] [--goal G] [--add-tag a,b] [--rm-tag c]
python3 $tk add --dir D --slug S --title T [--type goal|idea|epic] [--section S] [--goal G] [--why «зачем»] [--tag a,b]
python3 $tk edit S --dir D [--title T] [--why «зачем»] [--type T] [--goal G] [--add-tag a,b] [--rm-tag c]
python3 $tk move S --dir D --section S [--reason R] [--after S | --first]
python3 $tk close S --dir D --reason R # в REJECTED.md + удалить (ушла без реализации)
python3 $tk close S --dir D --implemented # просто удалить (реализована и закоммичена)
@@ -141,9 +141,9 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
токены команд); `task` префикса не несёт, остальные кодируются `[goal]`/
`[idea]`/`[epic]` в заголовке. Текст задачи при этом русский.
**Мутации правят файл и индексы заодно** — руками строку индекса или мета-строку
не пиши, зови `add`/`edit`/`move`/`close`/`sprint`. Смена заголовка, хука, типа,
цели и **тегов** — это `edit`: он держит H1, мета-строку и индекс в синхроне.
**Мутации правят файл и индексы заодно** — руками строку индекса или мету
не пиши, зови `add`/`edit`/`move`/`close`/`sprint`. Смена заголовка, «зачем», типа,
цели и **тегов** — это `edit`: он держит H1, мету и индекс в синхроне.
Снятие тега — `--rm-tag` (после ответа на вопрос снимается `question`), смена
цели — `--goal`, он заменяет прежний `goal:*`.
@@ -156,14 +156,14 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
объяснит. Задача в наборе спринта тип не меняет вовсе: сперва `sprint drop`.
Тело задачи скрипт не трогает:
`add` кладёт заголовок, мета-строку и шаблон с подсказками, тело дописываешь
`add` кладёт заголовок, мета-блок и шаблон с подсказками, тело дописываешь
редактором (пока плейсхолдер на месте, `check` напоминает).
`check` — единственный судья согласованности; что именно он ловит, скажет его
вывод, здесь не пересказываем. Гоняй его **в начале сессии** и **после каждой
правки**, даже если правил мутациями: дрейф мог накопиться раньше. Накопившееся
чини `check --fix` — он детерминированно правит то, где истина однозначна
(секция, заголовок, дубли, хук из индекса в файл, строка в чужом индексе,
(секция, заголовок, дубли, «зачем» из индекса в файл, старая форма меты,
пометка `decomposed` у цели с задачами), а неоднозначное (задача сразу в двух
индексах, нечего восстанавливать) печатает отдельной пометкой `НЕОДНОЗНАЧНО`
это тебе, и это идёт строкой доклада. **Ссылка на исчезнувший файл в пометку не
@@ -171,7 +171,7 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
`check` — то есть видна, но в докладе её надо назвать отдельно.
`--fix` правит **и файлы** — ровно в двух местах, где источник ровно один и
выбирать не из чего: хук, оставшийся только в индексе, переезжает в мета-строку,
выбирать не из чего: «зачем», оставшееся только в индексе, переезжает в мету,
и цель, у которой есть задачи, получает тег `decomposed`. Оба случая печатаются
поимённо.
@@ -182,7 +182,7 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
отличает, поэтому эвристика даёт только замечание, и в докладе это называется
как есть: «проверено число пунктов, годность оракулов — глазами».
Формат файла, мета-строки, слага, индексов и `REJECTED.md`
Формат файла, меты, слага, индексов и `REJECTED.md`
[references/task-format.md](references/task-format.md). Там же тест «готова к
взятию» и требования к критериям приёмки.
@@ -193,7 +193,7 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
1. **Фильтр.** Делаем прямо сейчас — не заводим. Не пожалеем о потере — не
заводим. Родилось три кандидата — покажи их и спроси, какие заводить: молча
заведённая пачка и есть тот самый отказ из правила 1.
2. **Дедуп.** `list` плюс поиск по слагам, хукам и телам (`grep -ril`),
2. **Дедуп.** `list` плюс поиск по слагам, полю «зачем» и телам (`grep -ril`),
**включая `REJECTED.md`**. Нашлось среди живых — **дописываем в существующий
файл**, а не заводим соседний. Нашлось в `REJECTED.md` — покажи пользователю
ту строку и что изменилось с момента отказа (`add` предупредит и сам, но
@@ -209,7 +209,7 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
заводить её не надо. У идеи цели может не быть — она проставляется, когда
идея становится задачей.
5. `add …`, затем допиши тело редактором: одна фраза, критерии приёмки с
оракулами, рамки. Хук отвечает «почему это лежит в беклоге» — состояние,
оракулами, рамки. «Зачем» отвечает «зачем нужна эта задача» — состояние,
остаток, боль, — а не пересказывает первый абзац, и пишется **для человека**:
не «канонизация внутри транзакции», а «тело 40 МиБ держит блокировку 5 секунд,
соседние доставки уходят в отказ».
@@ -245,10 +245,10 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
Правится по ходу любой операции, которая задачи касается (но не «заодно» по
всему беклогу):
- **протухший хук** — задача изменилась, а хук отвечает на старый вопрос;
- **протухшее «зачем»** — задача изменилась, а поле отвечает на старый вопрос;
особенно после ответа на вопрос задачи: «Решено: …» на «почему это лежит в
беклоге» уже не отвечает. Переписывается `edit <slug> --hook …` — он правит
мета-строку файла и строку индекса заодно;
беклоге» уже не отвечает. Переписывается `edit <slug> --why …` — он правит
мету файла и строку индекса заодно;
- **вопрос, застрявший в прозе** — вынимается в раздел «Вопросы» плюс тег
`question` (`edit --add-tag question`), иначе он не виден ни `list
--questions`, ни правилу «задача с открытым вопросом в набор не берётся»;
@@ -329,7 +329,7 @@ python3 $tk adopt scan --from … | apply --plan … # разовая адап
- **Ничего не удаляем молча.** Файл исчезает только через `close` — `--reason`
(ушла без реализации) или `--implemented` (реализована). Прямого `rm` нет.
- **Слаги английские**, kebab-case, не транслит: `tie-break-equal-completeness`,
а не `taj-brejk-pri-ravnoj-polnote`. Заголовки, тела и хуки — русские.
а не `taj-brejk-pri-ravnoj-polnote`. Заголовки, тела и «зачем» — русские.
## Чего этот скилл не делает