@rt-tools/agent-kit 0.16.0 → 0.17.0

package/assets/pitfalls/task-flow.md

@@ -57,6 +57,51 @@
   расспрашивает владельца заново. Имя черновику дают словами просьбы, а ветке — терминологией
   договорённости; те же слова, да не те же.
 
+- **Ожидание одной части этапа остановкой этапа не бывает.** Части, которые от ожидаемого не
+  зависят, делаются тем же ходом: сказать «стоит приёмка» и не тронуть остальное — это
+  остановка всей работы по причине, действующей на её десятую часть. Правило говорит про
+  задачу, и «стоит одна часть» прочитывается по нему как «стоит работа» — при пяти частях этапа
+  ждала одна.
+
+- **Строка с путём поручением не бывает.** Адрес называет файл, а не действие; прочитанный как
+  задание, он даёт заходу работу, которой владелец не просил. То же с любой репликой без
+  глагола: спросить, что с этим делать, дешевле, чем написать полсотни файлов мимо просьбы.
+
+- **Тело задачи, написанное вперёд замысла, называет способ, и способ стареет раньше дефекта.**
+  Задача серии заводится за недели до того, как её берут, и к этому дню предложенный ход бывает
+  уже неверен: привезённое пакетом умеет то, что задача звала написать, названного места в
+  дереве не осталось, а посылки, на которых ход стоял, разведка не подтверждает. Читается такое
+  тело как действующее указание, поэтому работа начинается с чтения того файла, к которому
+  задача относится, а не с исполнения её тела. Расхождение уходит решением по ходу и меняет
+  способ, но не цель.
+
+- **Работа, упершаяся в разрешение, доводится до конца без той части, которую разрешение
+  открывает.** Чужой шаг бывает двух родов: прогон и разбор идут сами и кончатся без
+  исполнителя, а отбитое разрешение не кончится никогда — его ждут, и ход, объявивший об этом,
+  останавливает работу целиком. Делается всё, что от разрешения не зависит, а непройденное
+  пишется строками тела заявки — там его читает ревьювер; реплика владельцу живёт до следующего
+  сообщения и в приёмку не попадает.
+
+- **Слово владельца об устройстве — постановка, а не решение.** Названное им обычно уже живёт
+  в дереве под этим самым словом: у него есть имя на экране, раздел в спеке и поле в модели, и
+  сверка стоит одного поиска. Истолкованное по ближайшему коду, слово выглядит исполненной
+  просьбой ровно до приёмки: правка при этом влита, а владельцу вместо поля в приложении
+  досталась работа в чужой консоли. Разошлось прочтение с деревом — спрашивается владелец, и
+  спрашивается до правки.
+
+- **Указание работать по ходу — это указание делать его шаги, включая меняющие историю.**
+  Отметка сделанного этапа, отправка ветки и открытие заявки ходом предписаны, и отдельного
+  слова на каждый не требуется: спросить надо о том, чего в ходе нет вовсе. Изъятие приходит
+  из общего запрета дерева на действие без просьбы, прочитанного как требование буквального
+  слова, — и получается указание, исполненное наполовину. Граница у этого одна: прямое слово
+  владельца о самом шаге. Сказано «ветку не отправляй» — она не отправляется, сколько бы раз
+  ход её ни предписывал.
+
+- **Строка ожидания живёт дольше причины, по которой её написали.** Записанная в ход работы,
+  она приходит в следующий заход раньше любой реплики и подтверждает себя сама: три указания
+  подряд не пересилили одну строку на диске. Снимается она тем же ходом, которым владелец
+  ответил, — а не тем, в котором о ней вспомнили.
+
 - **У меню с закрытым набором нет строки «вопрос не тот».** Вариантами вопрос выглядит
   разобранным, и владельцу, чтобы отвергнуть саму постановку, приходится выходить из набора
   руками. Спрашивают меню то, где выбор действительно закрыт; там, где под сомнением сама
@@ -82,9 +127,57 @@
   работой, а не отдельной правкой.
 - **Папка, уехавшая в главную ветку.** Три раза подряд папка закрытой задачи так и уехала
   неразобранной, в последний раз их набралось пять.
