@rt-tools/agent-kit 0.16.1 → 0.17.0

package/assets/rules/task-flow.md

@@ -15,7 +15,7 @@ description: Правило под «Закон о ведении работы»
 Грузится по требованию, а не вместе с правилом: при обычном решении она не нужна — она нужна
 тому, кто разбирает промах или спорит с гардом.
 
-**Требует:** `hooks/task-flow-guard.sh`, `hooks/task-context-load.sh`, `hooks/grill-gate.sh`, `hooks/window-fill-guard.sh`, `hooks/turn-exit-guard.sh`
+**Требует:** `hooks/task-flow-guard.sh`, `hooks/task-flow-draft-guard.sh`, `hooks/task-context-load.sh`, `hooks/grill-gate.sh`, `hooks/window-fill-guard.sh`, `hooks/turn-exit-guard.sh`
 
 ## Как это называется здесь
 
@@ -26,8 +26,8 @@ description: Правило под «Закон о ведении работы»
 | замысел                                       | `docs/tasks/<ветка>/plan.md` — след задачи и этапы с признаками готовности; после написания не правится                       |
 | ход работы                                    | `docs/tasks/<ветка>/progress.md` — «Где стоим», решения по ходу, записи заходов; единственное место, где отмечается сделанное |
 | договорённость о продукте, записанная до кода | `docs/specs/<домен>/proposed/<фича>/` — спек фичи; переживает мерж и вливается в спек домена                                  |
-| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и замысел эпика рядом с ней: возможность, состав задач и их порядок                   |
-| замысел эпика                                 | запись вне папки задачи — та умирает с мержем, а эпик её переживает; каталог для неё называет компаньон правила               |
+| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и замысел рядом с ней: возможность, состав задач и порядок                            |
+| замысел эпика                                 | запись вне папки задачи: та умирает с мержем, а эпик её переживает; каталог называет компаньон правила                        |
 | папка задачи до заведения задачи              | `docs/tasks/_draft-<slug>/` — вне истории, пока номера нет                                                                    |
 | разведка                                      | заход `Explore` или `general-purpose` до первого вопроса владельцу                                                            |
 | разбор замысла ролями                         | `.claude/workflows/plan.js` — нужность, договорённость, критика, замысел                                                      |
@@ -55,28 +55,27 @@ description: Правило под «Закон о ведении работы»
 | `задача-взята`            | задача в колонке работы, ветка по номеру, папка | написать замысел                                       | `task-flow-start`  |
 | `замысел-записан`         | замысел лежит и после записи не правится        | делать первый этап                                     | `task-flow-start`  |
 | `этап-идёт`               | этап начат                                      | доделать этап и отметить в ходе работы                 | `task-flow-resume` |
-| `этапы-кончились`         | все этапы отмечены                              | прогнать набор, влить договорённость, привести тексты  | `task-flow-close`  |
+| `этапы-кончились`         | все этапы отмечены                              | влить договорённость, привести тексты, прогнать набор  | `task-flow-close`  |
 | `разбор-кончился`         | набор зелёный, тексты приведены                 | разобрать папку последним коммитом                     | `task-flow-archive` |
 | `папка-разобрана`         | папки в ветке нет, запись в архиве есть         | открыть PR черновиком                                  | `task-flow-close`  |
 | `работа-отдана`           | PR открыт черновиком                            | взять следующую задачу                                 | `task-flow-resume` |
 | `влито`                   | PR слит человеком                               | разбор работы правилами и сверка очереди               | `task-flow-archive` |
 
 Ни у одного состояния обязательное действие не звучит как «ждать»: ожидание чужого шага
