@rt-tools/agent-kit 0.14.0 → 0.15.0

package/assets/laws/delivery.md

@@ -5,123 +5,111 @@
 приложение перестаёт отвечать, а причина этого выясняется по истории.
 
 ## Статьи
-
 - **Правка начинается с задачи, видимой в очереди работ.** Заведённой задачи мало: ту, что в
   очередь не попала, никто не видит, и работа за ней не планировалась.
-- **Правка попадает в главную ветку только через отдельную ветку.** Прямая запись в главную
-  лишает правку и обсуждения, и возможности откатить её одним движением.
+- **Правка попадает в главную ветку только через отдельную ветку.** Прямая запись в главную лишает
+  правку и обсуждения, и возможности откатить её одним движением.
 - **В очереди работ стоят задачи, а не PR о них.** У задачи и её PR один номер и одна судьба,
-  поэтому вторая карточка о той же работе ничего не добавляет — она удваивает очередь и врёт о
-  её длине. Читают очередь затем, чтобы увидеть, что сделано и что осталось; PR отвечает на
-  другой вопрос — как именно сделано, — и попадают в него из карточки задачи, где связь с ним
-  и так стоит. Карточка PR при этом живёт своей жизнью: закрывается позже задачи, висит в
-  очереди после слияния и остаётся в ней навсегда, потому что колонки под неё нет.
+  поэтому вторая карточка о той же работе ничего не добавляет — она удваивает очередь и врёт о её
+  длине. Очередь читают затем, чтобы видеть сделанное и оставшееся; PR отвечает на другой вопрос и
+  открывается из карточки задачи, где связь с ним и так стоит. Карточка PR живёт своей жизнью:
+  висит в очереди после слияния навсегда, потому что колонки под неё нет.
 - **Проверка не гоняет того, что правка не может сломать.** Набор, одинаковый для любой правки,