+- **Этап, вставший из-за одной своей части.** Этап состоял из пяти частей, одна ждала поднятых
+  владельцем серверов — встали все пять. Остальные четыре от ожидаемого не зависели ничем.
+
+- **Замысел эпика, положенный каждым заходом заново, теряет решения предыдущих.** Имя, адрес и
+  способ, названные владельцем по ходу, живут там же, где состав и порядок задач.
+- **Чтение обхода из самой команды работает и без сети.** Строка `Task-folder-skip:` читается и
+  из тела заявки, и из текста вызова: второй путь остаётся, когда хостинг недоступен.
+- **Черновик без номера — единственная папка, которой в истории нет.** Заводить её туда нечего,
+  пока нет имени.
+- **На борде эпик из десяти задач выглядит одной.** Заведённые по одной, они прячут объём:
+  владелец видит карточку, а не десять.
+- **Разбор закрытой работы ведёт роль разбора закрытой задачи.** Дерево, её не разложившее,
+  ведёт разбор само.
+- **Перечень состояний нужен владельцу в начале работы.** Без него после шести вопросов не видно
+  ни того, что будет дальше, ни сколько всего впереди.
+- **Хвост отданной работы — четыре шага:** открыть заявку, дождаться прогона, снять черновик,
+  попросить влить. Состояния на диске у них уже нет.
+- **Разбор из одной строки проходит гард так же, как разбор на сто.** Образец разбора
+  перечисляет шесть обязательных вопросов таблицей, и пустая таблица проходит наравне с
+  заполненной.
+- **Отказ гарда разговора исполняется задним числом.** Владелец видит незаданный вопрос вместе с
+  отбитым ходом: прозаический вопрос инструментом не является, и раньше поймать его нечем. Гард
+  отмечает пропуск, но не отменяет его.
+- **Обход требования папки нужен там, где работа вливается частями.** Тогда её до конца не
+  разбирают, а причина остаётся в заявке.
+- **Строка состояния точнее всякого обещания.** Её видно в файле, её читает страж, за ней стоит
+  перечень с обязательным действием — и потому переведённая вперёд она не выдаёт себя ничем.
+- **Ход работы, живущий в рабочем дереве, не виден никому.** Владелец видит ветку без единого
+  следа того, что в ней делается, а следующий заход находит пустоту вместо «Где стоим». Это
+  второе следствие незакоммиченной папки, и оно тише первого: отказа не приходит вовсе.
+- **Шапка раскладки, оставленная в копии образца, отбивает первую же правку разбора просьбы.**
+  Отказ при этом уводит править образец пакета вместо копии под задачу.
+- **Правка по замечаниям идёт без замысла на диске.** Папка разобрана коммитом ветки раньше
+  открытия заявки, и состояния у работы с этой минуты нет: судит её история ветки.
+- **Прогон, поставленный раньше дешёвых шагов, съел окно захода.** Потративший его на прогон
+  упирался в порог заполнения на четырёх строках привязки — то есть на работе минут на пять.
+- **Граница состояния выглядит законченным куском лучше всякой вехи.** Владельцу отчёт о взятой
+  задаче неотличим от остановки: названы номер, ветка и колонка, и всё названное правда.
 - **Заявка на чужом языке.** В дереве, где заявки пишутся на другом языке, чужой заголовок
   дважды уехал на хостинг, и оба раза до него добрались глазами.
 - **Вопрос, утонувший в отчёте.** Владелец трижды переспрашивал, почему работа стоит, и каждый
   круг стоил захода обоим.
 - **Чужой эпик в списке очереди.** Дважды подряд следующей была взята первая задача чужого
   эпика — по списку она выглядела ровно как своя.
+
+- **Некоммиченная папка задачи отказывает там, где чинить уже нечего.** Гард спрашивает её с
+  диска, поэтому все правки проходят без единого отказа, а признак отданной работы берётся из
+  истории ветки. Отказ приходит на открытии заявки — в минуту, когда папка разобрана своими
+  руками: замысел снят, и собирать его приходится заново по памяти. Владелец при этом всю
+  работу видит ветку без единого следа того, что в ней делается, а следующий заход находит
+  пустоту вместо «Где стоим».
+- **Прогон, поставленный первым шагом закрытия, съедает окно захода.** Он стоит дороже всех
+  остальных шагов вместе, и потративший его на прогон упирался в порог заполнения на четырёх
+  строках привязки — то есть на работе, которая стоила бы минуты, если бы шла первой.

