@rt-tools/agent-kit 0.23.0 → 0.24.0

package/assets/rules/browser-verification.md

@@ -74,11 +74,15 @@ flowchart TD
   профиль обошли этой дверью дважды за один заход.
 - **Выбор браузера протухает и требует повторного вызова.** Выбор, сделанный в начале
   сессии, не держится: после паузы следующий вызов открывает вкладку в другом профиле молча.
+- **Отказ выбора профиля кончает работу с браузером, а не начинает поиск обхода.** Профиля среди
+  подключённых нет — значит, вести некого: состав вкладок, переход и снимок уйдут в тот браузер,
+  который расширение считает активным, и какой это, не знает никто. Состояние называется владельцу
+  словом, и работа через браузер стоит до его ответа.
 - **Профиль не выбирается из списка и не спрашивается у владельца.** Список отдаёт неустойчивые
   имена, которые не опознают ничего, а выбор из него ведёт на профиль без входа.
 - **Ненастроенная стража — повод остановиться, а не разрешение ехать.** Пропуск гарда при
   молчащем помощнике сделан затем, чтобы сломанная обвязка не заводила работу в тупик, и
-  разрешением работать мимо профиля не является. Исполнитель, получивший от помощника пустой
+  разрешением работать мимо профиля не считается. Исполнитель, получивший от помощника пустой
   вывод, называет это владельцу и браузер не водит: вкладка откроется в том профиле, который
   расширение сочло активным, а какой это профиль — не знает никто.
 - **Экран, закрытый входом, проверяется стендом с подменённым ответом входа, а не живой учётной
@@ -96,12 +100,27 @@ flowchart TD
   обрезка без признака видны только там, где содержимое в своё место не влезает; на коротком
   значении всё три выглядят исправными. Значение для замера берётся предельное — то, какое узел
   может получить у настоящего потребителя, а не то, какое стоит в примере.
-- **Готовое из набора, взятое под данные другого размера, меряется, а не разглядывается.**
+- **Готовое из набора, взятое под значения другого размера, меряется, а не разглядывается.**
   Компонент, живший там, где значения короткие, в новом месте получает значение вчетверо
   длиннее — и ведёт себя иначе, оставаясь тем же кодом. Спека этого не видит вовсе: обрезка
   браузером в разметке не отражается, и текст приходит из неё целым.
+- **Прокси стенда подставляет то, по чему приложение узнаёт арендатора запроса.** Дерево, которое
+  держит несколько организаций за одним приложением, узнаёт их по заголовку, а сервер отрисовки
+  кладёт туда свой хост: приложение отвечает отказом на каждый вызов. Снаружи это страница «не
+  найдено» — выглядит как дефект кода, а не стенда. Замер тремя заголовками на одном стенде: свой
+  хост с портом — отказ, свой хост без порта — отказ, имя арендатора — страница. Отличает одно от
+  другого подстановка заголовка, а не чтение кода.
 - **Прод-конфигурация проверяется только за настоящим прокси.** Голый сервер отдачи страниц
   про кэш, перенаправления и заголовки не знает ничего.
+- **Показанное человеку собрано из той работы, о которой идёт речь.** Стенд собирается с ветки
+  этой правки, а не с той, на которой стоит исполнитель: сборка с чужой ветки показывает дерево
+  без правки, и человек читает это как «не сделано». Сказанное о показанном называет ветку, с
+  которой оно собрано. Один такой показ стоил двух ходов: владелец повторил замечание, по
+  которому правка давно сделана, а исполнитель взялся объяснять уже исправленный дефект.
+- **Ветка работы держит вершину главной влитой всё время, а не только перед отдачей.** Отставшая
+  ветка собирается в стенд, на котором нет ни чужих правок, ни своих соседних, и показанное на
+  нём описывает дерево, которого нет ни у кого. Вершина подтягивается, когда о её движении стало
+  известно, а не когда работа кончилась.
 - **Первый заход на публичный экран метится признаком служебного посещения.** Драйвер водит
   обычный браузер, и счётчик посещений не отличает проверку от гостя: `navigator.webdriver` у
   него `false`, строка `User-Agent` — живого браузера. Чем метится заход, сказано в именах
@@ -121,7 +140,14 @@ flowchart TD
   «что тут происходит», а не подтверждает известное число. Вывод «замер снять нечем», сделанный
   на закрытом входе, чаще всего означает, что искали не тем.
 
-Вывод о вёрстке подкрепляется числом: «выглядит нормально» результатом проверки не является.
+- **Замер снимается до показа работы владельцу, а не после его замечания.** Показанное без
+  замера — заявка на проверку, а не проверка: на снимке слипшиеся вплотную карточки читаются как
+  одна с длинным содержимым, обрезанная тень — как её отсутствие, нулевой промежуток — как плотная
+  вёрстка. Каждый такой дефект виден одной командой замера. Числа, снятые с образца заранее,
+  сверяются с реализацией тем же ходом: работа по пересказу образца словами расходится с ним
+  незаметно.
+
+Вывод о вёрстке подкрепляется числом: «выглядит нормально» результатом проверки не бывает.
 Этого не стережёт ничто — как измерять, разобрано в паттерне `browser-verification-measure`.
 
 ## Чего из закона здесь нет