-  выглядит строгим, а работает наоборот: прогон, который длится вдесятеро дольше нужного, учат
-  не ждать, а обходить. Состав набора выводится из состава правки — из того, что она задела, а
-  не из того, кем она названа; правка, не тронувшая ни строки кода, не собирает образов и не
-  снимает кадров. Пропущенное при этом называется пропущенным: молча выпавший шаг читается как
-  пройденный.
-- **У задачи одна ветка, у ветки одна задача.** Откат снимает всё, что въехало этой веткой,
-  разом: две задачи в ней откатятся только вместе, а задача, въехавшая двумя ветками, после
-  отката одной останется наполовину сделанной — и в очереди работ этого не видно. Работа,
-  которая в одну ветку не влезает, делится на задачи до того, как ветка заводится. Признак
-  деления — раздельный откат, а не объём: числа файлов, строк или коммитов, за которым работа
-  становится двумя задачами, нет. Правка одного рода остаётся одной задачей, сколько бы файлов
-  она ни задела. Объём захода исполнителя признаком деления не является тоже: он говорит, какого
-  размера задачу стоит заводить среди тех, что делятся законно, и не даёт делить то, что
-  откатывается только вместе.
-- **Правка самой поставки проверяется её прогоном, а не рассуждением.** Проверить её иначе
-  нечем: она исполняется только там, где выкатывает, и в среде, которой на месте работы нет — с
-  чужими правами, чужим хранилищем ключей и чужой сетью. «Проверю после слияния» решением
-  исполнителя не бывает: за этими словами стоит выкатка, которой уже не будет, если правка
-  окажется неверной. Отложить проверку может только владелец, и он говорит это словами.
-- **Две задачи, которые чинятся одной правкой, — одна задача.** Вторая стирается вместе со
-  своим номером, а то, чего в первой не было, дописывается в неё до этого. Две строки об
-  одной работе хуже дыры в нумерации: по ним потом не понять, что сделано, а что нет. Слить
-  их можно, пока правка не въехала в главную ветку; после — обе остаются как есть.
-- **Задача, ветка под неё и PR о сделанном несут один и тот же номер в своих названиях.**
-  Иначе одну работу приходится узнавать по тексту названия, а в списке из полусотни строк это
-  делается по памяти и с ошибками.
-- **Номер пишется всюду одинаково: ключ задач, дефис, номер.** Заголовок задачи и PR
-  начинается с этой пары в квадратных скобках, имя ветки — с неё же. Одна форма, а не три
-  похожих, потому что номер читают не только глазами: из имени ветки его достаёт гард, из
-  заголовка — сверка очереди. Формы, выведенные порознь, расходятся молча и не отказывают, а
-  перестают узнавать номер: проверка, которая должна была найти работу без задачи, пропускает
-  всё подряд.
-- **Ключ задач дерево называет само, но назвать обязано.** В форме имени это единственное, что
-  у каждого дерева своё, — и единственное, что настраивается. Не названный ключ не даёт ни
-  поблажки, ни умолчания: работа с очередью отказывает и говорит, где он задаётся. Пустой ключ
-  хуже отсутствующей проверки — от имени остаётся огрызок, которому ничто не отвечает, и
-  правильно названной не выглядит ни одна задача.
-- **У задачи есть исполнитель с момента её заведения.** Задача без исполнителя выглядит
-  ничьей: по очереди работ не видно, кто её взял, и заведённая по ходу правка теряется среди
-  чужих.
-- **Состояние задачи в очереди работ отвечает тому, что с ней происходит.** Взятая в работу
-  видна взятой, а та, PR по которой ждёт разбора, — ждущей разбора. Иначе очередь показывает
-  один и тот же вид у нетронутого, у делаемого прямо сейчас и у сделанного: работа берётся
-  второй раз, а PR стоит неразобранным, пока про него не вспомнят. Состояние переставляется
-  в тот момент, когда работа переходит на следующий шаг, а не приводится в порядок потом:
-  очередь читают между этими моментами, а не после них.
-- **Попадание правки в главную ветку означает выкатку.** Всё, от чего правка зависит снаружи
-  кода — переменные окружения, секреты, записи имён, — ставится до этого момента, а не после.
-- **Признак режима исполнения объявлен в самом артефакте развёртывания, а не только в составе
-  его запуска.** Артефакт поднимают и мимо состава — руками, при разборе, на чужой машине, — и
-  без объявления он в этот момент считает себя отладочным, не сказав об этом ничего.
+  выглядит строгим, а работает наоборот: прогон, который длится вдесятеро дольше нужного, учат не
+  ждать, а обходить. Состав набора выводится из состава правки — из того, что она задела, а не из
+  того, кем она названа; правка, не тронувшая ни строки кода, не собирает образов и не снимает
+  кадров. Пропущенное при этом называется пропущенным: молча выпавший шаг читается как пройденный.
+- **У задачи одна ветка, у ветки одна задача.** Откат снимает всё, что въехало этой веткой, разом:
+  две задачи в ней откатятся только вместе, а задача, въехавшая двумя ветками, после отката одной
+  останется наполовину сделанной — и в очереди работ этого не видно. Работа, которая в одну ветку
+  не влезает, делится на задачи до заведения ветки. Признак деления — раздельный откат, а не
+  объём: числа файлов, строк или коммитов, за которым работа становится двумя задачами, нет.
+  Правка одного рода остаётся одной задачей, сколько бы файлов она ни задела; объём захода
+  говорит, какого размера задачу заводить среди тех, что делятся законно, и делить неделимое не
+  даёт.
+- **Правка самой поставки проверяется её прогоном, а не рассуждением.** Проверить её иначе нечем:
+  она исполняется только там, где выкатывает, и в среде, которой на месте работы нет — с чужими
+  правами, чужим хранилищем ключей и чужой сетью. «Проверю после слияния» решением исполнителя не
+  бывает: за этими словами стоит выкатка, которой уже не будет, если правка окажется неверной.
+  Отложить проверку может только владелец, и он говорит это словами.
+- **Две задачи, которые чинятся одной правкой, — одна задача.** Вторая стирается вместе со своим
+  номером, а то, чего в первой не было, дописывается в неё до этого. Две строки об одной работе
+  хуже дыры в нумерации: по ним потом не понять, что сделано, а что нет. Слить их можно, пока
+  правка не въехала в главную ветку; после — обе остаются как есть.
+- **Задача, ветка под неё и PR о сделанном несут один и тот же номер в своих названиях.** Иначе
+  одну работу приходится узнавать по тексту названия, а в списке из полусотни строк это делается
+  по памяти и с ошибками.
+- **Номер пишется всюду одинаково: ключ задач, дефис, номер.** Заголовок задачи и PR начинается с
+  этой пары в квадратных скобках, имя ветки — с неё же. Одна форма, а не три похожих, потому что
+  номер читают не только глазами: из имени ветки его достаёт гард, из заголовка — сверка очереди.
+  Формы, выведенные порознь, расходятся молча и не отказывают, а перестают узнавать номер:
+  проверка, которая должна была найти работу без задачи, пропускает всё подряд.
+- **Ключ задач дерево называет само, но назвать обязано.** В форме имени это единственное, что у
+  каждого дерева своё, — и единственное, что настраивается. Не названный ключ не даёт ни поблажки,
+  ни умолчания: работа с очередью отказывает и говорит, где он задаётся. Пустой ключ хуже
+  отсутствующей проверки — от имени остаётся огрызок, которому ничто не отвечает, и правильно
+  названной не выглядит ни одна задача.
+- **У задачи есть исполнитель с момента её заведения.** Задача без исполнителя выглядит ничьей: по
+  очереди работ не видно, кто её взял, и заведённая по ходу правка теряется среди чужих.
+- **Состояние задачи в очереди работ отвечает тому, что с ней происходит.** Взятая в работу видна
+  взятой, ждущая разбора — ждущей. Иначе нетронутое, делаемое и сделанное выглядят одинаково:
+  работа берётся второй раз, а PR стоит неразобранным. Состояние переставляется в тот момент,
+  когда работа переходит на следующий шаг: очередь читают между этими моментами, а не после них.
+- **Попадание правки в главную ветку означает выкатку.** Всё, от чего правка зависит снаружи кода
+  — переменные окружения, секреты, записи имён, — ставится до этого момента, а не после.
+- **Признак режима исполнения объявлен в самом артефакте развёртывания, а не только в составе его
+  запуска.** Артефакт поднимают и мимо состава — руками, при разборе, на чужой машине, — и без
+  объявления он в этот момент считает себя отладочным, не сказав об этом ничего.
 - **Выкатывается образ того коммита, который выкатывают.** Умолчание «последний» отстаёт от
   главной ветки, и приложение молча возвращается к прежней версии, продолжая отвечать.
 - **Из одного и того же коммита всегда ставятся одни и те же зависимости.** Если версия задана
-  диапазоном, установка сегодня и установка через неделю дадут разный код: сборка сломается
-  сама собой, и откатывать будет нечего. Обновление зависимости — обычная правка: у неё есть
-  автор, описание и откат.
+  диапазоном, установка сегодня и установка через неделю дадут разный код: сборка сломается сама
+  собой, и откатывать будет нечего. Обновление зависимости — обычная правка: у неё есть автор,
+  описание и откат.
 - **Порядок изменений хранилища проверяется с пустого места.** На уже работающем хранилище
   неверный порядок незаметен: он проявляется только при развёртывании с нуля.
-- **Проверка перед отправкой смотрит на содержимое репозитория, а не на состояние машины, где
-  она запущена.** На машине законно лежат недоделки, личные настройки и файлы вне истории.
-  Проверка, которая их читает, отбивает правку из-за того, чего в репозитории нет, и молчит о
-  том, что в нём есть. Проверка перед отправкой и конвейер выкатки судят по одному и тому же —
-  иначе «сошлось» значит в этих двух местах разное.
-- **Документ едет вместе с правкой, которую он описывает.** Ни сборка, ни проверки текстов
-  не читают, поэтому расхождение копится молча и потом выглядит действующей справкой.
+- **Проверка перед отправкой смотрит на содержимое репозитория, а не на состояние машины, где она
+  запущена.** На машине законно лежат недоделки, личные настройки и файлы вне истории. Проверка,
+  которая их читает, отбивает правку из-за того, чего в репозитории нет, и молчит о том, что в нём
+  есть. Проверка перед отправкой и конвейер выкатки судят по одному и тому же — иначе «сошлось»
+  значит в этих двух местах разное.
+- **Документ едет вместе с правкой, которую он описывает.** Ни сборка, ни проверки текстов не
+  читают, поэтому расхождение копится молча и потом выглядит действующей справкой.
 - **Работа, меняющая код, кончается открытым PR.** PR — единственное место, где человек видит
-  правку целиком, отвечает на неё и вливает её; коммит в ветке и запушенная ветка этого места
-  не заменяют. Пока PR не открыт, работа сделанной не считается, сколько бы её ни было в
-  истории ветки: разбор по ней невозможен, а человек о ней не знает. Открывается PR тем же
-  ходом, которым исполнитель говорит, что работу отдаёт, — а не следующим заходом и не по
-  напоминанию.
-- **PR, не готовый к слиянию, помечается черновиком.** Открытый PR читается как приглашение
-  влить, и человек нажимает слияние, не спрашивая, кончилась ли работа. Черновик разводит два
-  состояния, которые иначе выглядят одинаково: правка выложена на обозрение — и правка готова
-  поехать в главную ветку. Помечается им всё, что ждёт прогона, доработки или ответа на
-  вопрос; вопрос при этом задаётся в самом PR, а не остаётся в голове исполнителя.
+  правку целиком, отвечает на неё и вливает; коммит и запушенная ветка его не заменяют. Пока PR не
+  открыт, работа сделанной не считается: разбора по ней нет, а человек о ней не знает. Открывается
+  PR тем же ходом, которым исполнитель говорит, что работу отдаёт, — а не следующим заходом и не
+  по напоминанию.
+- **PR, не готовый к слиянию, помечается черновиком.** Открытый PR читается как приглашение влить,
+  и человек нажимает слияние, не спрашивая, кончилась ли работа. Черновик разводит два состояния,
+  которые иначе выглядят одинаково: правка выложена на обозрение — и правка готова поехать в
+  главную ветку. Помечается им всё, что ждёт прогона, доработки или ответа на вопрос; вопрос при
+  этом задаётся в самом PR, а не остаётся в голове исполнителя.
 - **Снятие черновика — отдельный ход, и им исполнитель отвечает за готовность.** Черновик