-состоянием работы не является — прогон, разбор владельцем и слияние идут без исполнителя и от
-взгляда быстрее не становятся, поэтому в `работа-отдана` обязательное действие смотрит на
-следующую задачу, а не на открытый PR. Заполнение окна захода состоянием тоже не бывает: заход
-кончается передачей, работа остаётся в том состоянии, в каком стояла, а следующий заход читает
-строку и продолжает с неё. Чем ход кончается и что его концом не бывает — правило
-`turn-conduct` под тем же законом.
-
-Перечень показывается владельцу в начале работы, и на нём же отмечается, где стоим: иначе после
-шести вопросов не видно ни того, что будет дальше, ни сколько всего впереди.
-
-Последние два состояния объявить на диске уже нечем: ход работы уезжает вместе с папкой, а
-папка разбирается раньше, чем открывается PR. Признак у них поэтому в истории ветки — коммит
-разбора папки, — и читает его гард, а не строка в файле. Цена названа прямо: с этой минуты и до
-слияния состояние работы виду не подлежит, и хвост из четырёх шагов — открыть PR, дождаться
-прогона, снять черновик, попросить влить — держится паттерном, а не объявлением.
+состоянием работы не является, поэтому в `работа-отдана` обязательное действие смотрит на
+следующую задачу, а не на открытый PR. Блокированная задача следующей при этом не считается: она
+начнётся после чужого шага, то есть это то же ожидание, названное именем работы. Следующая
+берётся из очереди работ, а очередь спрашивается командой: «задач нет» — утверждение о дереве, и
+подтверждается оно выводом, а не памятью о том, что заводил сам исполнитель. Заполнение окна
+захода состоянием тоже не бывает: заход кончается передачей, а работа остаётся там, где стояла.
+Чем ход кончается — правило `turn-conduct` под тем же законом.
+
+Перечень показывается владельцу в начале работы, и на нём же отмечается, где стоим.
+
+Последние два состояния объявить на диске уже нечем: ход работы уезжает вместе с папкой, а папка
+разбирается раньше, чем открывается PR. Признак у них поэтому в истории ветки — коммит разбора
+папки, — и читает его гард, а не строка в файле. Цена: с этой минуты и до слияния состояние
+работы виду не подлежит, и хвост из четырёх шагов держится паттерном, а не объявлением.
 
 ## Ход
 
@@ -99,7 +98,7 @@ flowchart TD
     H --> I{Этап сделан}
     I -->|Да| J[Отметка в ходе работы — единственном месте, где отмечается сделанное]
     J --> I
-    I -->|Этапы кончились| T[Набор прогоняется, договорённость вливается в спек домена, тексты приводятся к сделанному]
+    I -->|Этапы кончились| T[Договорённость вливается в спек домена, тексты приводятся к сделанному, следом прогоняется набор]
     T --> N[Папка задачи разбирается последним коммитом: разбор просьбы — в описание прошлого, находки — к замыслу эпика, замысел — прочь]
     N --> S[Сверка очереди работ]
     S --> K[PR открывается черновиком; исполнитель называет номер, чего ждёт и что сделает следом]
@@ -113,45 +112,52 @@ flowchart TD
 
 ## Как закон применяется здесь
 - **Правка кода приложения отбивается, пока работа не дошла до состояния, в котором код
-  правится.** Гард требует четыре вещи: папку задачи по имени ветки, замысел в ней, объявленное
-  в ходе работы состояние и названную в замысле договорённость о продукте.
+  правится.** Гард хода работы требует три вещи: папку задачи по имени ветки, замысел в ней и
+  объявленное в ходе работы состояние. Договорённость о продукте требует свой гард на те же
+  события.
 - **Гард судит объявленный переход, а не наличие файлов.** Пустой замысел, положенный ради
   снятия отказа, лежит так же, как написанный, поэтому отказ снимает объявленное состояние —
   `этап-идёт`, `этапы-кончились`, `разбор-кончился`. Четвёртый путь не состояние, а история
   ветки: папка, разобранная её коммитом, означает отданную работу, и правка по замечаниям идёт
   без замысла на диске.
+- **Строка состояния, переведённая вперёд, — то же объявление намерения, только
+  машиночитаемое.** Она точнее всякого обещания, и пустоты за ней не видно никому. Состояние
+  объявляется тем ходом, в котором его обязательное действие начато делом, а не тем, в котором о
+  нём отчитались.
 - **Отказ по состоянию называет обязательное действие того состояния, которое объявлено.**
   Исполнитель, которому сказано только «не в том состоянии», перепишет строку состояния вместо
   того, чтобы сделать шаг.
 - **Именем состояния считается только слово из перечня.** Своё слово не говорит ни о входе, ни о
   выходе, ни об обязательном действии, а перечень называет все три.
-- **Состояние судится раньше договорённости и её обхода.** Строка о неизменном поведении снимает
-  требование договорённости о продукте, а не требование дойти до правки кода.
+- **Два требования — два гарда, и снять одно можно, не теряя второго.** Одним файлом отказ от
+  требования договорённости снимал заодно папку задачи — то, о чём дерево не просило. Судят
+  порознь: строка о неизменном поведении снимает договорённость, а не требование дойти до
+  правки кода.
 - **Влитая договорённость ветку не запирает.** После вливания директории «предложено» на диске
   нет, а замысел на неё ссылается до конца работы: гард отличает влитое от незаведённого по
