@rt-tools/agent-kit 0.16.1 → 0.18.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`, `hooks/work-start-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,59 @@ flowchart TD
 
 ## Как закон применяется здесь
 - **Правка кода приложения отбивается, пока работа не дошла до состояния, в котором код
-  правится.** Гард требует четыре вещи: папку задачи по имени ветки, замысел в ней, объявленное
-  в ходе работы состояние и названную в замысле договорённость о продукте.
+  правится.** Гард хода работы требует три вещи: папку задачи по имени ветки, замысел в ней и
+  объявленное в ходе работы состояние. Договорённость о продукте требует свой гард на те же
+  события.
 - **Гард судит объявленный переход, а не наличие файлов.** Пустой замысел, положенный ради
   снятия отказа, лежит так же, как написанный, поэтому отказ снимает объявленное состояние —
   `этап-идёт`, `этапы-кончились`, `разбор-кончился`. Четвёртый путь не состояние, а история
   ветки: папка, разобранная её коммитом, означает отданную работу, и правка по замечаниям идёт
   без замысла на диске.
-- **Отказ по состоянию называет обязательное действие того состояния, которое объявлено.**
+- **Строка состояния, переведённая вперёд, — то же объявление намерения, только машиночитаемое.**
+  Пустоты за ней не видно никому: состояние объявляется тем ходом, в котором его обязательное
+  действие начато делом, а не тем, в котором о нём отчитались.
+- **Отказ по состоянию называет обязательное действие объявленного состояния.**
   Исполнитель, которому сказано только «не в том состоянии», перепишет строку состояния вместо
   того, чтобы сделать шаг.
 - **Именем состояния считается только слово из перечня.** Своё слово не говорит ни о входе, ни о
   выходе, ни об обязательном действии, а перечень называет все три.
-- **Состояние судится раньше договорённости и её обхода.** Строка о неизменном поведении снимает
-  требование договорённости о продукте, а не требование дойти до правки кода.
+- **Два требования — два гарда, и снять одно можно, не теряя второго.** Одним файлом отказ от
+  требования договорённости снимал заодно папку задачи — то, о чём дерево не просило. Судят
+  порознь: строка о неизменном поведении снимает договорённость, а не требование дойти до
+  правки кода.
 - **Влитая договорённость ветку не запирает.** После вливания директории «предложено» на диске
   нет, а замысел на неё ссылается до конца работы: гард отличает влитое от незаведённого по
-  истории ветки. Иначе последний коммит PR закрывал бы дорогу правкам по замечаниям.
+  истории ветки. Иначе правкам по замечаниям не было бы дороги.
 - **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**` —
   признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не принимается.
+- **Что требует слова владельца, берётся списком, а не оценкой на месте.** Оценку «это безопасно»
+  назначает тот, кому она удобна, и меняется она с настроением разговора, а не со свойствами
+  команды. Недовольство владельца простоем разрешением не бывает.
+- **Заход работу не начинает сам.** Начало требует слова владельца в этом же заходе: передача,
+  состояние из хука запуска и назначенный эпик говорят, что делать, если работать, и молчат о
+  том, работать ли. Судится это формой реплики, а не смыслом: правка кода после пустой реплики,
+  одного слова или одного пути ход не заканчивает.
+- **Указание работать по ходу работы покрывает все его шаги, включая меняющие историю.** Отметка
+  этапа, пуш и заявка предписаны им самим: спрашивают о том, чего в нём нет.
+- **Вопрос, записанный прошлым заходом, вопросом владельца не становится.** Он адресован автору
+  передачи, и часть таких вопросов закрыта шагом работы.
+- **Слово владельца об устройстве — постановка, а не решение.** Названное им обычно уже живёт в
+  дереве под этим самым словом: у него есть имя на экране, раздел в спеке и поле в модели. Прежде
+  чем строить, слово сверяется с ними, а разошлось прочтение с деревом — спрашивается владелец, до
+  правки: истолкованное по ближайшему коду, оно выглядит исполненной просьбой ровно до приёмки.
 - **Папка задачи заводится под любую работу, без исключений.** Исключение, у которого есть хоть
-  одна законная форма, исполняется как разрешение. Заводится она всегда и до первой правки:
-  сколько заходов уйдёт на работу, заранее не знает никто.
-- **Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве.** Гард спрашивает её
-  с диска, и папка, ни разу не закоммиченная, проходит все правки без единого отказа — а признак
-  отданной работы берётся из истории, и там её нет. Отказ приходит в последней точке, на
-  открытии заявки, когда папка уже разобрана своими руками: чинить нечего, замысел снят, и
-  собирать его приходится заново по памяти. Второе следствие тише: ход работы, живущий в
-  рабочем дереве, не виден никому — владелец видит ветку без единого следа того, что в ней
-  делается, а следующий заход находит пустоту вместо «Где стоим». Вне истории законен один
-  черновик без номера: заводить в неё нечего, пока нет имени.
-- **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Кнопку
-  слияния нажимает человек на хостинге, куда гард не достаёт, и вливает он, как только видит
-  зелёное, — закрывающему коммиту места не остаётся вовсе. Цена перестановки: замысла с этой
-  минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
+  одна законная форма, исполняется как разрешение. Заводится она до первой правки: сколько
+  заходов уйдёт на работу, заранее не знает никто.
+- **Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве.** Незакоммиченная,
+  она проходит все правки без отказа, а признак отданной работы берётся из истории: отказ придёт
+  в последней точке, когда замысел уже снят. Вне истории законен один черновик без номера.
+- **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Человек
+  вливает, как только видит зелёное, и закрывающему коммиту места не остаётся вовсе. Цена:
+  замысла с этой минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
 - **Открыв PR, исполнитель называет владельцу три вещи: номер, чего ждёт и что сделает следом.**
-  Ждёт он прогона, следом идёт снятие черновика. Зелёный прогон на странице однозначным не
-  бывает: он говорит, что не сломано, и молчит о том, что кнопка слияния у черновика
-  заблокирована.
+  Ждёт он прогона, следом идёт снятие черновика. Зелёный прогон говорит, что не сломано, и молчит
+  о заблокированной у черновика кнопке слияния.
 - **Просьба о слиянии — отдельный ход, и раньше зелёного прогона её не бывает.** Порядок один:
   папка разобрана и запушена → PR открыт черновиком → прогон зелёный → черновик снят →
   исполнитель просит влить, называя номер.
@@ -159,13 +172,18 @@ flowchart TD
   вовсе, а открытый PR читается как приглашение влить — поэтому незаконченная работа идёт
   черновиком. Черновик снимается тем ходом, которым исполнитель говорит, что решение готово.
 - **Гард замысла — нижняя граница требования, а не его предел.** Он требует папку только под
-  правку кода приложения, а статья выше — под любую работу. Прочитанный как признак, гард
-  становится разрешением работать без замысла везде, куда он не смотрит.
+  правку кода приложения, а статья выше — под любую работу. Прочитанный как признак, он
+  становится разрешением работать без замысла везде, куда не смотрит.
+- **Указание работать по правилу — это указание делать его шаги, включая те, что меняют
+  историю.** Отметка сделанного этапа, коммит, пуш и открытие заявки правилом предписаны, и
+  отдельного слова владельца на каждый из них не требуется: спросить надо о том, чего в правиле
+  нет. Ход, который довёл работу до готовности и встал перед коммитом, работу не отдал, а спрятал.
 - **Взятая задача ходом не кончается.** Заведение задачи, ветки, колонки и папки — подготовка, а
   не работа: они переводят её в состояние записанного замысла, где обязательное действие уже
-  другое. Граница состояния выглядит законченным куском лучше всякой вехи, а владельцу отчёт о
-  взятой задаче неотличим от остановки. Держит это страж выхода хода, называя в отказе первый
-  этап замысла.
+  другое. Держит это страж выхода хода, называя в отказе первый этап замысла.
+- **Ожидание одной части этапа остановкой этапа не бывает.** Части, которые от ожидаемого не
+  зависят, делаются тем же ходом, а владельцу называется, что сделано и что осталось на его шаг.
+  Отбитая гардом команда и отклонённый вызов читаются так же: сперва делается всё, что мимо них.
 - **Сделанное отмечается только в ходе работы.** «Где стоим» перезаписывается каждым заходом, а
   не дописывается: это первое, что читает следующий заход.
 - **Слово для нового понятия ищется в словаре дерева.** Общую часть везёт пакет, предметную
@@ -174,97 +192,85 @@ flowchart TD
 - **Папка задачи заводится черновиком и получает номер командой.** До конца разбора неизвестно,
   сколько задач из него выйдет, поэтому номер не может быть первым. Команда заведения
   переименовывает черновик, проставляет шапку замысла и собирает папку с образца, снимая с копий
-  шапку раскладки: оставленная в копии, она отбивает первую же правку разбора просьбы.
-- **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ — задачи
-  за ним ещё нет, и спросить о нём некого.
-- **Следующая задача берётся из замысла эпика, а список очереди работ спрашивается только там,
-  где эпика нет.** Список отсортирован номером, и по нему первая задача чужого эпика неотличима
-  от своей. Замысел открывается перед взятием; кончившийся эпик называется владельцу тем же
-  ходом, которым берётся работа вне его.
+  шапку раскладки.
+- **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди.
+- **Следующая задача берётся из замысла эпика, а список очереди работ спрашивается только там, где
+  эпика нет.** По списку номеров первая задача чужого эпика неотличима от своей. Кончившийся эпик
+  называется владельцу тем же ходом, которым берётся работа вне его.
 - **Эпик не закрывается по признаку, подтверждённому только чтением.** Признак, проверяемый
-  глазами, называется проверенным лишь вместе с командой или замером и их выводом. Пометка
-  «подтверждается живым замером» — обещание проверки, а не проверка.
+  глазами, называется проверенным лишь вместе с командой или замером и их выводом.
 - **Задачи эпика заводятся все разом, тем же ходом, что и сам эпик.** Заведение по одной прячет
-  объём: на борде эпик из десяти задач выглядит одной. Номера возвращаются в раздел порядка той
-  же правкой — без них «взять следующую» отвечает названием, а не карточкой. Метку эпика несёт
-  только его карточка.
-
-- **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка говорит, что эпик
-  есть, но порядка задач не держит; папка задачи держала бы его ровно до слияния первой из них.
-  Каталог называет компаньон правила: замысел, положенный каждым заходом заново, теряет решения
-  предыдущих.
+  объём. Номера возвращаются в раздел порядка той же правкой: без них «взять следующую» отвечает
+  названием, а не карточкой.
+
+- **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка порядка задач не
+  держит, а папка задачи держала бы его до слияния первой из них; каталог называет компаньон
+  правила. Имя, адрес и способ, названные владельцем по ходу, дописываются туда же тем ходом,
+  каким приняты.
 - **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ лежит
-  в разборе просьбы и в замысле эпика; они читаются, но образцом не считаются. Повторяемая часть
-  открывается целиком — обходом каталогов, а не одним файлом, за которым пришли.
-- **Путь к образцу лежит вне дерева и приходит в заход хуком запуска сессии.** Имя чужого дерева
-  в файлы репозитория не пишется: там законна ссылка без имени. Каталог для записи — тот же, где
-  лежит передача захода. Не записанный так, образец теряется на первой же чистке контекста.
+  в разборе просьбы и в замысле эпика; образцом они не считаются. Повторяемая часть открывается
+  целиком — обходом каталогов, а не одним файлом, за которым пришли.
+- **Что действует на дерево, а не на правку, лежит вне индекса.** Путь к образцу и разрешение
+  работать вне эпика ветке не принадлежат: записанные файлом репозитория, они в ней и остаются,
+  а следующая, отведённая от главной, их не несёт. Место записи — рядом с передачей захода.
 - **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
-  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл; через
-  сутки этого нет ни у кого. Разбор кончается правкой слоя правил или предложением наружу. Ведёт
-  его роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт разбор само.
+  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл. Разбор
+  кончается правкой слоя правил или предложением наружу; ведёт его роль разбора закрытой задачи,
+  если дерево её разложило.
 - **Разбор закрытой работы уходит в фон, а исполнитель берёт следующую задачу.** Роль работает
-  своим ходом и ничего не спрашивает; держать ради неё заход незачем. Сводку собирают до запуска,
-  вернувшиеся находки принимают одним ходом: записать и продолжить прежнее.
+  своим ходом и ничего не спрашивает. Сводку собирают до запуска, вернувшиеся находки принимают
+  одним ходом.
 - **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
   заготовка правки чужого дерева, и уехавшая без разбора, она становится работой того, кто её не
-  заказывал. Сводка наблюдений уезжает всегда: она говорит, чем пользовались, и мнением не
-  бывает.
+  заказывал. Сводка уезжает всегда: она говорит, чем пользовались, и мнением не бывает.
+- **Дешёвый шаг закрытия идёт раньше дорогого, а прогон — после вливания.** Вливание договорённости
+  и приведение текстов стоят минуты, прогон — окно захода. Идущий после вливания, он проверяет и его
+  самого: идущий до, он смотрит то, что в главную не поедет.
 - **Договорённость вливается в спек домена одним из последних коммитов ветки, до открытия PR.**
   К этому моменту код написан, привязки известны, и в главной ветке директория `proposed/` не
   появляется вовсе. Готовые к вливанию перечисляет `npm run check:specs`.
-- **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает то,
-  что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка очереди.
-- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Требование стоит здесь, а не
-  на слиянии: слияние нажимает человек на хостинге, где гардов нет, и его отказ до владельца не
-  доходит. Судится содержимое ветки, а не рабочее дерево.
-- **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, и
-  первым уходит разбор просьбы — единственная запись слов владельца. Что именно увезено,
-  требование не судит: это судит владелец.
-- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.** Работа, вливаемая
-  частями, папку до конца не разбирает. Чтение из команды работает и без сети. Пустая причина
-  обходом не считается, а сам обход снимает отказ, но не гасит строку сверки очереди — иначе он
-  через месяц становится рабочим путём.
+- **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает то, что
+  объясняет решение; остальное удаляется. Неразобранную ловит сверка очереди.
+- **Открытие PR и снятие черновика отбиваются, пока ветка везёт папку своей задачи.** Слияние
+  нажимает человек на хостинге, где гардов нет: снятый черновик он читает как приглашение влить и
+  кнопку нажимает, не дожидаясь коммита уборки. Судится содержимое ветки, а не рабочее дерево.
+- **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, а
+  первым уходит разбор просьбы — единственная запись слов владельца.
+- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.** Пустая причина обходом
+  не считается, а сам обход снимает отказ, но не гасит строку сверки очереди.
 
 ## Чего из закона здесь нет
 
-Полноту записанного понимания не проверяет ничто, и проверки на неё не будет: машине видно
-наличие записи, но не то, что в ней закрыты все пробелы. Разбор из одной строки проходит гард
-так же, как разбор на сто. То же с вопросом, который стоило задать и не задали, — он не
-оставляет следа. Оба разобраны решениями в законе: судит владелец.
-
-Гард судит по путям правки, а не по тому, меняет ли работа поведение на самом деле.
-Рефакторинг, снаружи не видный, упирается в требование договорённости и проходит обходом с
-причиной. Своего признака рефакторингу не заводится: оценку «поведение не меняется»
-назначал бы тот, кому она мешает.
-
-Ничто из самого разбора не проверяется, и всё это держится памятью того, кто его ведёт.
-Разговор с владельцем инструментом не является — гард видит правку файла и ничего не знает
-ни о том, была ли разведка до первого вопроса, ни о том, задан ли каждый из шести
-обязательных вопросов, ни о том, ответил ли на них владелец. Образец разбора перечисляет их
-таблицей, но пустая таблица проходит так же, как заполненная.
-
-Гард разговора судит завершение хода, а не отправку вопроса. К моменту отказа вопрос уже у
-владельца, и владелец видит его вместе с отбитым ходом: требование срабатывает, но исполняется
-задним числом. Прозаический вопрос инструментом не является, и раньше поймать его нечем.
-Отсюда порядок: правило работы читается первым движением захода, до первой реплики владельцу,
-а не по отказу гарда; гард отмечает пропуск, но не отменяет его.
-
-Неизменность замысла не стережёт ничто: `plan.md` правится тем же инструментом, что и
-остальные тексты, и правка по ходу отличима от первоначальной записи только по истории.
-Держится это тем же, чем и порядок разбора.
-
-Приведение текстов к сделанному не проверяет ничто, и проверки на него не будет: что устарело
-в правиле и в спеке, машине не видно — раздел «Чего из закона здесь нет» не читает ни одна
-сверка, а «Что не входит» выглядит верным ровно так же, как в день, когда его писали. Держится
-это шагом закрытия работы и следом задачи в замысле: там названо, что перечитать. Правило и
-спек правятся в ветке, закон — нет: его статья приносится владельцу текстом, а работа идёт
-дальше без неё.
-
-Что именно перенесли в архив, не проверяется. Гард видит, что папка уезжает в главную ветку и
-что ветка что-то в архив добавила, но не может судить, то ли это и стоило ли переносить именно
-это. Сверять содержимое машине нечем — смотрит владелец на ревью. Отсюда же и обход: если
-работа вливается частями, папку до конца не разбирают, а причина остаётся в PR.
+Полноту записанного понимания не проверяет ничто: машине видно наличие записи, но не то, что в
+ней закрыты все пробелы. То же с вопросом, который стоило задать и не задали, — следа он не
+оставляет. Судит оба владелец.
+
+Гард судит по путям правки, а не по тому, меняет ли работа поведение на самом деле. Своего
+признака рефакторингу не заводится: оценку «поведение не меняется» назначал бы тот, кому она
+мешает.
+
+Ничто из самого разбора не проверяется. Разговор с владельцем инструментом не является: гард
+видит правку файла и не знает ни о разведке до первого вопроса, ни о шести обязательных, ни об
+ответах на них — пустая таблица проходит так же, как заполненная.
+
+Гард разговора судит завершение хода, а не отправку вопроса: к моменту отказа вопрос уже у
+владельца. Отсюда порядок — правило читается первым движением захода, а не по отказу гарда.
+
+Неизменность замысла не стережёт ничто: правка по ходу отличима от первоначальной записи только
+по истории.
+
+Приведение текстов к сделанному не проверяет ничто: что устарело в правиле и в спеке, машине не
+видно. Держится это шагом закрытия и следом задачи в замысле — там названо, что перечитать.
+Правило и спек правятся в ветке, закон — нет: его статья приносится владельцу текстом, а работа
+идёт дальше без неё.
+
+Что именно перенесли в архив, не проверяется: гард видит, что папка уехала и что ветка что-то в
+архив добавила, а то ли это — судит владелец на ревью.
+
+Гард папки задачи судит вызов исполнителя, а не кнопку хостинга: человек, вливающий работу со
+своей стороны, проходит мимо него молча, и папка уезжает в главную ветку целой. Гард закрывает ту
+половину случаев, где вливает исполнитель; на второй требование держится оставшимся шагом,
+который стоит разделом в теле заявки и произносится вслух.
 
 Порядок отдачи работы дерево вправе перевернуть надстройкой, и тогда часть шагов пакета
 перестаёт исполняться. Какие именно — не считает ничто: перечень отменяемого пишется руками, а

package/assets/rules/testing.md

@@ -73,7 +73,10 @@ flowchart TD
   Юнит на тот же расчёт остаётся долгом: между верным решением и тем, что человек его видит, лежит
   всё, чего юнит не касался.
 - **Сквозной тест, погашенный переменной окружения, покрытием не считается.** Выключатель по
-  состоянию стенда — пропуск случая, выключатель по переменной — невыполненный тест.
+  состоянию стенда — пропуск случая, выключатель по переменной — невыполненный тест. Состоянием
+  стенда при этом считается то, чего на нём не бывает по устройству, а не то, что оставил на
+  экране соседний тест: снятие по чужому следу закон покрытием не считает, и от законного
+  пропуска оно отличается только причиной.
 - **Упоминание в тесте сценария, которого в спеках нет, роняет проверку.** Так ловится
   переименованный или выкинутый сценарий: тесты при этом остаются зелёными.
 - **Решение выносится в чистую функцию и проверяется вызовом.** Компонент и сервис остаются тонкой
@@ -87,6 +90,11 @@ flowchart TD
   того, кто её не трогал. Ни линтер, ни сборка, ни сверка спеков времени не знают.
 - **Процедура Connect проверяется вызовом своего метода с рукописным двойником базы.** Контейнер и
   роутер поднимать не надо: спека проверяет решение, а не раскладку полей.
+- **Процедуру зовёт и сквозной набор, а не только тест рядом с ней.** У сквозного набора есть
+  свой помощник прямого вызова, и спека берёт ответ сервера оттуда, а не поднимает экран ради
+  одного поля. Поэтому «тестов на процедуру нет» утверждается после поиска её имени по всему
+  дереву, каталоги сквозных наборов включая, а не после того, как рядом с её файлом не нашлось
+  файла проверки: шесть отметок покрытия подряд объявили непокрытым закрытое.
 - **Сид заводит то, без чего экран не открыть, и ничего, что гость примет за настоящее.**
   Содержимое, у которого есть автор, — отзывы, вопросы, обсуждения — гость читает как написанное
   людьми, а стенд собирается из той же базы, что и проверка глазами. Настройки владельца —
@@ -139,6 +147,16 @@ flowchart TD
   проверки и с тех пор только сокращается: дописанная строка гасит сигнал, а не причину, и в
   истории выглядит так же, как починка. Место, где проверка права по букве и не права по существу,
   разбирает владелец, а до его ответа верна проверка.
+- **Обмен принимается прочитанным с обеих сторон, а не по успеху вызовов.** Отправка и правка
+  состояния отвечают успехом и тогда, когда прочитать результат нечем: две с лишним сотни записей
+  простояли новыми, потому что забрать их было некому, а отметились только те, чей файл ещё лежал
+  на диске у отправителя. Заводя сторону обмена, называют вторую: чем читают, кто читает и что
+  будет, если её нет. Ответ «нечем» пишется словом — молчание о ней читается как рабочий обмен.
+- **Значение, общее двум сторонам обмена, берётся у объявившей стороны, а не считается заново.**
+  Признак записи, форма груза, способ счёта ключа — своя копия любого из них расходится с
+  оригиналом молча, и обе стороны при этом зелены: одна пишет под своим значением, другая ищет
+  под своим. Проверяется это сценарием, который считает значение обоими путями и сверяет их между
+  собой, а не по одному на каждой стороне.
 - **Тест, утверждающий отсутствие, зелен и тогда, когда ищет не то.** Совпадения нет ни у верного
   текста, ни у опечатки в образце, ни у переименованного ключа — отличить их по цвету прогона
   нечем. Отрицательное утверждение поэтому идёт в паре с положительным: сначала проверяется, что
@@ -147,6 +165,17 @@ flowchart TD
   в заголовке стоит — сценарий числится покрытым, а что именно утверждается, не спрашивает никто.
   Тело читается вместе с заголовком: обещание в заголовке и утверждение в теле — два разных
   текста, и расходятся они молча.
+- **Успешный ответ команды перечитывается отдельным запросом.** Код возврата говорит, что вызов
+  прошёл, и молчит о том, наступило ли нужное состояние: заведение задачи, отметка записи и
+  постановка ревьювера отвечают нулём и тогда, когда сделали не то. В отчёт идёт прочитанное, а
+  не заказанное.
+- **Служба считается поднятой по выполненному заданию, а не по открытому порту.** Ответ на порту
+  говорит, что кто-то там слушает, и неотличим от прошлой сборки, оставшейся с прежнего захода:
+  проверяются обе стороны связи — что заказчик выбирает именно её и что задание через неё прошло.
+- **Эталоны снимочного набора лежат рядом со спекой, а обновляются отдельным вызовом и читаются
+  глазами.** Обновление «на всякий случай» вместе с прогоном стирает разницу между починенным
+  видом и сломанным: обновлённый эталон делает зелёным любой кадр. Где эталоны и чем они
+  обновляются, называет компаньон правила.
 - **Растр браузера называется явно, иначе кадр не сходится сам с собой.** Профиль цвета, взятый у
   дисплея машины, ускоритель, считающий растр, и дорисовка кусками — каждый из трёх двигает цвет
   на единицу-другую по каналу, и видно это только там, где смешение стоит на границе округления:
@@ -163,9 +192,19 @@ flowchart TD
 Полнота теста не проверяется: сверка судит путь — сквозной он или юнит, — но не то, сколько
 из обещанного тест на этом пути закрыл. Признак пути читается из слов «Тогда» и нарочно
 молчалив: сценарий, чьё обещание человека не называет, под него не подпадает вовсе, и
-отметку неполноты там по-прежнему ставит рука. Договорённостей о подмене модулей тоже нет:
+отметку неполноты там по-прежнему ставит рука.
+
+Отметка покрытия стареет молча. Сверка знает идентификатор сценария против заголовка теста, а
+текст отметки под ним для неё проза: он читается как действующее описание и через полгода после
+того, как долг закрыли. Перечитывается отметка вместе с той правкой, которая трогает её
+предмет, — иначе не перечитывает её никто. Договорённостей о подмене модулей тоже нет:
 `vi.mock` в дереве не встречается ни разу, и двойник пишется руками.
 
+Наблюдения за тем, как пользуются правилами, это правило не ведёт вовсе: род события, место
+записи и то, что уходит наружу, — предмет закона о наблюдаемости и правила под ним. Здесь оно
+названо затем, чтобы наблюдение не путали с покрытием: покрытие говорит, что проверено, а
+наблюдение — чем пользовались.
+
 ## Паттерны
 
 - `testing-unit` — тест на чистую функцию, на процедуру Connect и разовый тест-доказательство,