package/assets/pitfalls/turn-conduct.md

@@ -31,3 +31,17 @@
 - **Почему гард ожидания читает ход, а не хостинг.** Спросить хостинг было бы точнее, но сетевой
   вызов на завершении хода падает вместе со связью и отбивал бы работу вместо промаха, а вывод
   команды о прогоне в записи хода уже лежит.
+- **Шаг, снятый из списка необратимых разбором прошлого промаха, обратно доводом не
+  возвращается.** Довод, которым его туда возвращают, уже разобран и отклонён: дважды подряд
+  готовая работа вставала перед снятым шагом, и со стороны это выглядело осторожностью.
+- **Признак работы у стража знает первое слово команды.** Читающая подкоманда совпадала с ним
+  наравне с коммитом, и ход из одной разведки читался полным и заходом, и владельцем.
+- **Незапушенная ветка, неотмеченная запись груза и незакрытая колонка чужими шагами не
+  бывают.** «Куда едет ветка, которую я сам завёл» — не тот вопрос, на который отвечает владелец.
+- **Положение эпика пересказом по памяти не показывается.** Задачу закрывает слияние, которое
+  делает владелец, и вчерашнее состояние очереди врёт про уже влитое: таблица собирается заново
+  тем ходом, которым её показывают.
+
+- **Замер, разбитый на уведомления по шагам, съедает ходы вхолостую.** Каждый его шаг назначает
+  себе ход, а наполнить ход нечем: дерево под идущей серией трогать нельзя, и остаётся пересказ
+  того, что придёт следующей строкой. Одно ожидание, кончающееся вместе с замером, стоит один ход.

package/assets/rules/browser-verification.md

@@ -71,6 +71,16 @@ flowchart TD
   сессии, не держится: после паузы следующий вызов открывает вкладку в другом профиле молча.
 - **Профиль не выбирается из списка и не спрашивается у владельца.** Список отдаёт неустойчивые
   имена, которые не опознают ничего, а выбор из него ведёт на профиль без входа.
+- **Ненастроенная стража — повод остановиться, а не разрешение ехать.** Пропуск гарда при
+  молчащем помощнике сделан затем, чтобы сломанная обвязка не заводила работу в тупик, и
+  разрешением работать мимо профиля не является. Исполнитель, получивший от помощника пустой
+  вывод, называет это владельцу и браузер не водит: вкладка откроется в том профиле, который
+  расширение сочло активным, а какой это профиль — не знает никто.
+- **Экран, закрытый входом, проверяется стендом с подменённым ответом входа, а не живой учётной
+  записью.** Приложение получает вход тем же путём, что у человека, — формой, — а отвечает на неё
+  стенд; признак, которым закрыт экран, приходит подменённым профилем. Просьба к человеку сделать
+  шаг проверки — набрать пароль, открыть вкладку, нажать кнопку — означает неверно выбранный
+  путь, а не нехватку прав у исполнителя.
 - **Замер делается на самом длинном значении, а не на образцовом.** Наезд, вылезание за край и
   обрезка без признака видны только там, где содержимое в своё место не влезает; на коротком
   значении всё три выглядят исправными. Значение для замера берётся предельное — то, какое узел
@@ -93,6 +103,13 @@ flowchart TD
   замеряются те же вычисленные значения, а выдумывается только содержимое строки. Обходом было
   бы измерить чужой экран и назвать это замером нужного.
 
+- **Замер, который придётся повторять, снимает сквозная спека, а не драйвер.** Ширина окна,
+  положение узла и уход содержимого вбок читаются в ней теми же вычисленными значениями, вьюпорт
+  задаётся на весь набор, и число сходится при каждом прогоне — а замер руками живёт один заход
+  и уходит вместе с ним. Драйвер остаётся там, где смотрят на незнакомый экран: он отвечает на
+  «что тут происходит», а не подтверждает известное число. Вывод «замер снять нечем», сделанный
+  на закрытом входе, чаще всего означает, что искали не тем.
+
 Вывод о вёрстке подкрепляется числом: «выглядит нормально» результатом проверки не является.
 Этого не стережёт ничто — как измерять, разобрано в паттерне `browser-verification-measure`.
 