package/assets/rules/doc-style.md

@@ -107,6 +107,13 @@ flowchart TD
   имена веток и правила линтеров: выглядят адресом, адресом не являются.
   <!-- rt-when: *.md -->
 
+- **Файл, положенный раскладкой, пары не требует.** Автор у него в дереве-потребителе один —
+  пакет, и документ о нём лежит там же. Требование пары читает шапку раскладки: она стоит в
+  каждом разложенном файле и отличает его от написанного здесь надёжнее любого перечня путей.
+  Иначе первая же раскладка требует обход на весь свой объём, а обход, объявленный на сотню
+  файлов, снимает требование и с будущих правок этих файлов вручную.
+  <!-- rt-when: *.md -->
+
 - **Документ едет в том же коммите, что и правка, которую он описывает.** Обход — строка
   `Docs-skip: <причина>` в теле коммита; пустая причина не принимается.
   <!-- rt-when: *.md -->
@@ -169,6 +176,34 @@ flowchart TD
   схема набрана словами и от текста рядом отличима только чтением.
   <!-- rt-when: *.md -->
 
+## Тексты для человека
+
+- **У текста есть адресат, и слог выбирается по нему, а не по тому, что писалось до него.**
+  Правила, законы и спеки читает тот, кто работает внутри слоя правил; задачу, заявку и ответ в
+  чате — человек снаружи. Текст, написанный сразу после правки спеки, наследует её слог: изнутри
+  он выглядит точным, а для читателя снаружи пуст. Адресат проверяется до первой строки.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
+Задачу в очереди, описание заявки и ответ в чате читает владелец. Он помнит продукт и не читал
+ни одного правила слоя: слова слоя для него пустые. Форма ответа о состоянии работы — правило
+`status-report`; здесь язык, каким написаны все три текста.
+
+- **Текст для владельца пишется словами продукта, а не словами слоя правил.** Что человек видит,
+  что у него не работает, что с этим сделали. Заявка, прогон, набор, объём правки,
+  договорённость — это слова слоя; в тексте для владельца они заменяются на те, которыми зовёт
+  их он сам. Иначе он читает текст о своей же работе и не узнаёт в нём ни одного экрана.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
+- **Из задачи видно, что сломалось у человека, а не только где красная проверка.** Задача,
+  описанная именами файлов и номерами проверок, не даёт решить, срочная она или нет: цена
+  промаха видна по тому, чего человек не может сделать.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
+- **Страдательный залог и метафоры в этих текстах не пишутся.** «Работа отдана» и «красное
+  въехало» звучат весомо и не называют ни действия, ни того, кто его сделал. Владелец решает по
+  ним, что делать дальше, и решать ему не по чему.
+  <!-- rt-when: задача, описание заявки, ответ владельцу -->
+
 ## Чего из закона здесь нет
 
 Ни одна из формулировочных договорённостей не проверяется: одна фраза на правило, простые
@@ -191,6 +226,7 @@ flowchart TD
 
 - `doc-style-write` — как формулировать: примеры «так» и «не так», правила для комментариев.
 - `doc-style-sweep` — разбор документа, накопившего список работ, на действующее и закрытое.
+- `doc-style-human` — форма задачи, описания заявки и ответа владельцу: образцы «так» и «не так».
 - `doc-style-trace` — обратный проход: закрытые задачи против текстов, поиск того, чего не
   написали.
 

package/assets/rules/git-workflow.github.md

@@ -99,11 +99,10 @@ flowchart TD
   заголовок задачи, из него достаётся номер ветки, по нему же сверка читает заголовок PR. Форма
   ветки в профиле дерева пишется той же парой `<КЛЮЧ>-<номер>`.
 - **Незаданный ключ отбивает работу с очередью на месте.** Модуль борды отказывает при первом же
-  вызове и называет, где ключ задаётся. Умолчания нет намеренно: собранный из пустого значения
-  заголовок не совпадает ни с чем, и настоящее расхождение тонет среди ложных строк.
+  вызове и называет, где ключ задаётся. Умолчания нет намеренно: заголовок из пустого значения
+  не совпадает ни с чем, и настоящее расхождение тонет среди ложных строк.
 - **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
   Напечатанный номер значит «вызов прошёл»: задачу можно завести и не довести до борды.
-  Спрашивается очередь по номеру, и ответ читается колонкой и исполнителем.
 - **Видимость заведённого проверяется той стороной, которой оно предназначено.** Заявку читает
   человек, задачу — очередь работ, и оба читают не тем токеном, которым заводили: ограниченная
   запись отвечает им «не найдено», а заводившей — успехом.