-  снимается тогда, когда проверки пройдены, доработок не осталось и работа сходится с тем,
-  ради чего заводилась задача. Пока он стоит, молчание исполнителя значит «ещё не готово», и
-  человек ничего не должен переспрашивать; после снятия оно значит «можно вливать», и цена
-  ошибки здесь — правка в главной ветке.
-- **PR о сделанном остаётся верным до самого слияния.** Он описывает дерево на день, когда
-  его написали, а разбора ждёт днями: за это время главная ветка вливается в ветку, и
-  утверждение PR о соседних файлах становится неправдой молча — тел PR не читает ни
-  одна проверка. Всё, что вливается в ветку после публикации PR, — повод перечитать его.
-- **PR в главную ветку вливает человек.** Слияние — последний момент, когда разбор ещё
-  возможен: после него правка стоит в главной ветке, работа ушла к следующей задаче, и
-  вернуться к ней уже некому. Исполнитель работы вливает свой PR только по прямому слову
-  человека и только про названный PR; молчание разрешением не бывает, а слово, сказанное об
-  одном PR, на следующий не переносится. Иначе разбор проходит тот, кого разбирают, и
-  очередь PR выглядит разобранной, не будучи ею.
+  снимается тогда, когда проверки пройдены, доработок не осталось и работа сходится с тем, ради
+  чего заводилась задача. Пока он стоит, молчание исполнителя значит «ещё не готово», и человек
+  ничего не должен переспрашивать; после снятия оно значит «можно вливать», и цена ошибки здесь —
+  правка в главной ветке.
+- **PR о сделанном остаётся верным до самого слияния.** Он описывает дерево на день, когда его
+  написали, а разбора ждёт днями: за это время главная ветка вливается в ветку, и утверждение PR о
+  соседних файлах становится неправдой молча — тел PR не читает ни одна проверка. Всё, что
+  вливается в ветку после публикации PR, — повод перечитать его.
+- **PR в главную ветку вливает человек.** Слияние — последний момент, когда разбор ещё возможен:
+  после него правка стоит в главной ветке, работа ушла к следующей задаче, и вернуться к ней уже
+  некому. Исполнитель работы вливает свой PR только по прямому слову человека и только про
+  названный PR; молчание разрешением не бывает, а слово, сказанное об одном PR, на следующий не
+  переносится. Иначе разбор проходит тот, кого разбирают, и очередь PR выглядит разобранной, не
+  будучи ею.
 - **Требование, стоящее перед необратимым шагом, стоит там, где этот шаг совершают.** Гард на
-  машине исполнителя судит его команды и молчит о том же действии, совершённом кнопкой у
-  хостинга: обход выходит не намеренным, а незамеченным — нажавший не знает, что чего-то не
-  хватало. Требование либо переносится туда, где нажимают, либо объявляется тому, кто нажимает,
-  до нажатия. Иначе оно держится не собой, а тем, что необратимый шаг каждый раз делает тот же
-  человек: папка закрытой задачи так и уехала в главную ветку вместе со своей договорённостью, и
-  вынимать её пришлось отдельной задачей.
+  машине исполнителя судит его команды и молчит о том же действии, совершённом кнопкой у хостинга:
+  обход выходит не намеренным, а незамеченным — нажавший не знает, что чего-то не хватало.
+  Требование либо переносится туда, где нажимают, либо объявляется тому, кто нажимает, до нажатия.
+  Иначе оно держится не собой, а тем, что необратимый шаг каждый раз делает тот же человек.
 - **Слияние в главную ветку ещё не означает, что правка доехала.** Отказ выкатки не трогает ни
   задачу, ни очередь работ, поэтому расхождение главной ветки с тем, что работает, обязано быть
   видно там, где очередь читают. Иначе следующие работы вливаются поверх поломки, которую не
   приносили, и каждая выглядит доехавшей.
-- **Состоявшаяся поломка разбирается записью, которая переживает задачу.** Починка уезжает
-  веткой, задача закрывается — и причина, по которой приложение встало, остаётся знанием одного
-  исполнителя. Запись называет, что сломалось, чем это стало видно и почему починка чинит
-  причину, а не признак; живёт она среди описаний состоявшегося, а не там, что умирает вместе с
-  задачей.
+- **Состоявшаяся поломка разбирается записью, которая переживает задачу.** Починка уезжает веткой,
+  задача закрывается — и причина, по которой приложение встало, остаётся знанием одного
+  исполнителя. Запись называет, что сломалось, чем это стало видно и почему починка чинит причину,
+  а не признак; живёт она среди описаний состоявшегося, а не там, что умирает вместе с задачей.

package/assets/laws/frontend-application.md

@@ -5,6 +5,10 @@
 
 ## Статьи
 
+- **У действия человека есть путь в интерфейсе.** Команда на сервере — путь того, кто держит
+  сервер: у неё свой доступ, своя оболочка и свой узел. Приложение, у которого обычное действие
+  делается заходом на сервер, интерфейса этому действию не дало, и наличие такой команды его
+  наличия не заменяет.
 - **Состояние экрана пересчитывается само, а не по команде.** Пересчёт вручную рано или
   поздно пропускают, и экран показывает прежнее значение рядом с новым.
 - **Шаблон показывает готовое, а не вычисляет.** Вычисление в шаблоне повторяется на каждой

package/assets/laws/project-documentation.md

@@ -6,92 +6,88 @@
 старше.
 
 ## Статьи
-
-- **У документа заранее задан набор разделов, и отсутствие раздела — отказ.** Требования,
-  для которых не заведено места, вспоминаются уже после выкатки.
-- **Каждое утверждение документа привязано к месту, где оно исполняется.** Утверждение без
-  такого места — намерение, и называть его действующим нельзя.
-- **Предстоящая работа перечислена в одном месте — в очереди работ.** Документ второго списка
-  не заводит: два списка об одной работе расходятся молча, и по ним потом не понять, что
-  сделано, а что нет. Документу остаётся то, что задачей не бывает, — договорённость и
-  решение, которое решено не править.
-- **Привязка не ведёт в код, который никто не зовёт.** Объявленный и никем не используемый
-  символ ничего не исполняет, а проверка на нём остаётся зелёной.
-- **Путь, названный в документе, существует.** Ссылка на переехавший файл читается как
-  действующее указание, и следующий читатель заводит снятое заново.
+- **У документа заранее задан набор разделов, и отсутствие раздела — отказ.** Требования, для
+  которых не заведено места, вспоминаются уже после выкатки.
+- **Каждое утверждение документа привязано к месту, где оно исполняется.** Утверждение без такого
+  места — намерение, и называть его действующим нельзя.
+- **Предстоящая работа перечислена в одном месте — в очереди работ.** Документ второго списка не
+  заводит: два списка об одной работе расходятся молча, и по ним потом не понять, что сделано, а
+  что нет. Документу остаётся то, что задачей не бывает, — договорённость и решение, которое
+  решено не править.
+- **Привязка не ведёт в код, который никто не зовёт.** Объявленный и никем не используемый символ
+  ничего не исполняет, а проверка на нём остаётся зелёной.
+- **Путь, названный в документе, существует.** Ссылка на переехавший файл читается как действующее
+  указание, и следующий читатель заводит снятое заново.
 - **Указатель каталога перечисляет всё, что в каталоге лежит.** Записи, которой в указателе нет,
   для читателя не существует: он ищет по указателю, а не обходом каталога, и заводит разбор
   заново. Это обратная сторона предыдущей статьи — не только путь из текста ведёт в файл, но и
   файл назван в тексте, по которому его ищут.
 - **Документ, разошедшийся с приложением, правится тогда же, когда замечено расхождение.**
   Отложенная правка не случается: расхождение перестаёт быть заметным на следующий день.
-- **Расхождение чинится в той стороне, которая неправа, и это не всегда документ.**
-  Состояние, описанное как существующее, но недостижимое в приложении, — дефект приложения:
-  строка читается справкой о работающем, на неё ссылаются как на проверенное, и правка
-  документа под код закрепила бы дыру вместо того, чтобы её показать.
-- **Документ не утверждает о будущем, и следит за этим автор.** «Не планируется», «не будет»
-  — это намерение, а не свойство приложения: сверить его не с чем, и оно проходит любую
-  проверку. Машине это не поручить: открытый вопрос пишется теми же словами, что и обещание,
-  и проверка отбивала бы оба.
+- **Расхождение чинится в той стороне, которая неправа, и это не всегда документ.** Состояние,
+  описанное как существующее, но недостижимое в приложении, — дефект приложения: строка читается
+  справкой о работающем, на неё ссылаются как на проверенное, и правка документа под код закрепила
+  бы дыру вместо того, чтобы её показать.
+- **Документ не утверждает о будущем, и следит за этим автор.** «Не планируется», «не будет» — это
+  намерение, а не свойство приложения: сверить его не с чем, и оно проходит любую проверку. Машине
+  это не поручить: открытый вопрос пишется теми же словами, что и обещание, и проверка отбивала бы
+  оба.
 - **Полнота текстов проверяется и со стороны работы, а не только со стороны текста.** Обход
   написанного судит каждое утверждение, но утверждения, которого нет, в этом обходе нет тоже:
   приём, применённый и нигде не описанный, так не находится никогда. Поэтому закрытая работа
   спрашивается отдельно — оставила она след в текстах или явно его не требует.
-- **Документ утверждает о состоявшемся, а не о том, что должно сработать.** Лечение,
-  записанное готовым до того, как его прогнали, дороже отсутствия записи: следующий читатель
-  берёт его за проверенное — и берёт в тот день, когда лечение понадобилось, а времени на
-  разбор нет. Непрогнанное либо не пишется вовсе, либо названо непроверенным тем же
-  предложением.
+- **Документ утверждает о состоявшемся, а не о том, что должно сработать.** Лечение, записанное
+  готовым до того, как его прогнали, дороже отсутствия записи: следующий читатель берёт его за
+  проверенное — и берёт в тот день, когда лечение понадобилось, а времени на разбор нет.
+  Непрогнанное либо не пишется вовсе, либо названо непроверенным тем же предложением.
 - **Число в тексте пересчитывается тем же изменением, которым пишется, и за этим тоже следит
-  автор.** Устаревшее число выглядит так же, как свежее, а машине их не различить: дата,
-  версия и номер — такие же числа, и проверка, которая знает один способ записи, на другом
-  ошибается молча.
+  автор.** Устаревшее число выглядит так же, как свежее, а машине их не различить: дата, версия и
+  номер — такие же числа, и проверка, которая знает один способ записи, на другом ошибается молча.
 - **Отказ от слова распространяется на всё, что уже прочитано снаружи, а не только на файлы.**
-  Название работы, её описание и запись о правке живут вне дерева: поиск по файлам их не
-  видит, проверки текстов на них не смотрят, и отказ выглядит сделанным ровно до того, как
-  читатель наткнётся на снятое слово в заголовке. Читатель при этом заключает, что от слова
-  не отказывались вовсе.
-- **Текст, который переносится в чужое дерево, не описывает состояние этого дерева как факт.**
-  О соседней части он говорит условно и называет её по имени: что в дереве стоит, а чего нет,
-  знает само дерево, а не текст, приехавший в него. Утверждение, сказанное безусловно, врёт тем
+  Название работы, её описание и запись о правке живут вне дерева: поиск по файлам их не видит,
+  проверки текстов на них не смотрят, и отказ выглядит сделанным ровно до того, как читатель
+  наткнётся на снятое слово в заголовке. Читатель при этом заключает, что от слова не отказывались
+  вовсе.
+- **Текст, который переносится в чужое дерево, не описывает состояние этого дерева как факт.** О
+  соседней части он говорит условно и называет её по имени: что в дереве стоит, а чего нет, знает
+  само дерево, а не текст, приехавший в него. Утверждение, сказанное безусловно, врёт тем
   увереннее, что печатает его сам инструмент, — и поправить его дерево не может, если правки на
   месте у такого текста не предусмотрено.
 - **Принятое решение становится пунктом слоя правил, а не записью о прошлом.** Записанное
-  описанием прошлого перестаёт действовать в тот же день: описания прошлого не приходят в
-  контекст работы, читаются как история и ничего не требуют. Следующая работа принимает то же
-  решение заново — и принимает иначе, потому что доводов первого уже не видит.
-- **У решения есть слой, и он выбирается по тому, о чём решение говорит.** Что должно быть
-  верно в продукте — статья закона. Каким приёмом это делается здесь — пункт правила. Готовый
-  код и порядок действий — паттерн. Решение, положенное не в свой слой, находится только тем,
-  кто уже знает, что оно есть.
+  описанием прошлого перестаёт действовать в тот же день: описания прошлого не приходят в контекст
+  работы, читаются как история и ничего не требуют. Следующая работа принимает то же решение
+  заново — и принимает иначе, потому что доводов первого уже не видит.
+- **У решения есть слой, и он выбирается по тому, о чём решение говорит.** Что должно быть верно в
+  продукте — статья закона. Каким приёмом это делается здесь — пункт правила. Готовый код и
+  порядок действий — паттерн. Решение, положенное не в свой слой, находится только тем, кто уже
+  знает, что оно есть.
 - **Описание прошлого объясняет состоявшийся переезд, а не держит действующее требование.**
-  Разница видна вопросом: перестанет ли текст быть верным, если завтра всё переделать. Рассказ
-  о том, как и почему однажды перенесли, — прошлое; требование «делай так» — нет, и место ему
-  в слое правил.
+  Разница видна вопросом: перестанет ли текст быть верным, если завтра всё переделать. Рассказ о
+  том, как и почему однажды перенесли, — прошлое; требование «делай так» — нет, и место ему в слое
+  правил.
 - **Признак, по которому решение относят к прошлому, записан заранее и один на все работы.**
   Выводимый каждой работой заново, он назначается тем, кому мешает: под конец работы дешевле
   назвать прошлым всё, что осталось разобрать.
-- **Раздел решений в описании домена — временное место, а не постоянное.** Пока решение там,
-  оно действует только для того, кто открыл этот файл. Разросшийся раздел — признак того, что
-  правило под него не заведено, а не того, что домен сложный.
-- **Работа, которая переносит решения, называет для каждого, куда оно ушло.** Иначе по
-  описанию прошлого не отличить решение, ставшее правилом, от решения, потерянного при
-  переносе: оба выглядят одинаково — записью, на которую никто не ссылается.
-- **Текст, раздаваемый наружу, судится не слабее своей копии у потребителя.** Требование,
-  стоящее к копии и не стоящее к источнику, находит промах у того, кто его не делал и починить
-  не может: до потребителя промах доезжает целым, а краснеет уже там.
-- **Редакция текста, которую это дерево не выбрало, судится наравне с выбранной.**
-  Непрочитанная редакция расходится с прочитанной молча, и узнаёт об этом первый, кто её
-  выберет, — то есть тот, у кого нет ни истории расхождения, ни повода его искать.
-- **Набор обязательных разделов объявлен отдельно, и образец ему не хозяин.** Образец —
-  черновик для того, кто заводит текст, и стареет он первым. Набор, выведенный из образца, либо
-  объявляет расхождением весь корпус разом, либо не замечает ничего.
-- **Требование, которого никто не формулировал, молчит, а не отказывает.** Отказ на предмете
-  без объявленного требования гасят списком исключений, а список исключений через месяц
-  становится рабочим путём — и гасит вместе с шумом то, ради чего проверка заводилась.
-- **Два текста об одном либо говорят одно, либо один из них неправ.** Согласие текстов между
-  собой не следует ни из целостности ссылок, ни из полноты разделов: оба проходят любую такую
-  проверку, а исполнитель берёт тот, который прочитал раньше. Ищется это чтением — считать
-  здесь нечего.
+- **Раздел решений в описании домена — временное место, а не постоянное.** Пока решение там, оно
+  действует только для того, кто открыл этот файл. Разросшийся раздел — признак того, что правило
+  под него не заведено, а не того, что домен сложный.
+- **Работа, которая переносит решения, называет для каждого, куда оно ушло.** Иначе по описанию
+  прошлого не отличить решение, ставшее правилом, от решения, потерянного при переносе: оба
+  выглядят одинаково — записью, на которую никто не ссылается.
+- **Текст, раздаваемый наружу, судится не слабее своей копии у потребителя.** Требование, стоящее
+  к копии и не стоящее к источнику, находит промах у того, кто его не делал и починить не может:
+  до потребителя промах доезжает целым, а краснеет уже там.
+- **Редакция текста, которую это дерево не выбрало, судится наравне с выбранной.** Непрочитанная
+  редакция расходится с прочитанной молча, и узнаёт об этом первый, кто её выберет, — то есть тот,
+  у кого нет ни истории расхождения, ни повода его искать.
+- **Набор обязательных разделов объявлен отдельно, и образец ему не хозяин.** Образец — черновик
+  для того, кто заводит текст, и стареет он первым. Набор, выведенный из образца, либо объявляет
+  расхождением весь корпус разом, либо не замечает ничего.
+- **Требование, которого никто не формулировал, молчит, а не отказывает.** Отказ на предмете без
+  объявленного требования гасят списком исключений, а список исключений через месяц становится
+  рабочим путём — и гасит вместе с шумом то, ради чего проверка заводилась.
+- **Два текста об одном либо говорят одно, либо один из них неправ.** Согласие текстов между собой
+  не следует ни из целостности ссылок, ни из полноты разделов: оба проходят любую такую проверку,
+  а исполнитель берёт тот, который прочитал раньше. Ищется это чтением — считать здесь нечего.
 - **Изображение правится тем же изменением, что и текст, который оно изображает.** Разойдясь,
   схема и проза остаются читаемыми обе, и первым это замечает тот, кто пошёл по схеме.

package/assets/laws/verifiability.md

@@ -5,53 +5,52 @@
 который «должен работать», и код, который проверили, в истории выглядят одинаково.
 
 ## Статьи
-
-- **Обещанное поведение названо сценарием, а сценарий назван в тесте, который его
-  проверяет.** Иначе связь между обещанием и проверкой держится только на памяти автора.
-- **Сценарий без теста помечен как непокрытый и виден в сводке.** Молчаливый пропуск
-  выглядит так же, как покрытый сценарий, и долг перестаёт быть заметным.
+- **Обещанное поведение названо сценарием, а сценарий назван в тесте, который его проверяет.**
+  Иначе связь между обещанием и проверкой держится только на памяти автора.
+- **Сценарий без теста помечен как непокрытый и виден в сводке.** Молчаливый пропуск выглядит так
+  же, как покрытый сценарий, и долг перестаёт быть заметным.
 - **Тест, проверяющий часть обещанного, считается долгом, а не покрытием.** Иначе сводка
   показывает выполненным то, что выполнено наполовину.
-- **Обещание, данное пользователю, закрывается тестом, который идёт его путём.** Тот же
-  расчёт, проверенный мимо экрана, верен — и обещания не закрывает: между верным решением и
-  тем, что человек его видит, лежит всё, чего проверка не касалась.
+- **Обещание, данное пользователю, закрывается тестом, который идёт его путём.** Тот же расчёт,
+  проверенный мимо экрана, верен — и обещания не закрывает: между верным решением и тем, что
+  человек его видит, лежит всё, чего проверка не касалась.
 - **Тест, выключенный признаком окружения, покрытием не считается.** В обычном прогоне он не
   исполняется ни разу, а в сводке выглядит так же, как исполненный.
 - **Упоминание в тесте сценария, которого нет, — отказ.** Так ловится переименованный или
   выкинутый сценарий: без этого он пропадает молча.
-- **Работающее приложение проверяется там, где его видит пользователь.** Отладочный режим
-  ведёт себя иначе рабочего, и проверка в нём подтверждает не то, что будет у пользователя.
+- **Работающее приложение проверяется там, где его видит пользователь.** Отладочный режим ведёт
+  себя иначе рабочего, и проверка в нём подтверждает не то, что будет у пользователя.
 - **Перед отправкой правка проверяется тем же набором, что и конвейер, и теми же командами.**
   Набор, собранный по изменённым файлам, пропускает то, до чего правка дошла связями: проверка
   зелёная, а конвейер красный. Что проверять, считает инструмент от той же базы, а не память
   автора.
-- **Проверка признака окружения относится только к тому пути запуска, на котором она
-  сделана.** Пути, которыми одно и то же приложение поднимается, задают признаки по-разному,
-  и подтверждённое на одном из них на остальных неверно — а выглядит проверенным целиком.
+- **Проверка признака окружения относится только к тому пути запуска, на котором она сделана.**
+  Пути, которыми одно и то же приложение поднимается, задают признаки по-разному, и подтверждённое
+  на одном из них на остальных неверно — а выглядит проверенным целиком.
 - **Разметка проверяется замером, а не взглядом.** На глаз не отличить отступ от поля и
   выравнивание от совпадения, и расхождение находится уже после выкатки.
-- **Успешный ответ команды означает, что она отработала, а не что нужное состояние
-  наступило.** Часть запросов выполняется наполовину, и об отклонённой части в ответе ничего
-  нет: по коду возврата такой вызов не отличить от исполненного. Поэтому результат читают
-  отдельным запросом, и в PR идёт то, что прочитали, а не то, что заказывали.
-- **Служба считается поднятой, когда она выполнила задание, а не когда сообщила о
-  готовности.** Сообщение о готовности говорит лишь, что служба себя объявила: та, которой не
-  досталось ни одного задания, выглядит в нём точно так же, как работающая. Проверяются обе
-  стороны связи — что заказчик выбирает именно её и что задание через неё прошло.
-- **Причина отказа, на которой строится решение, подтверждается измерением, а не
-  правдоподобием.** Объяснение, пришедшее первым, объясняет наблюдаемое не хуже верного:
-  свойство среды и собственный промах выглядят в отказе одинаково, и разводит их только замер,
-  поставленный так, чтобы одно из двух не прошло. Решение, выведенное из неподтверждённой
-  причины, лечит не то — и стоит отката всей работы, а не одной правки.
+- **Успешный ответ команды означает, что она отработала, а не что нужное состояние наступило.**
+  Часть запросов выполняется наполовину, и об отклонённой части в ответе ничего нет: по коду
+  возврата такой вызов не отличить от исполненного. Поэтому результат читают отдельным запросом, и
+  в PR идёт то, что прочитали, а не то, что заказывали.
+- **Служба считается поднятой, когда она выполнила задание, а не когда сообщила о готовности.**
+  Сообщение о готовности говорит лишь, что служба себя объявила: та, которой не досталось ни
+  одного задания, выглядит в нём точно так же, как работающая. Проверяются обе стороны связи — что
+  заказчик выбирает именно её и что задание через неё прошло.
+- **Причина отказа, на которой строится решение, подтверждается измерением, а не правдоподобием.**
+  Объяснение, пришедшее первым, объясняет наблюдаемое не хуже верного: свойство среды и
+  собственный промах выглядят в отказе одинаково, и разводит их только замер, поставленный так,
+  чтобы одно из двух не прошло. Решение, выведенное из неподтверждённой причины, лечит не то — и
+  стоит отката всей работы, а не одной правки.
 - **Если инструмент проверки запрещает приём, которым здесь пользуются постоянно, его правило
   выключают в настройке инструмента, а не обходят в каждом месте.** Обход приходится повторять
   столько раз, сколько таких мест, и ни в одном из них не написано, зачем он: со стороны это
   выглядит ошибкой автора, а не решением.
-- **Красная проверка означает неверный код, а не неверную проверку.** Место, выведенное
-  из-под проверки затем, чтобы она замолчала, чинит показание, а не то, на что она указала:
-  код остаётся прежним, а сигнала о нём больше нет ни у кого. Список известного накоплен к
-  дню заведения проверки и только сокращается; несогласие с самой проверкой — вопрос к
-  владельцу, а не строка в списке.
+- **Красная проверка означает неверный код, а не неверную проверку.** Место, выведенное из-под
+  проверки затем, чтобы она замолчала, чинит показание, а не то, на что она указала: код остаётся
+  прежним, а сигнала о нём больше нет ни у кого. Список известного накоплен к дню заведения
+  проверки и только сокращается; несогласие с самой проверкой — вопрос к владельцу, а не строка в
+  списке.
 - **Польза правила подтверждается наблюдением за тем, как им пользуются, а не мнением о нём.**
   Правило, которого не открыли ни разу, и правило, на котором держится половина работы, в тексте
   выглядят одинаково — и правится первым обычно то, о чём вспомнили, а не то, что мешает.
@@ -59,8 +58,8 @@
   умирает вместе с сессией, отвечает только на вопрос «что было минуту назад».
 - **Наблюдение за работой не выносит наружу ничего, кроме того, что общее у всех.** Имя правила,
   род события и версия одинаковы везде, где стоит слой правил; путь, домен и имя дерева
-  принадлежат одному дереву и в чужом месте не значат ничего, кроме утечки. Держится это
-  проверкой на выносящей стороне, а не памятью того, кто пишет.
+  принадлежат одному дереву и в чужом месте не значат ничего, кроме утечки. Держится это проверкой
+  на выносящей стороне, а не памятью того, кто пишет.
 - **Проверка, которая сама сломалась, работу не останавливает.** Отказ инструмента не является
   найденным нарушением, и остановленная им работа стоит до того, как его починят.
 - **Решение, зависящее от текущего момента, получает момент снаружи.** Иначе проверить его можно