@@ -121,6 +138,21 @@ flowchart TD
   процесса, снятый разбором порта; им и останавливают, поштучно. Обратный промах тот же по
   природе — оболочка запускает процесс под именем, которого в шаблоне нет, и снятие не попадает
   ни во что.
+- **Снятие процесса бывает отбито, и тогда стенд поднимается рядом, а не вместо.** Отбить его
+  может среда исполнения — и по своему же стенду прошлого захода; ни разрешение на команду, ни
+  переформулировка тут не помогают. Ход отсюда один: свободный порт для нового стенда, а список
+  оставленного называется владельцу в конце захода — снять их может только он. Не названные так,
+  стенды копятся заходами и держат соединения к хранилищу.
+- **Замер снимает и сквозная спека, а не только драйвер браузера.** Ширина окна, положение узла
+  и уход документа вбок читаются в ней теми же вычисленными значениями, вьюпорт задаётся на набор
+  тестов, а результат повторяется при каждом прогоне — в отличие от замера руками, который живёт
+  ровно один заход. Драйвер остаётся там, где смотрят на незнакомый экран, а не подтверждают
+  известное число.
+- **Утверждение о прод-сборке делается по самой сборке, а не по ветке.** Между веткой и тем, что
+  отдано читателю, стоит сборка образа: она подставляет значения окружения, вырезает
+  неиспользованное и переименовывает символы. Сказанное «в сборке лежит вот это» проверяется
+  поиском по отданному файлу — тем более когда речь идёт как раз о значении, которое сборка и
+  подставляет.
 - Инкрементальная сборка протухает поштучно: разметка бывает уже новая, а клиентский чанк — от
   компиляции до правки. Признак дев-сборки — имена бандла без хеша (`main.js`). Расхождение
   между `curl` и страницей после гидратации — повод пересобрать, а не искать дефект в коде.
@@ -129,6 +161,13 @@ flowchart TD
   только пакеты из `node_modules`, кода репозитория там нет вовсе. Вывод «дефекта нет, это
   кэш» закрывает разбор, поэтому принимается только после проверки на чистой сборке — три
   круга ушло на застрявшую панель ленты событий, пока дефект лежал в снятии аутлета.
+- **Кэширующий шаг сборки без объявленных выходов отдаёт прошлое молча.** Попадание в кэш при
+  этом происходит, а восстанавливать нечего: сборщик не запускается, и в каталоге сборки
+  остаётся то, что лежало от прошлого раза. Стенд поднимает эту сборку, и приложение ведёт себя
+  как код, которого в дереве нет. Ловушка выше — про другой кэш: тот объясняет расхождение, этот
+  его создаёт, и вывод сборщика при нём зелёный. Прежде чем искать дефект в экране, у шага
+  сборки спрашивают объявленные выходы; проверяется это сносом каталога сборки и повторным
+  вызовом — после попадания в кэш он обязан восстановиться.
 - Сообщение `Angular debugging APIs are not available` в консоли принадлежит расширению
   Chrome, а не приложению: прод-сборка не публикует `window.ng`. Лечить правкой кода не надо —
   `window.ng` в проде это карта внутренностей в руках любого, кто откроет консоль.

package/assets/rules/deploy-flow.azure.md

@@ -97,6 +97,14 @@ flowchart TD
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
 
+- **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
+  негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан
+  адрес, служба не отвечает, — и каждый такой выход отдаёт ноль своей строкой. Второе —
+  недостающий пакет, пустое имя в настройке, непредвиденное исключение — отдаёт ненулевой код и
+  говорит, что сломалась сама проверка, а не предмет. Общий ноль на оба делает сломанную проверку
+  неотличимой от сошедшейся: сверка схемы с миграциями простояла так в наборе гейта, не сверяя
+  ничего, и прятала за своим нулём сразу три причины.
+
 ## Чего из закона здесь нет
 
 Состояние прода машине не видно: сверка очереди работ спрашивает последний прогон главной

package/assets/rules/deploy-flow.github.md

@@ -66,6 +66,16 @@ flowchart TD
   составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
   идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
   умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