@@ -120,16 +119,14 @@ flowchart TD
   невзятая, хотя работа сделана и выложена. На заведении ветки колонка не спрашивается — там её
   ещё не двигали. Имя первой колонки дерево называет само; не названо — колонка не судится.
 - **На борде стоят задачи, а не PR о них.** Карточка PR колонки не имеет, из очереди не уходит и
-  остаётся навсегда; заводит её правило борды или рука, и то и другое выключается. Находит такие
-  карточки сверка очереди — строкой на каждую.
+  остаётся навсегда. Находит такие карточки сверка очереди — строкой на каждую.
 - **Отставшая колонка находится сверкой очереди, а не глазами.** Она судит колонку по PR в обе
   стороны: открытый PR при задаче не в разборе и разбор без открытого PR. Момента, когда задачу
   берут в работу, ей не видно: ветки на борде нет.
 - **Ветка с открытой заявкой отстаёт от главной молча.** Основание гард судит раз, в минуту
   открытия, а влитого после не видит и прогон. Отставание считает сверка очереди работ.
 - **Связь задачи с эпиком сверка читает в обе стороны.** Односторонняя привязка выглядит целой
-  так же, как двусторонняя: читатель приходит то от замысла эпика, то от карточки. Держалась она
-  подражанием — тело с образца соседней задачи везло строку вместе с формой.
+  так же, как двусторонняя: читатель приходит то от замысла эпика, то от карточки.
 - **Задачи, чинящиеся одной правкой, сливаются до мержа.** Вторая стирается вместе с номером, а
   недостающее дописывается в первую: после мержа ветка въехала целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка на
@@ -138,6 +135,10 @@ flowchart TD
 - **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница без прогона выглядит
   так же, как с зелёным: цвета нет ни там, ни там. Сверка спрашивает вершину, считает сам факт
   прогона, а не цвет, и свежей вершине даёт время.
+- **Заявка, чья база — не главная ветка, проверяется тем же набором, что и заявка в главную.**
+  Условие запуска конвейера читает базу, и заявка в соседнюю ветку не поднимает его вовсе: пустое
+  поле проверок читается как ожидание очереди. Спрашивается это до открытия первой заявки стопки,
+  и заявка без прогона на вершине не сливается — приём в паттерне `git-workflow-stack`.
 - **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Он выглядит
   упавшим, хотя ветку не проверял; отличает их число заданий — у него ноль.
 - **Черновик при зелёном прогоне на вершине — расхождение сверки.** Зелёная страница ничего не
@@ -145,16 +146,14 @@ flowchart TD
 - **Свои черновики судятся все разом, а не тот один, чья ветка взята.** Признака два — зелёный
   прогон на вершине и разобранная папка задачи в ветке; лежащая папка означает идущую работу.
 - **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Кнопку слияния нажимает
-  человек там, где гардов нет, и открытие — последняя точка, где отказ ещё виден тому, кто может
-  его выполнить.
+  человек там, где гардов нет: открытие — последняя точка, где отказ ещё виден исполнителю.
 - **Свои открытые заявки перечитываются в трёх местах: перед пушем, при взятии задачи и после
   каждого известного слияния.** Заявка устаревает без действия автора: влита соседняя работа —
   остальные в ту же секунду отстали. Приём — `git-workflow-freshness`.
 - **Конфликтующая своя заявка чинится первым действием хода, а новая работа до этого не
-  берётся.** Пока отданное конфликтует, влить его человек не может, и каждая следующая заявка
-  прибавляет к очереди ещё одну, которую придётся догонять. Работой здесь считается заведение
-  задачи, заведение ветки, перевод колонки в работу и открытие заявки; всё, чем конфликт чинится,
-  идёт как прежде.
+  берётся.** Пока отданное конфликтует, влить его человек не может. Работой здесь считается
+  заведение задачи, заведение ветки, перевод колонки в работу и открытие заявки; всё, чем
+  конфликт чинится, идёт как прежде.
 - **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает чужим
   слиянием и по списку не виден: метку хостинг показывает только внутри самого PR.
 - **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в теле
@@ -166,11 +165,10 @@ flowchart TD
 - **Сборка входит в набор наравне с линтом и юнитами.** Линтер типов не читает, а юниты читают
   только импортированное тестом: ошибка типов в непокрытом коде доживает до сборки образа, то
   есть до мержа.
-- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Умолчание
-  готового шага опасно именно тем, что оно общее: соседнее задание переписывает его под свою
-  версию, пока наше стоит между шагами. Каталог установки, имя контейнера и имя сборщика
-  называются поэтому по проекту и постоянно, а временный каталог решением не бывает — в нём
-  живёт хранилище пакетов.
+- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Соседнее задание
+  переписывает умолчание готового шага под свою версию, пока наше стоит между шагами. Каталог
+  установки, имя контейнера и имя сборщика называются поэтому по проекту и постоянно, а временный
+  каталог решением не бывает — в нём живёт хранилище пакетов.
 - **Набор гейта пуша не бывает уже набора конвейера.** Шаг конвейера, которому в наборе нет ни
   строки, ни объявленного исключения с причиной, отбивает пуш, а не печатается рядом:
   предупреждение читается как разрешение.
@@ -187,11 +185,10 @@ flowchart TD
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Проверять по тому, что правил автор, — значит проверять половину: отвечает ветка
   целиком.
-- **Главная ветка берётся удалённой ссылкой — и в словах, и в действиях.** Локальная протухает в
-  минуту, когда её подтянули, и молчит об этом: это снимок вчерашнего дня. От `origin/main` идут
-  и сравнение, и основание новой ветки, и счёт влитого, и подтягивание — смешанные в одной
-  команде, ссылки дают промах, изнутри выглядящий верным. Влитая ветка при локальной числится
-  невлитой, и уборка кончается списком невлитого, которого нет.
+- **Главная ветка берётся удалённой ссылкой — и в словах, и в действиях.** Локальная — снимок
+  вчерашнего дня, и молчит она об этом. От `origin/main` идут и сравнение, и основание новой
+  ветки, и счёт влитого: при локальной влитая ветка числится невлитой, а уборка кончается
+  списком невлитого, которого нет.
 - **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка во входящие не
   приходит и обсуждения не имеет: до открытия PR правки для человека нет. Открывается он тем же
   ходом, которым исполнитель говорит, что работу отдаёт.

package/assets/rules/reuse-first.md

@@ -53,6 +53,12 @@ flowchart TD
   опирается, названо в именах дерева.
 - **Работа начинается с чтения готового, а не с чистого файла.** Сначала находится опора —
   компонент кита, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
+- **Ограничение, придуманное на месте, проверяется поиском по дереву прежде, чем стать доводом.**
+  «Так делать нельзя» — утверждение о дереве наравне с прочими, и дерево, где приём уже применён,
+  отвечает на него одной командой. Названное владельцу до поиска, оно закрывает путь, которым
+  дерево пользуется каждый день, и вызывает перебор ненужных вариантов: решение «править класс
+  чужого набора из приложения нельзя» не проверялось, пока образец такой правки лежал в том же
+  файле — с доводом в соседней строке.
 - **Значение интеграции берётся тем же путём, что и соседнее значение той же интеграции.**
   Половина интеграции, сделанная как положено, — готовый образец, и стоит он не в чужом домене,
   а строкой выше: рядом с зашитым в код идентификатором карты жил её же ключ, приходящий
@@ -113,7 +119,7 @@ flowchart TD
 
 ## Признаки, по которым видно, что готовое обошли
 
-Списком их здесь нет: признак — это данные, а не текст правила и не код проверки. Наборы лежат
+Списком их здесь нет: признак — это запись в файле, а не текст правила и не код проверки. Наборы лежат
 при пакете, по файлу на пакет rt-tools, и в каждом только то, что везёт он сам. Дерево называет
 нужные ему наборы ключом `reuse.bundles` в настройке проверок и дописывает свои признаки файлом,
 названным ключом `reuse.signals`; совпавший ключ замещает пакетный, новый дописывается. Там же
@@ -147,7 +153,7 @@ flowchart TD
 - Перенос переизобретением не считается: строку, которая уже лежит в файле, гард из
   проверяемого текста вычёркивает, а сверка идёт без отступов — при переезде блок меняет
   отступ, оставаясь тем же кодом.
-- Ответ, данный до чтения образца, образец отменяет: согласованная форма выборки списка
+- Ответ, сказанный до чтения образца, образец отменяет: согласованная форма выборки списка
   переигрывалась вместе с контрактом через два вопроса после того, как была принята.
 - **Набор объявляется по тому, что дерево потребляет, а не по тому, что пакет везёт.** Дерево, в
   котором кит написан, а не позван, объявив его набор, получает советы звать кит на файлах самого

package/assets/rules/styling-bem.md

@@ -68,6 +68,13 @@ flowchart TD
   вне кита файл стилей по умолчанию пустой.
   <!-- rt-when: *.scss *.css -->
 
+- **Одна вещь называется одним именем во всех местах, где она встречается.** Раскладка, у которой
+  для страницы, панели правки и окна заведены три словаря с общими именами в разных значениях,
+  общим слоем не считается: место объявления совпадает, а значение имени — нет. Выбирая имя,
+  исполнитель попадает в чужой словарь и приносит чужой отступ, а проверки этого не видят. Место,
+  где элемент стоит, задаётся видом блока, а не вторым набором имён.
+  <!-- rt-when: *.scss *.css *.html -->
+
 - **Шторку и окно открывает служба кита, а не номер слоя.** Числа шкалы сравниваются только
   между соседями по разметке; служба выносит разметку наружу, к `<body>`, и сравнивать её
   становится не с чем.
@@ -81,7 +88,7 @@ flowchart TD
 - **Предел ширины объявляется вместе с судьбой не влезшего.** Предел и место в строке сами по
   себе ничего не прячут и не переносят: у узла, который может получить значение длиннее своего
   места, стоит либо обрезка с многоточием, либо перенос. Без этого текст молча вылезает за
-  границы и ложится поверх соседа, а разрешение элементу сжаться обрезкой не является.
+  границы и ложится поверх соседа, а разрешение элементу сжаться обрезки не заменяет.
   <!-- rt-when: *.scss *.css -->
 
 - **Обрезка идёт в паре с подсказкой.** Обрезок без подсказки читается как целое значение:

package/assets/rules/task-flow.md

@@ -41,8 +41,7 @@ description: Правило под «Закон о ведении работы»
 ## Состояния работы
 
 Единица работы — состояние, а не шаг. У состояния есть вход, обязательное действие и выход, и
-пока действие не сделано, работа стоит в том же состоянии. Список шагов этого не давал: шаг
-кончался, а что делать дальше, выводилось из соседних строк.
+пока действие не сделано, работа стоит в том же состоянии.
 
 Состояние объявляется в разделе «Где стоим» хода работы машиночитаемой строкой
 ``- **Состояние:** `этап-идёт` `` и перезаписывается вместе с ним.
@@ -62,20 +61,23 @@ description: Правило под «Закон о ведении работы»
 | `влито`                   | PR слит человеком                               | разбор работы правилами и сверка очереди               | `task-flow-archive` |
 
 Ни у одного состояния обязательное действие не звучит как «ждать»: ожидание чужого шага
-состоянием работы не является, поэтому в `работа-отдана` обязательное действие смотрит на
-следующую задачу, а не на открытый PR. Блокированная задача следующей при этом не считается: она
-начнётся после чужого шага, то есть это то же ожидание, названное именем работы. Следующая
-берётся из очереди работ, а очередь спрашивается командой: «задач нет» — утверждение о дереве, и
-подтверждается оно выводом, а не памятью о том, что заводил сам исполнитель. Заполнение окна
+состоянием работы не считается, поэтому в `работа-отдана` обязательное действие — следующая
+задача, а не открытый PR. Блокированная задача следующей не считается: это то же ожидание под
+именем работы. Следующая берётся из очереди работ, а очередь спрашивается командой: «задач нет» —
+утверждение о дереве, и подтверждается оно выводом, а не памятью исполнителя. Заполнение окна
 захода состоянием тоже не бывает: заход кончается передачей, а работа остаётся там, где стояла.
+**Открытая карточка о взятости работы не говорит.** Карточку закрывает слияние, и в заходе без
+открытия заявок список открытых не убывает. Невзятой задачу делает отсутствие следа в дереве:
+открытые номера сверяются с описанием прошлого — на закрытую работу там лежит запись с её номером.
+Сверка стоит одной команды и отвечает про обе стороны, список открытых — ни про одну.
+
 Чем ход кончается — правило `turn-conduct` под тем же законом.
 
 Перечень показывается владельцу в начале работы, и на нём же отмечается, где стоим.
 
 Последние два состояния объявить на диске уже нечем: ход работы уезжает вместе с папкой, а папка
-разбирается раньше, чем открывается PR. Признак у них поэтому в истории ветки — коммит разбора
-папки, — и читает его гард, а не строка в файле. Цена: с этой минуты и до слияния состояние
-работы виду не подлежит, и хвост из четырёх шагов держится паттерном, а не объявлением.
+разбирается раньше, чем открывается PR. Признак у них в истории ветки — коммит разбора папки, — и
+читает его гард, а не строка в файле.
 
 ## Ход
 
@@ -112,19 +114,18 @@ flowchart TD
 
 ## Как закон применяется здесь
 - **Правка кода приложения отбивается, пока работа не дошла до состояния, в котором код
-  правится.** Гард хода работы требует три вещи: папку задачи по имени ветки, замысел в ней и
-  объявленное в ходе работы состояние. Договорённость о продукте требует свой гард на те же
-  события.
+  правится.** Гард требует три вещи: папку задачи по имени ветки, замысел в ней и объявленное
+  состояние. У договорённости о продукте свой гард на те же события.
 - **Гард судит объявленный переход, а не наличие файлов.** Пустой замысел лежит так же, как
   написанный, поэтому отказ снимает объявленное состояние — `этап-идёт`, `этапы-кончились`,
-  `разбор-кончился`. Четвёртый путь не состояние, а история ветки: папка, разобранная её
-  коммитом, означает отданную работу, и правка по замечаниям идёт без замысла на диске.
+  `разбор-кончился`. Четвёртый путь — история ветки: папка, разобранная её коммитом, означает
+  отданную работу.
 - **Строка состояния, переведённая вперёд, — то же объявление намерения, только машиночитаемое.**
   Состояние объявляется тем ходом, в котором его обязательное действие начато делом.
 - **Отказ по состоянию называет обязательное действие объявленного состояния.** Услышав только
   «не в том состоянии», исполнитель перепишет строку состояния вместо шага.
 - **Именем состояния считается только слово из перечня.** Своё слово не говорит ни о входе, ни о
-  выходе, ни об обязательном действии.
+  выходе, ни о действии.
 - **Два требования — два гарда, и снять одно можно, не теряя второго.** Судят порознь: строка о
   неизменном поведении снимает договорённость, а не требование дойти до правки кода.
 - **Влитая договорённость ветку не запирает.** После вливания директории «предложено» на диске
@@ -134,59 +135,55 @@ flowchart TD
   признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не принимается.
 - **Что требует слова владельца, берётся списком, а не оценкой на месте.** Оценку «это безопасно»
-  назначает тот, кому она удобна. Недовольство владельца простоем разрешением не бывает.
+  назначает тот, кому она удобна.
 - **На команду владельца ответ начинается с результата, а не с намерения и не с его обоснования.**
-  Владелец, поставивший задачу, мнения о ней не запрашивал, и обоснование при уже принятом чужом
-  решении читается его оценкой: авторство переписывается на исполнителя. Исключение одно —
-  исполнение упёрлось в препятствие: тогда называется препятствие, а не отношение к задаче.
+  Обоснование при принятом чужом решении читается как его оценка. Исключение одно: исполнение
+  остановлено препятствием — тогда называется препятствие.
 - **Заход работу не начинает сам.** Начало требует слова владельца в этом же заходе: передача,
-  состояние из хука запуска и назначенный эпик говорят, что делать, если работать, и молчат о
-  том, работать ли. Судится это формой реплики, а не смыслом: правка кода после пустой реплики,
-  одного слова или одного пути ход не заканчивает.
+  состояние из хука запуска и назначенный эпик говорят, что делать, а не работать ли.
+  Судится форма реплики: пустая реплика, одно слово или один путь работу не заказывают.
 - **Указание работать по ходу работы покрывает все его шаги, включая меняющие историю.**
   Спрашивают о том, чего в ходе работы нет.
 - **Вопрос, записанный прошлым заходом, вопросом владельца не становится.** Он адресован автору
   передачи, и часть таких вопросов закрыта шагом работы.
 - **Указание владельца действует до его отмены, и новый факт против него — строка в ответе о
-  цене, а не новый вопрос.** Переспрашивают то, чего указание не покрывает; обстоятельство,
-  меняющее цену указания, но не смысл, называется вслух, и работа идёт дальше. Меню, где два
-  варианта из трёх предлагают отменить решение владельца, и есть такая отмена. Правило о развилке
-  говорит, КАК задавать вопрос, и молчит о том, задавать ли его вовсе.
+  цене, а не новый вопрос.** Переспрашивают то, чего указание не покрывает. Меню, где два
+  варианта из трёх предлагают отменить решение владельца, и есть такая отмена.
 - **Ответ, данный репликой владельца, записан наравне с ответом в документе.** Вопрос, на который
   в разговоре уже отвечали, второй раз не задают.
-- **Слово владельца об устройстве — постановка, а не решение.** Названное им обычно уже живёт в
-  дереве под этим самым словом — именем на экране, разделом спека, полем модели, — и сверяется с
-  ними до правки. Разошлось прочтение — спрашивается владелец: истолкованное по ближайшему коду
-  выглядит исполненной просьбой ровно до приёмки.
+- **Слово владельца об устройстве — постановка, а не решение.** Названное им обычно уже есть в
+  дереве под этим словом — имя на экране, раздел спека, поле модели — и сверяется с ними до
+  правки. Разошлось — спрашивается владелец.
 - **Папка задачи заводится под любую работу, без исключений.** Исключение, у которого есть хоть
   одна законная форма, исполняется как разрешение. Заводится она до первой правки.
 - **Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве.** Незакоммиченная,
-  она проходит все правки без отказа, а отказ приходит в последней точке, когда замысел уже снят:
-  признак отданной работы берётся из истории. Вне истории законен один черновик без номера.
+  она проходит правки без отказа, и отказ приходит в конце, когда замысел уже снят. Вне истории
+  законен один черновик без номера.
 - **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Человек
-  вливает, как только видит зелёное, и закрывающему коммиту места не остаётся вовсе. Цена:
-  замысла с этой минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
+  вливает, как только видит зелёное, и закрывающему коммиту места не остаётся.
 - **Открыв PR, исполнитель называет владельцу номер, чего ждёт и что сделает следом.** Ждёт он
   прогона, следом снимает черновик: зелёный прогон говорит, что не сломано, и молчит о
-  заблокированной у черновика кнопке слияния.
+  заблокированной кнопке слияния.
 - **Просьба о слиянии — отдельный ход, и раньше зелёного прогона её не бывает.** Порядок один:
   папка разобрана и запушена → PR открыт черновиком → прогон зелёный → черновик снят →
   исполнитель просит влить, называя номер.
-- **PR открывается черновиком, а не в конце работы.** До открытия владелец правки не видит
-  вовсе, а открытый PR читается как приглашение влить — поэтому незаконченная работа идёт
-  черновиком. Черновик снимается тем ходом, которым исполнитель говорит, что решение готово.
+- **PR открывается черновиком, а не в конце работы.** До открытия владелец правки не видит, а
+  открытый PR читается как приглашение влить. Черновик снимается тем ходом, которым исполнитель
+  говорит, что решение готово.
 - **Гард замысла — нижняя граница требования, а не его предел.** Он требует папку только под
-  правку кода приложения, а статья выше — под любую работу. Прочитанный как признак, он
-  становится разрешением работать без замысла везде, куда не смотрит.
+  правку кода приложения, а статья выше — под любую работу.
 - **Указание работать по правилу — это указание делать его шаги, включая меняющие историю.**
-  Отметка этапа, коммит, пуш и открытие заявки правилом предписаны: спросить надо о том, чего в
-  нём нет. Ход, доведший работу до готовности и вставший перед коммитом, её не отдал, а спрятал.
+  Отметка этапа, коммит, пуш и открытие заявки правилом предписаны.
 - **Взятая задача ходом не кончается.** Заведение задачи, ветки, колонки и папки — подготовка:
-  она переводит работу в состояние записанного замысла, где действие уже другое. Держит это страж
-  выхода хода, называя в отказе первый этап.
+  работа переходит в состояние записанного замысла, где действие другое. Гард завершения хода
+  называет в отказе первый этап.
 - **Ожидание одной части этапа остановкой этапа не бывает.** Независимые от ожидаемого части
   делаются тем же ходом, а владельцу называется, что сделано и что осталось на его шаг. Отбитая
-  команда читается так же: сперва делается всё, что мимо неё.
+  команда читается так же: сперва делается всё остальное.
+- **Находка, сделанная посреди этапа, сверяется с условиями выхода замысла до первой правки.**
+  Соседство по предмету принадлежности не доказывает: работа над слоем правил и работа над
+  командами, которые этот слой вызывает, откатываются порознь. Не названная ни одним условием
+  выхода, находка идёт в раздел о том, чего работа не делает, и заводится задачей.
 - **Сделанное отмечается только в ходе работы.** «Где стоим» перезаписывается каждым заходом, а
   не дописывается: это первое, что читает следующий заход.
 - **Слово для нового понятия ищется в словаре дерева.** Общую часть везёт пакет, предметную
@@ -196,21 +193,27 @@ flowchart TD
   сколько задач из него выйдет, поэтому номер не бывает первым. Команда переименовывает черновик,
   проставляет шапку замысла и снимает с копий шапку раскладки.
 - **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди.
+- **Работа, заказанная словами, становится задачей в очереди тем же ходом.** Даже если делать её
+  будут не сейчас. Черновик папки очередью не считается: номера нет, знает о нём один заход.
+  Отложенная работа называет срок; отложенная молча читается как сделанная.
 - **Следующая задача берётся из замысла эпика, а список очереди работ спрашивается только там, где
   эпика нет.** По списку номеров первая задача чужого эпика неотличима от своей. Кончившийся эпик
   называется владельцу тем же ходом, которым берётся работа вне его.
 - **Эпик не закрывается по признаку, подтверждённому только чтением.** Проверяемое глазами
   называется проверенным лишь вместе с командой и её выводом.
 - **Задачи эпика заводятся все разом, тем же ходом, что и сам эпик.** Заведение по одной прячет
-  объём. Номера возвращаются в раздел порядка той же правкой: без них «взять следующую» отвечает
-  названием, а не карточкой.
+  объём. Номера возвращаются в раздел порядка той же правкой.
 
+- **Замысел эпика называет, как стоят ветки его задач, наравне с их порядком.** Расстановок две:
+  каждая ветка от главной либо стопкой — каждая от предыдущей. Порядок задач об этом не говорит.
+  Стопка стоит дороже, её цена перечислена в холодной части; записанная в замысле расстановка
+  становится решением эпика, а не того, кто заводит ветку.
 - **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка порядка задач не
   держит, а папка задачи держала бы его до слияния первой; каталог называет компаньон правила.
   Названное владельцем по ходу дописывается туда же тем ходом, каким принято.
-- **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ лежит
-  в разборе просьбы и в замысле эпика; образцом они не считаются. Повторяемая часть открывается
-  целиком — обходом каталогов, а не одним файлом, за которым пришли.
+- **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ в
+  разборе просьбы и в замысле эпика образцом не считается. Повторяемая часть открывается целиком,
+  обходом каталогов.
 - **Что действует на дерево, а не на правку, лежит вне индекса.** Путь к образцу и разрешение
   работать вне эпика ветке не принадлежат и живут рядом с передачей захода.
 - **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
@@ -219,18 +222,18 @@ flowchart TD
 - **Разбор закрытой работы уходит в фон, а исполнитель берёт следующую задачу.** Роль работает
   своим ходом; сводку собирают до запуска, находки принимают одним ходом.
 - **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
-  заготовка правки чужого дерева, и уехавшая без разбора, она становится работой того, кто её не
-  заказывал. Сводка уезжает всегда: она говорит, чем пользовались, и мнением не бывает.
+  заготовка правки чужого дерева; отправленное без разбора, оно становится работой того, кто его
+  не заказывал. Сводка отправляется всегда: она говорит, чем пользовались, и мнением не бывает.
 - **Дешёвый шаг закрытия идёт раньше дорогого, а прогон — после вливания.** Вливание
-  договорённости и приведение текстов стоят минуты, прогон — окно захода; идущий до вливания, он
-  смотрит то, что в главную не поедет.
+  договорённости и приведение текстов стоят минуты, прогон — окно захода; прогон до вливания
+  проверяет то, что в главную не попадёт.
 - **Договорённость вливается в спек домена одним из последних коммитов ветки, до открытия PR.**
   К этому моменту код написан, привязки известны, и в главной ветке директория `proposed/` не
-  появляется вовсе. Готовые к вливанию перечисляет `npm run check:specs`.
+  появляется. Готовые к вливанию перечисляет `npm run check:specs`.
 - **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает то, что
   объясняет решение; остальное удаляется. Неразобранную ловит сверка очереди.
 - **Открытие PR и снятие черновика отбиваются, пока ветка везёт папку своей задачи.** Слияние
-  нажимает человек на хостинге, где гардов нет: снятый черновик он читает приглашением влить.
+  нажимает человек на хостинге, где гардов нет: снятый черновик он читает как приглашение.
   Судится содержимое ветки, а не рабочее дерево.
 - **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, а
   первым уходит разбор просьбы — единственная запись слов владельца.
@@ -247,35 +250,32 @@ flowchart TD
 признака рефакторингу не заводится: оценку «поведение не меняется» назначал бы тот, кому она
 мешает.
 
-Ничто из самого разбора не проверяется. Разговор с владельцем инструментом не является: гард
+Ничто из самого разбора не проверяется. Разговор с владельцем — не вызов инструмента: гард
 видит правку файла и не знает ни о разведке до первого вопроса, ни о шести обязательных, ни об
-ответах на них — пустая таблица проходит так же, как заполненная.
+ответах на них. Пустая таблица проходит так же, как заполненная.
 
 Понимания текста у гарда разговора нет: второй его признак судит общие слова темы вопроса и
-последней реплики владельца, а не смысл — вопрос о другом предмете, названный прежними словами,
-он отобьёт. Отказ называет законный ход: назвать то, чего в прежнем ответе владельца нет.
+последней реплики владельца, а не смысл. Отказ называет законный ход: назвать то, чего в прежнем
+ответе владельца нет.
 
 Неизменность замысла не стережёт ничто: правка по ходу отличима от первоначальной записи только
 по истории.
 
 Приведение текстов к сделанному не проверяет ничто: что устарело в правиле и в спеке, машине не
-видно. Держится это шагом закрытия и следом задачи в замысле — там названо, что перечитать.
-Правило и спек правятся в ветке, закон — нет: его статья приносится владельцу текстом, а работа
-идёт дальше без неё.
+видно. Держится это шагом закрытия и следом задачи в замысле. Правило и спек правятся в ветке,
+закон — нет: его статья приносится владельцу текстом, а работа идёт дальше без неё.
 
 Что именно перенесли в архив, не проверяется: гард видит, что папка уехала и что ветка что-то в
 архив добавила, а то ли это — судит владелец на ревью.
 
 Гард папки задачи судит вызов исполнителя, а не кнопку хостинга: человек, вливающий работу со
-своей стороны, проходит мимо него молча, и папка уезжает в главную ветку целой. Гард закрывает ту
-половину случаев, где вливает исполнитель; на второй требование держится оставшимся шагом,
-который стоит разделом в теле заявки и произносится вслух.
-
-Порядок отдачи работы дерево вправе перевернуть надстройкой, и тогда часть шагов пакета
-перестаёт исполняться. Какие именно — не считает ничто: перечень отменяемого пишется руками, а
-шаг, чья механика сломалась тем же решением, в него не попадает и продолжает читаться
-действующим. Держится это чтением обоих текстов подряд — пакетного и надстройки — при каждой
-правке порядка отдачи.
+своей стороны, проходит мимо него молча. На этой половине случаев требование держится оставшимся
+шагом, который стоит разделом в теле заявки и произносится вслух.
+
+Порядок отдачи работы дерево вправе перевернуть надстройкой, и тогда часть шагов пакета перестаёт
+исполняться. Какие именно — не считает ничто: шаг, чья механика сломалась тем же решением, в
+перечень отменяемого не попадает и продолжает читаться действующим. Держится это чтением обоих
+текстов подряд при каждой правке порядка отдачи.
 
 ## Паттерны