-  истории ветки. Иначе последний коммит PR закрывал бы дорогу правкам по замечаниям.
+  истории ветки. Иначе правкам по замечаниям не было бы дороги.
 - **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**` —
   признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не принимается.
+- **Что требует слова владельца, берётся списком, а не оценкой на месте.** Оценку «это
+  безопасно» назначает тот, кому она в эту минуту удобна, и меняется она вместе с настроением
+  разговора, а не со свойствами команды: за один заход одна и та же команда была сначала слишком
+  опасной, чтобы её позвать, а через два хода — достаточно безопасной, чтобы позвать без спроса.
+  Недовольство владельца простоем разрешением не бывает: оно говорит, что стоять не следовало, а
+  не что можно то, чего нельзя было ходом раньше.
 - **Папка задачи заводится под любую работу, без исключений.** Исключение, у которого есть хоть
-  одна законная форма, исполняется как разрешение. Заводится она всегда и до первой правки:
-  сколько заходов уйдёт на работу, заранее не знает никто.
-- **Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве.** Гард спрашивает её
-  с диска, и папка, ни разу не закоммиченная, проходит все правки без единого отказа — а признак
-  отданной работы берётся из истории, и там её нет. Отказ приходит в последней точке, на
-  открытии заявки, когда папка уже разобрана своими руками: чинить нечего, замысел снят, и
-  собирать его приходится заново по памяти. Второе следствие тише: ход работы, живущий в
-  рабочем дереве, не виден никому — владелец видит ветку без единого следа того, что в ней
-  делается, а следующий заход находит пустоту вместо «Где стоим». Вне истории законен один
-  черновик без номера: заводить в неё нечего, пока нет имени.
-- **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Кнопку
-  слияния нажимает человек на хостинге, куда гард не достаёт, и вливает он, как только видит
-  зелёное, — закрывающему коммиту места не остаётся вовсе. Цена перестановки: замысла с этой
-  минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
+  одна законная форма, исполняется как разрешение. Заводится она до первой правки: сколько
+  заходов уйдёт на работу, заранее не знает никто.
+- **Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве.** Незакоммиченная,
+  она проходит все правки без отказа, а признак отданной работы берётся из истории: отказ придёт
+  в последней точке, когда замысел уже снят своими руками. Вне истории законен один черновик без
+  номера.
+- **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Человек
+  вливает, как только видит зелёное, и закрывающему коммиту места не остаётся вовсе. Цена:
+  замысла с этой минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
 - **Открыв PR, исполнитель называет владельцу три вещи: номер, чего ждёт и что сделает следом.**
-  Ждёт он прогона, следом идёт снятие черновика. Зелёный прогон на странице однозначным не
-  бывает: он говорит, что не сломано, и молчит о том, что кнопка слияния у черновика
-  заблокирована.
+  Ждёт он прогона, следом идёт снятие черновика. Зелёный прогон однозначным не бывает: он
+  говорит, что не сломано, и молчит о заблокированной у черновика кнопке слияния.
 - **Просьба о слиянии — отдельный ход, и раньше зелёного прогона её не бывает.** Порядок один:
   папка разобрана и запушена → PR открыт черновиком → прогон зелёный → черновик снят →
   исполнитель просит влить, называя номер.
@@ -163,9 +169,10 @@ flowchart TD
   становится разрешением работать без замысла везде, куда он не смотрит.
 - **Взятая задача ходом не кончается.** Заведение задачи, ветки, колонки и папки — подготовка, а
   не работа: они переводят её в состояние записанного замысла, где обязательное действие уже
-  другое. Граница состояния выглядит законченным куском лучше всякой вехи, а владельцу отчёт о
-  взятой задаче неотличим от остановки. Держит это страж выхода хода, называя в отказе первый
-  этап замысла.
+  другое. Держит это страж выхода хода, называя в отказе первый этап замысла.
+- **Ожидание одной части этапа остановкой этапа не бывает.** Части, которые от ожидаемого не
+  зависят, делаются тем же ходом. Владельцу называется, что уже сделано и что осталось на его
+  шаг, — этим ожидание и отличается от остановки.
 - **Сделанное отмечается только в ходе работы.** «Где стоим» перезаписывается каждым заходом, а
   не дописывается: это первое, что читает следующий заход.
 - **Слово для нового понятия ищется в словаре дерева.** Общую часть везёт пакет, предметную
@@ -174,97 +181,90 @@ flowchart TD
 - **Папка задачи заводится черновиком и получает номер командой.** До конца разбора неизвестно,
   сколько задач из него выйдет, поэтому номер не может быть первым. Команда заведения
   переименовывает черновик, проставляет шапку замысла и собирает папку с образца, снимая с копий
-  шапку раскладки: оставленная в копии, она отбивает первую же правку разбора просьбы.
-- **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ — задачи
-  за ним ещё нет, и спросить о нём некого.
+  шапку раскладки.
+- **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ.
 - **Следующая задача берётся из замысла эпика, а список очереди работ спрашивается только там,
-  где эпика нет.** Список отсортирован номером, и по нему первая задача чужого эпика неотличима
-  от своей. Замысел открывается перед взятием; кончившийся эпик называется владельцу тем же
-  ходом, которым берётся работа вне его.
+  где эпика нет.** По списку, отсортированному номером, первая задача чужого эпика неотличима от
+  своей. Кончившийся эпик называется владельцу тем же ходом, которым берётся работа вне его.
 - **Эпик не закрывается по признаку, подтверждённому только чтением.** Признак, проверяемый
   глазами, называется проверенным лишь вместе с командой или замером и их выводом. Пометка
   «подтверждается живым замером» — обещание проверки, а не проверка.
 - **Задачи эпика заводятся все разом, тем же ходом, что и сам эпик.** Заведение по одной прячет
-  объём: на борде эпик из десяти задач выглядит одной. Номера возвращаются в раздел порядка той
-  же правкой — без них «взять следующую» отвечает названием, а не карточкой. Метку эпика несёт
-  только его карточка.
-
-- **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка говорит, что эпик
-  есть, но порядка задач не держит; папка задачи держала бы его ровно до слияния первой из них.
-  Каталог называет компаньон правила: замысел, положенный каждым заходом заново, теряет решения
-  предыдущих.
+  объём. Номера возвращаются в раздел порядка той же правкой — без них «взять следующую»
+  отвечает названием, а не карточкой. Метку эпика несёт только его карточка.
+
+- **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка порядка задач не
+  держит, а папка задачи держала бы его до слияния первой из них; каталог называет компаньон
+  правила. Имя, адрес и способ, названные владельцем по ходу, дописываются туда же тем ходом,
+  каким приняты.
 - **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ лежит
-  в разборе просьбы и в замысле эпика; они читаются, но образцом не считаются. Повторяемая часть
-  открывается целиком — обходом каталогов, а не одним файлом, за которым пришли.
+  в разборе просьбы и в замысле эпика; образцом они не считаются. Повторяемая часть открывается
+  целиком — обходом каталогов, а не одним файлом, за которым пришли.
 - **Путь к образцу лежит вне дерева и приходит в заход хуком запуска сессии.** Имя чужого дерева
   в файлы репозитория не пишется: там законна ссылка без имени. Каталог для записи — тот же, где
   лежит передача захода. Не записанный так, образец теряется на первой же чистке контекста.
 - **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
-  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл; через
-  сутки этого нет ни у кого. Разбор кончается правкой слоя правил или предложением наружу. Ведёт
-  его роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт разбор само.
+  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл. Разбор
+  кончается правкой слоя правил или предложением наружу; ведёт его роль разбора закрытой задачи,
+  если дерево её разложило.
 - **Разбор закрытой работы уходит в фон, а исполнитель берёт следующую задачу.** Роль работает
-  своим ходом и ничего не спрашивает; держать ради неё заход незачем. Сводку собирают до запуска,
-  вернувшиеся находки принимают одним ходом: записать и продолжить прежнее.
+  своим ходом и ничего не спрашивает. Сводку собирают до запуска, вернувшиеся находки принимают
+  одним ходом.
 - **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
   заготовка правки чужого дерева, и уехавшая без разбора, она становится работой того, кто её не
-  заказывал. Сводка наблюдений уезжает всегда: она говорит, чем пользовались, и мнением не
-  бывает.
+  заказывал. Сводка уезжает всегда: она говорит, чем пользовались, и мнением не бывает.
+- **Дешёвый шаг закрытия идёт раньше дорогого, а прогон — после вливания.** Вливание
+  договорённости и приведение текстов стоят минуты, прогон — окно захода. Прогон, идущий после
+  вливания, вдобавок проверяет и его самого: идущий до, он смотрит то состояние дерева, которое
+  в главную ветку не поедет.
 - **Договорённость вливается в спек домена одним из последних коммитов ветки, до открытия PR.**
   К этому моменту код написан, привязки известны, и в главной ветке директория `proposed/` не
   появляется вовсе. Готовые к вливанию перечисляет `npm run check:specs`.
 - **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает то,
   что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка очереди.
-- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Требование стоит здесь, а не
-  на слиянии: слияние нажимает человек на хостинге, где гардов нет, и его отказ до владельца не
-  доходит. Судится содержимое ветки, а не рабочее дерево.
+- **Открытие PR и снятие черновика отбиваются, пока ветка везёт папку своей задачи.** Требование
+  стоит здесь, а не на слиянии: слияние нажимает человек на хостинге, где гардов нет, и его отказ
+  до владельца не доходит. Снятый черновик он читает как приглашение влить и нажимает кнопку, не
+  дожидаясь коммита уборки, — три работы подряд уехали в главную именно так. Судится содержимое
+  ветки, а не рабочее дерево.
 - **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, и
-  первым уходит разбор просьбы — единственная запись слов владельца. Что именно увезено,
-  требование не судит: это судит владелец.
-- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.** Работа, вливаемая
-  частями, папку до конца не разбирает. Чтение из команды работает и без сети. Пустая причина
+  первым уходит разбор просьбы — единственная запись слов владельца.
+- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.** Пустая причина
   обходом не считается, а сам обход снимает отказ, но не гасит строку сверки очереди — иначе он
   через месяц становится рабочим путём.
 
 ## Чего из закона здесь нет
 
-Полноту записанного понимания не проверяет ничто, и проверки на неё не будет: машине видно
-наличие записи, но не то, что в ней закрыты все пробелы. Разбор из одной строки проходит гард
-так же, как разбор на сто. То же с вопросом, который стоило задать и не задали, — он не
-оставляет следа. Оба разобраны решениями в законе: судит владелец.
-
-Гард судит по путям правки, а не по тому, меняет ли работа поведение на самом деле.
-Рефакторинг, снаружи не видный, упирается в требование договорённости и проходит обходом с
-причиной. Своего признака рефакторингу не заводится: оценку «поведение не меняется»
-назначал бы тот, кому она мешает.
-
-Ничто из самого разбора не проверяется, и всё это держится памятью того, кто его ведёт.
-Разговор с владельцем инструментом не является — гард видит правку файла и ничего не знает
-ни о том, была ли разведка до первого вопроса, ни о том, задан ли каждый из шести
-обязательных вопросов, ни о том, ответил ли на них владелец. Образец разбора перечисляет их
-таблицей, но пустая таблица проходит так же, как заполненная.
-
-Гард разговора судит завершение хода, а не отправку вопроса. К моменту отказа вопрос уже у
-владельца, и владелец видит его вместе с отбитым ходом: требование срабатывает, но исполняется
-задним числом. Прозаический вопрос инструментом не является, и раньше поймать его нечем.
-Отсюда порядок: правило работы читается первым движением захода, до первой реплики владельцу,
-а не по отказу гарда; гард отмечает пропуск, но не отменяет его.
-
-Неизменность замысла не стережёт ничто: `plan.md` правится тем же инструментом, что и
-остальные тексты, и правка по ходу отличима от первоначальной записи только по истории.
-Держится это тем же, чем и порядок разбора.
-
-Приведение текстов к сделанному не проверяет ничто, и проверки на него не будет: что устарело
-в правиле и в спеке, машине не видно — раздел «Чего из закона здесь нет» не читает ни одна
-сверка, а «Что не входит» выглядит верным ровно так же, как в день, когда его писали. Держится
-это шагом закрытия работы и следом задачи в замысле: там названо, что перечитать. Правило и
-спек правятся в ветке, закон — нет: его статья приносится владельцу текстом, а работа идёт
-дальше без неё.
-
-Что именно перенесли в архив, не проверяется. Гард видит, что папка уезжает в главную ветку и
-что ветка что-то в архив добавила, но не может судить, то ли это и стоило ли переносить именно
-это. Сверять содержимое машине нечем — смотрит владелец на ревью. Отсюда же и обход: если
-работа вливается частями, папку до конца не разбирают, а причина остаётся в PR.
+Полноту записанного понимания не проверяет ничто: машине видно наличие записи, но не то, что в
+ней закрыты все пробелы. То же с вопросом, который стоило задать и не задали, — следа он не
+оставляет. Судит оба владелец.
+
+Гард судит по путям правки, а не по тому, меняет ли работа поведение на самом деле. Своего
+признака рефакторингу не заводится: оценку «поведение не меняется» назначал бы тот, кому она
+мешает.
+
+Ничто из самого разбора не проверяется. Разговор с владельцем инструментом не является: гард
+видит правку файла и не знает ни о разведке до первого вопроса, ни о шести обязательных, ни об
+ответах на них — пустая таблица проходит так же, как заполненная.
+
+Гард разговора судит завершение хода, а не отправку вопроса: к моменту отказа вопрос уже у
+владельца. Отсюда порядок — правило читается первым движением захода, а не по отказу гарда.
+
+Неизменность замысла не стережёт ничто: правка по ходу отличима от первоначальной записи только
+по истории.
+
+Приведение текстов к сделанному не проверяет ничто: что устарело в правиле и в спеке, машине не
+видно. Держится это шагом закрытия и следом задачи в замысле — там названо, что перечитать.
+Правило и спек правятся в ветке, закон — нет: его статья приносится владельцу текстом, а работа
+идёт дальше без неё.
+
+Что именно перенесли в архив, не проверяется: гард видит, что папка уехала и что ветка что-то в
+архив добавила, а то ли это — судит владелец на ревью.
+
+Гард папки задачи судит вызов исполнителя, а не кнопку хостинга: человек, вливающий работу со
+своей стороны, проходит мимо него молча, и папка уезжает в главную ветку целой. Гард закрывает ту
+половину случаев, где вливает исполнитель; на второй требование держится оставшимся шагом,
+который стоит разделом в теле заявки и произносится вслух.
 
 Порядок отдачи работы дерево вправе перевернуть надстройкой, и тогда часть шагов пакета
 перестаёт исполняться. Какие именно — не считает ничто: перечень отменяемого пишется руками, а

package/assets/rules/testing.md

@@ -73,7 +73,10 @@ flowchart TD
   Юнит на тот же расчёт остаётся долгом: между верным решением и тем, что человек его видит, лежит
   всё, чего юнит не касался.
 - **Сквозной тест, погашенный переменной окружения, покрытием не считается.** Выключатель по
-  состоянию стенда — пропуск случая, выключатель по переменной — невыполненный тест.
+  состоянию стенда — пропуск случая, выключатель по переменной — невыполненный тест. Состоянием
+  стенда при этом считается то, чего на нём не бывает по устройству, а не то, что оставил на
+  экране соседний тест: снятие по чужому следу закон покрытием не считает, и от законного
+  пропуска оно отличается только причиной.
 - **Упоминание в тесте сценария, которого в спеках нет, роняет проверку.** Так ловится
   переименованный или выкинутый сценарий: тесты при этом остаются зелёными.
 - **Решение выносится в чистую функцию и проверяется вызовом.** Компонент и сервис остаются тонкой
@@ -139,6 +142,16 @@ flowchart TD
   проверки и с тех пор только сокращается: дописанная строка гасит сигнал, а не причину, и в
   истории выглядит так же, как починка. Место, где проверка права по букве и не права по существу,
   разбирает владелец, а до его ответа верна проверка.
+- **Обмен принимается прочитанным с обеих сторон, а не по успеху вызовов.** Отправка и правка
+  состояния отвечают успехом и тогда, когда прочитать результат нечем: две с лишним сотни записей
+  простояли новыми, потому что забрать их было некому, а отметились только те, чей файл ещё лежал
+  на диске у отправителя. Заводя сторону обмена, называют вторую: чем читают, кто читает и что
+  будет, если её нет. Ответ «нечем» пишется словом — молчание о ней читается как рабочий обмен.
+- **Значение, общее двум сторонам обмена, берётся у объявившей стороны, а не считается заново.**
+  Признак записи, форма груза, способ счёта ключа — своя копия любого из них расходится с
+  оригиналом молча, и обе стороны при этом зелены: одна пишет под своим значением, другая ищет
+  под своим. Проверяется это сценарием, который считает значение обоими путями и сверяет их между
+  собой, а не по одному на каждой стороне.
 - **Тест, утверждающий отсутствие, зелен и тогда, когда ищет не то.** Совпадения нет ни у верного
   текста, ни у опечатки в образце, ни у переименованного ключа — отличить их по цвету прогона
   нечем. Отрицательное утверждение поэтому идёт в паре с положительным: сначала проверяется, что

package/assets/rules/turn-conduct.md

@@ -43,6 +43,10 @@ description: Правило под «Закон о ведении работы»
 назначенном порядке, объявление намерения и названная, но не запущенная команда. Что при этом
 должно быть верно — ниже, в статьях о применении закона.
 
+Ход, кончающийся при идущем эпике, показывает владельцу его положение — той же таблицей, какой
+оно уходит в передаче: порядок задач лежит записанным, а тому, ради кого исполнитель по нему
+идёт, состояние очереди иначе не видно ни на одном ходу.
+
 ## Где это лежит
 
 В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
@@ -80,10 +84,16 @@ flowchart TD
   быстрее не становятся. Ход, кончившийся такой сводкой, владелец читает как работу: она полна, в
   ней названы номера и состояния, и пустоты за ней не видно. О чужом шаге говорят вместе с начатым
   своим, а не вместо него.
+- **Чужой шаг бывает двух родов, и второй не кончится сам.** Прогон и разбор идут без
+  исполнителя и кончатся без него; отбитое разрешение не кончится никогда — его ждут. Работа,
+  упершаяся в разрешение, доводится до конца без той части, которую разрешение открывает, а
+  непройденное называется в теле заявки, где его читает ревьювер: реплика живёт до следующего
+  сообщения, тело заявки — до слияния.
 - **Свой незакрытый шаг владельцу не передаётся.** Список остатков, названный аккуратно, читается
-  как рассказ о работе — тем полнее, чем он аккуратнее, — и владелец разбирает то, что мог
-  доделать сам исполнитель. Чужой шаг сводкой называют, свой — делают: незапушенная ветка,
-  неотмеченная запись груза и незакрытая колонка чужими шагами не бывают.
+  как рассказ о работе, и владелец разбирает то, что мог доделать сам исполнитель. Чужой шаг
+  сводкой называют, свой — делают. Формой вопроса это не чинится: вопрос законен там, где ответа
+  нет ни в правилах, ни в дереве. Список остатков пишется после того, как из него вычеркнуто всё,
+  что исполнитель мог закрыть сам.
 - **Меню при назначенном порядке.** Выбор, предложенный владельцу, пока эпик не кончился, — это
   просьба назначить порядок заново. Работы в эпике не осталось — так и говорится: эпик кончился, —
   а не «чем займёмся».
@@ -99,9 +109,17 @@ flowchart TD
   и что ему для этого нужно — без этого варианты выглядят равными, и выбор идёт по доводам со
   стороны кода: «меньше путей», «строку запуска не трогаем». Знание, которое делает вариант
   негодным, пишется в сам вариант, а не остаётся у того, кто его составил.
+- **Названное владельцем состояние дерева снимается вызовом раньше объяснения.** «Конфликты»,
+  «прогон красный», «ветка отстала» — указание на то, что надо снять, а не тема для разбора.
+  Причина называется после починки и только если её спрашивали: объяснение выглядит работой, не
+  трогая при этом ни одной ветки. Вопрос «почему», стоящий в том же сообщении, требования снять
+  состояние не отменяет — он идёт вторым.
 - **Пересказ действующего порядка без оценки читается как одобрение.** На прямой вопрос владельца
   «как это работает» ответ фактами верен и недостаточен: устройство, названное спокойно, звучит
   принятым. Годность порядка для того, кто им пользуется, называется вместе с ним.
+- **Путь к файлу заданием не бывает.** Строка с адресом называет файл, а не действие;
+  прочитанная как поручение, она даёт заходу задание, которого владелец не давал. То же и с
+  любой репликой, где нет глагола: уточнить дешевле, чем написать полсотни файлов мимо просьбы.
 - **Прерывание работы владельцем называется вслух.** Пришло задание, останавливающее начатое, —
   исполнитель говорит, что стоит, на чём остановлено и что будет с прежней работой, и только потом
   берётся за новое. Молчание об этом владелец читает как «прежнее кончилось».
@@ -121,22 +139,16 @@ flowchart TD
 - **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния у
   неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки дерева, не
   кончается и здесь.
-- **Взятая задача — ещё не начатая работа, и ход на ней не кончается.** Ветка по номеру заведена,
-  колонка сдвинута, номер назван владельцу — а каталога задачи при ветке нет: обязательное
-  действие состояния «задача-взята» не сделано ни строкой. Второй признак такой ход отпускает
-  целиком, потому что работы в нём много — заведение ветки, перевод колонки, уборка соседних
-  веток, — и «была ли за ход работа» отвечает не на тот вопрос, что «доведена ли работа до конца
-  объявленного состояния». Отчёт при этом встаёт ровно на место следующего действия и выглядит
-  завершённым куском лучше всякой другой вехи. Судит это страж отдельным ярусом; ветка без номера
-  задачи под него не подпадает, а собранный шаблон папки его снимает — заполненность замысла
-  машине не видна.
+- **Взятая задача — ещё не начатая работа, и ход на ней не кончается.** Заведение ветки, перевод
+  колонки и названный владельцу номер — подготовка: обязательное действие состояния
+  «задача-взята» не сделано ни строкой, а работы в ходе много, и признак «была ли работа» его
+  отпускает. Судит это страж отдельным ярусом; ветка без номера задачи под него не подпадает, а
+  собранный шаблон папки его снимает.
 - **Разведка ходом не кончается, сколько бы её ни было.** Переключение ветки, подтягивание,
   просмотр истории и чтение заявок — не работа, а подготовка к ней; ход, собранный из них одних,
-  оставляет работу там же, где она стояла. Признак работы у стража этого прежде не различал: он
-  знает первое слово команды, и читающая подкоманда совпадала с ним наравне с коммитом. Разведка
-  при этом выглядит работой лучше всего остального — в ней команды, точные числа и проверяемые
-  ответы, — поэтому ход, набитый ею, читается полным и заходом, и владельцем. Судятся части
-  составной команды по одной: чтение, соединённое с правкой, работой остаётся.
+  оставляет работу там же, где она стояла. Выглядит она работой лучше всего остального — в ней
+  команды, точные числа и проверяемые ответы. Судятся части составной команды по одной: чтение,
+  соединённое с правкой, работой остаётся.
 - **Ответ владельцу действием не работает и последним в ходе не стоит.** Порядок внутри хода
   один: работа, потом первый шаг следующей, и только потом текст. Обратный порядок — работа,
   отчёт, конец — стоит за каждой остановкой, которую разбирали: отчёт есть форма завершённости, и
@@ -170,9 +182,8 @@ flowchart TD
   признак «команда была» подтверждал бы одно другим. Прошлый ход не годится: состояние дерева
   меняется, и вчерашний вывод о нынешнем молчит.
 - **Гард утверждения ждёт текст ответа, а не судит запись, какой застал.** Текст ложится в запись
-  хода не раньше, чем хост зовёт хук, и гард, прочитавший файл первым, видит ход, в котором
-  владельцу не сказано ничего. Не дождавшись текста, гард возвращает ход: пустая запись означает
-  не «сказать было нечего», а «прочитать нечего».
+  хода не раньше, чем хост зовёт хук. Не дождавшись его, гард возвращает ход: пустая запись
+  означает не «сказать было нечего», а «прочитать нечего».
 - **Слово-утверждение гард ловит, неверный вывод — нет.** Об образце, судимом по одному его файлу,
   и о пути, которым человек не пойдёт, судить нечем: там нет ни слова, ни команды, с которой
   сверять. Это известная граница гарда, и держат её статьи ниже, а не он.
@@ -195,6 +206,10 @@ flowchart TD
   запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
   следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
   повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
+- **Ожидание своего же замера ведётся одним ожиданием, а не уведомлением на каждый шаг.**
+  Уведомление ставится там, где на каждое событие надо действовать; где значим только итог —
+  одно ожидание, кончающееся вместе с замером. Иначе замер назначает себе ход на каждый свой
+  шаг, а наполнить их нечем.
 - **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
   соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
   условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
@@ -232,13 +247,11 @@ flowchart TD
   поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и что осталось за
   его словом, — а не выбор из вариантов вместо и того и другого.
 - **Признак необратимости берётся из списка, а не выводится доводом.** Список составлен тем, кто
-  обратимость уже взвесил: необратимое в нём осталось, обратимое из него снято. Довод «действие
-  уходит наружу и не откатывается» приходит в контекст всегда, а список — только когда его
-  прочитали, и применённый поверх списка довод отменяет список целиком. Отменяет молча: со стороны
-  это выглядит осторожностью, а не пропуском шага. Действия, которого в списке нет, исполнитель на
-  слово владельца не гейтит, даже если оно уходит наружу. Шаг, снятый из списка разбором прошлого
-  промаха, тем более: довод, которым его туда возвращают, уже разобран и отклонён — и дважды
-  подряд готовая работа вставала перед снятым шагом.
+  обратимость уже взвесил. Довод «действие уходит наружу и не откатывается» приходит в контекст
+  всегда, а список — только когда его прочитали, и применённый поверх списка довод отменяет
+  список молча: со стороны это выглядит осторожностью, а не пропуском шага. Действия, которого в
+  списке нет, исполнитель на слово владельца не гейтит, даже если оно уходит наружу; шаг, снятый
+  разбором прошлого промаха, — тем более.
 - **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии нет.**
   Отбивает гард происшествия — на завершении хода: к моменту признания промах уже случился, и
   ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла; промах,

package/assets/rules/turn-entry.md

@@ -97,3 +97,9 @@ flowchart TD
 - **Передача пишется для машины, а не для владельца.** Обращение в ней — «спроси у него, чем
   кончилась проба» — уходит в пустоту: к минуте, когда передачу читают, владельца в разговоре
   ещё нет.
+- **Вопрос, записанный передачей, вопросом владельцу не становится.** Адресован он её автору —
+  тому же заходу, который его отложил, — и до владельца доходит только после сверки с ходом
+  работы: часть таких вопросов закрыта его шагом, и спрашивать по ним значит спрашивать про уже
+  назначенное. Унаследованный вопрос тем и опасен, что выглядит заданным раньше и потому
+  решённым: меню «зафиксировать, оставить или откатить» уходило владельцу дважды, притом что
+  отметка сделанного этапа и его фиксация в ветке — обычный шаг работы.

package/assets/samples/tasks/_template/grill.md

@@ -1,5 +1,10 @@
 # Разбор просьбы
 
+<Работа, начатая с приехавшего груза, называет здесь его записи — ключами полностью, как их
+печатает чтение приёма. Восьми знаков не хватает: отметка с коротким ключом отбивается строкой
+«такой записи у дерева нет». Этот файл уезжает в описание прошлого, и после разбора папки ключи
+живут только здесь.>
+
 ## Просьба владельца
 
 > <дословно, без пересказа>

package/assets/samples/tasks/_template/plan.md

@@ -4,6 +4,9 @@
 **Драфт:** `<путь к договорённости о продукте>`
 **Поведение:** меняется
 
+Дерево, которое пишет договорённость прямо в спек домена, называет вместо драфта его:
+`**Спек:** `<путь к спеку>``.
+
 Работа, не задевающая код приложения, договорённости не требует — тогда вместо строки драфта
 стоит `**Поведение:** не меняется — <причина владельца>`; пустая причина не принимается.