+- **Состав прода поднимается на своей машине до слияния, а не после.** Собранный образ говорит
+  только о том, что сборка прошла: шаг наката, вход в хранилище, порядок подъёма и то, что
+  каждому контейнеру хватает положенного внутрь, видны одним запуском состава. На своей машине
+  это стоит одной команды, а на узле стоит выкатки, которую уже не отменить, — отказ наката
+  вылезает логом контейнера на узле.
+
+- **Образ несёт все файлы, которые читают его собственные шаги запуска.** Схема хранилища,
+  настройка клиента, шаблон окружения — всё, что лежит рядом в репозитории, внутрь образа само
+  не попадает, а сборка отвечает только на вопрос, собрался ли он. Отказ приходит на первом
+  подъёме, то есть уже на выкаченном.
 - **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
   от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
 - **Убирает за собой и та машина, которая образы собирает.** Отбор у обеих один — своё имя
@@ -105,6 +115,14 @@ flowchart TD
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
 
+- **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
+  негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан
+  адрес, служба не отвечает, — и каждый такой выход отдаёт ноль своей строкой. Второе —
+  недостающий пакет, пустое имя в настройке, непредвиденное исключение — отдаёт ненулевой код и
+  говорит, что сломалась сама проверка, а не предмет. Общий ноль на оба делает сломанную проверку
+  неотличимой от сошедшейся: сверка схемы с миграциями простояла так в наборе гейта, не сверяя
+  ничего, и прятала за своим нулём сразу три причины.
+
 ## Чего из закона здесь нет
 
 Состояние прода машине не видно: сверка очереди работ спрашивает последний прогон главной

package/assets/rules/deploy-flow.gitlab.md

@@ -99,6 +99,14 @@ flowchart TD
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
 
+- **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
+  негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан
+  адрес, служба не отвечает, — и каждый такой выход отдаёт ноль своей строкой. Второе —
+  недостающий пакет, пустое имя в настройке, непредвиденное исключение — отдаёт ненулевой код и
+  говорит, что сломалась сама проверка, а не предмет. Общий ноль на оба делает сломанную проверку
+  неотличимой от сошедшейся: сверка схемы с миграциями простояла так в наборе гейта, не сверяя
+  ничего, и прятала за своим нулём сразу три причины.
+
 ## Чего из закона здесь нет
 
 Состояние прода машине не видно: сверка очереди работ спрашивает последний прогон главной

package/assets/rules/doc-style.md

@@ -87,6 +87,20 @@ flowchart TD
   расходится снова через сутки.
   <!-- rt-when: *.md -->
 
+- **Указатель заводится каталогу, который читают по нему, а не обходом.** Каталог, где имя файла
+  собрано из номера задачи и имени ветки, ищется своим именем, и перечень отвечает на один
+  вопрос — какие записи здесь лежат, — на который отвечает обход. Цена у него при этом полная:
+  строку в конец дописывает каждая закрытая работа, и каждая ветка получает от хостинга метку
+  конфликта. Список каталогов со сверкой указателя объявляет дерево, и пустой список — законное
+  его состояние.
+
+- **Запись указателя называется именем файла в обратных кавычках.** Сверка полноты читает
+  первое такое имя в строке таблицы и другой формы не знает: строка, где запись названа одной
+  ссылкой с заголовком, для неё пуста — записи в ней нет, и о недостающих она молчит. Читателю
+  при этом видно всё, и промах держится ровно поэтому. Ссылка с заголовком законна и ставится
+  в той же строке при имени.
+  <!-- rt-when: *.md -->
+
 - **Имя, названное затем, чтобы сказать «его нет», стоит в списке исключений поимённо.**
   Отличить такое упоминание от ссылки машине нечем, а текст без него теряет смысл: правило и
   замысел предупреждают именно о снятом. Туда же — то, что появляется только после сборки,

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

@@ -155,6 +155,11 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Причина исключения, называющая задачу, судится на живость этой задачи.** Отсрочка со сроком
+  и отсрочка без срока выглядят одинаково, пока номер никто не спросил; мёртвый номер в причине
+  делает исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что
+  состояние задачи у гарда поставки: есть чем спросить — спрашивает, нет сети или доступа —
+  пропускает молча.
 - **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
   в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
   работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится