@rt-tools/agent-kit 0.16.1 → 0.18.0

package/assets/pitfalls/agent-kit.md

@@ -26,6 +26,10 @@
   надстройка, которую она закрыла, не сопоставляются ничем, и надстройка остаётся замещать уже
   исправленный раздел.
 
+  Скопированная пакетная строка правится в источнике пакета, а не в копии: правка внутри
+  надстройки расходится с исходником молча, и видно её только там, где сам текст служит ключом
+  связи — в статье, у которой есть привязка. Перед правкой строки в надстройке она ищется в
+  источнике; не нашлась — строка своя, и правится на месте.
 - **Готовый код пакета не называет имён одного дерева.** Префикс директив кита, ключи подписей
   и имена сущностей принадлежат тому дереву, где паттерн писали; разложенные в соседнем, они
   учат звать то, чего там нет вовсе. Имя директивы при этом отличается от имени в примере: по
@@ -42,9 +46,12 @@
   отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
   зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала
   использование, потом импорт».
-- **Прогонять сценарии гардов можно, ничего не раскладывая.** Обвязка набора принимает каталог
-  гардов переменной, и пакетную редакцию гоняют по сценариям дерева до установки. Заход,
-  потраченный на диагноз по последствиям, стоил ровно этой строки.
+- **Прогонять сценарии гардов можно, ничего не раскладывая, — там, где эти сценарии есть.**
+  Обвязка набора принимает каталог гардов переменной, и пакетную редакцию гоняют до установки.
+  Живёт она в репозитории самого пакета: в поставку едут ресурсы, строка запуска и библиотека, а
+  каталога сценариев в ней нет вовсе. Дереву-потребителю остаются свои сценарии на свои гарды —
+  искать у себя пакетные значит потратить заход на диагноз по последствиям, ровно тот, от
+  которого совет обещал избавить.
 - **Отбитая правка не всегда про текст гарда.** Гард зовут по пути, и файл без права на
   запуск отвечает отказом доступа — ненулевым кодом, который читается как «правка отбита».
   Набор при этом отбивает подряд всё, включая сборку и тесты, и причины не называет.
@@ -78,3 +85,64 @@
   ровно так же, как с кодом дерева: запись в файл вне репозитория была отбита гардом хода
   работы с требованием замысла, к ней не относящегося. Путь в профиле сначала приводится к
   корню дерева, и всё, что вне корня, признака не получает.
+- **Похожесть текстов ближайшую статью не находит.** Замер показал, что законное соседство двух
+  статей одного правила и законный перенос удачной статьи на соседнее место дают одно и то же
+  число: цитата поэтому ищется точным совпадением, а не мерой похожести.
+- **Отметка об отправке живёт в рабочем дереве, а дерево у каждой ветки своё.** Поставленная в
+  одной ветке, в соседней она не видна, и тот же текст уезжает вторым разом; второй записью он
+  при этом не становится — приём отбирает уже приехавшее по признаку предложения, и его ответ
+  говорит, сколько записей легло и сколько уже лежало. Строка «принято 0, уже лежало 3» означает,
+  что нового не уехало ничего.
+- **Отметка, поставленная только на принятое, объявила бы неотправленным то, что дошло раньше.**
+  Файл остался бы без неё навсегда: принятым он больше не станет никогда, а гард предложений
+  отбивал бы ход у каждого следующего захода. Отправителю разница между принятым и уже лежавшим
+  ничего не меняет — оба исхода значат одно: груз доехал.
+- **Отказ отправки, называющий один лишь ключ конфига, уводит читателя не туда.** Ни адреса, ни
+  токена в конфиге нет и не будет: оба приходят от владельца приёма — адрес словом, токен
+  одноразовым кодом приглашения. Отказ поэтому называет приглашение, а не ключ: ушедший править
+  конфиг ответа там не находит и второй раз спрашивает уже владельца.
+- **Редакция пакета, поднятая без раскладки, запирает дерево целиком.** Красит она не свою
+  ветку, а главную: сверка раскладки стоит в гейте пуша, и на ней отбивается чужая работа, пакета
+  не касающаяся вовсе. Своей веткой такой автор починить это не может — правка лежит в чужой.
+- **Правка разложенного файла без гарда на месте всплывает в чужой ветке.** Знал о ней один
+  `sync --check`, а говорил он на следующей раскладке: отказ приходил тому, кто в этот день
+  правил соседний ресурс, и выглядел поломкой его работы.
+
+## Подъём версии: чем сверять замещённые разделы
+
+Замерено на двух подъёмах подряд: в одном шесть замещённых разделов недосчитались новых
+утверждений, в другом два раздела — одиннадцати статей, и ни одна команда об этом не сказала.
+Прежняя редакция при этом нашлась случайной копией в чужом рабочем дереве: установка стирает её
+без следа, поэтому снимок и стоит первым шагом подъёма.
+
+Сверяются статьи, а не заголовки — заголовок как раз и совпал, этим раздел замещён:
+
+```bash
+sec() { awk -v s="$2" '$0 ~ "^## "s {f=1;next} /^## /{f=0} f' "$1" \
+    | grep '^- \*\*' | sed 's/^- \*\*//;s/\*\*.*//'; }
+comm -13 <(sec "$OLD/<ресурс>" '<заголовок>' | sort) <(sec "$NEW/<ресурс>" '<заголовок>' | sort)
+```
+
+Строка в выводе — статья, которую надстройка проглотила: пакет её дописал, а дерево не увидело.
+Переносится она в надстройку руками.
+
+## Выключенная роль: что бывает с настройкой
+
+- **Настройка, которую не прочитать, роль не выключает.** Не нашлось `jq`, нет настройки, в
+  настройке сломан разбор — гард судит, как судил. Обратный выбор гасил бы слой правил молча, и
+  заметить это было бы нечем.
+- **Ключ, написанный не списком, ловит раскладка, а не гард.** Гарду виден только список имён:
+  строка вместо списка читается им как «роль включена», и роль работает, хотя дерево считает её
+  выключенной. Отказывает на этом разбор настройки — первой же раскладкой, называя ключ.
+- **Выключение живёт в настройке дерева, а не в настройке агента.** Строка, вырезанная из
+  настроек агента руками, теряется на первой же правке того файла, и вернуть роль будет нечем.
+  Здесь оно объявлено в одном месте и видно всякому, кто читает настройку дерева.
+
+## Свойства дерева: две границы
+
+- **`only` сильнее требования.** Ресурс, названный поимённо, ложится и при неотвеченном
+  требовании; перечень раскладки называет это вслух, а отказ по его пустому компаньону зовёт
+  снять ресурс, а не заполнять черновик.
+- **Свойство, которого пакет не объявлял, роняет раскладку** — что в `has` дерева, что в имени
+  ресурса. Объявлены свойства перечнем при пакете, рядом с осями различия.
+

package/assets/pitfalls/doc-style.md

@@ -7,6 +7,11 @@
 
 ## Ловушки
 
+- **Отступление от просьбы называется в том же докладе, где показан результат.** Сделанное не
+  тем способом, о котором просили, отличается от сделанного просимым способом даже при совпавшем
+  ответе, и разницу называет исполнитель — одной строкой «сделал не тем, чем сказано, вот чем и
+  вот почему». Умолчание держится ровно до того, как просьбу приходится повторять, а платит за
+  него доверие ко всему докладу.
 - **Оставшаяся работа не записывается в документ, а заводится задачей.** `docs/BACKLOG.md`
   держит только то, что задачей не бывает: договорённости и решения, которые решено не
   править. Признак — утверждение остаётся, если править его никто не собирается. «Сделать
@@ -83,3 +88,13 @@
   строки. Отличить это от применённой правки по коду возврата нечем — видно только по самому
   файлу, и обычно позже, по заголовкам собранного текста. Текст правится инструментом правки; а
   если замену всё же зовут, место, которое она обещала изменить, перечитывают сразу после неё.
+- **Число, полученное командой, замером ещё не является.** Требование пересчитывать число
+  командой соблюдается буквально — команда была, — а мерила ли она предмет числа, не спрашивает
+  никто. Вывод бывает ложным по-разному и молча: `grep -E` с границей слова `\b` на BSD часть
+  образца игнорирует и об этом не сообщает («278 вхождений» оказались 79, и двенадцать из них о
+  другом), регулярка не видит, где кончается блок, и приписывает найденное соседу, а память
+  возвращает число, не помня его происхождения, — от замера оно неотличимо. Число пишется той
+  командой, которая мерит его предмет, и тем же ходом, каким пишется текст.
+- **Границу слова спрашивают у той команды, которая её знает.** `grep -w`, `rg` и `python3` с
+  `re` её реализуют, BSD `grep -E` — нет; проверка стоит одной команды и делается до того, как
+  число уедет в текст.

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

@@ -7,6 +7,21 @@
 
 ## Ловушки
 
+- **Непосчитанная сливаемость конфликтом не бывает.** Хостинг считает её заново после каждой
+  правки главной ветки и до конца счёта отвечает неопределённостью. Прочитанная как конфликт,
+  она отбивает работу на каждой свежей вершине — то есть ровно там, где отбивать нечего.
+  Поэтому и гард, и сверка судят только прямое «конфликтует», а молчание опроса пропускают.
+- **Силовая отправка ветки, стоящей под другой в стопке, закрывает её заявку как слитую.**
+  Хостинг считает заявку слитой, когда вершина её ветки достижима из базы; состояние лживое — в
+  главной ветке правки нет, а задача остаётся открытой. Требование, из которого это следует, —
+  статья правила о том, что нижняя ветка череды историю не переписывает.
+- **Ветка, догнанная в рабочем дереве и не отправленная, работой не считается.** Человек видит
+  прежнее состояние и читает его как «не сделано ничего», а сделанное лежит там, где его не
+  видит никто. Про неотправленный разрешённый конфликт статья правила это говорит, но догнанная
+  ветка без единого спора под неё не подпадает вовсе.
+- **`UNKNOWN` в поле сливаемости означает «ещё не посчитано», а не «конфликтов нет».** Хостинг
+  считает её после каждого чужого слияния, и заявка, прочитанная в эту секунду, выглядит
+  здоровой.
 - **Одна работа — одна задача, сколько бы файлов она ни задела.** Числа, за которым правка
   становится второй задачей, здесь нет: делится то, что придётся откатывать порознь. Сплошная
   правка текстов дерева была заведена тремя задачами «по объёму» — пришлось стирать две,
@@ -97,8 +112,57 @@
 Сюда уехали случаи, числа и отвергнутые лекарства, стоявшие прежде при статьях правила. Ни одно
 решение по правке на них не стоит: они нужны тому, кто разбирает промах или спорит с гардом.
 
+- **Отказ на слиянии остаётся вторым рубежом.** Человек вливает, как только видит зелёное, и до
+  второго рубежа дело просто не доходит.
+
+- **Список, в котором всё серое, читается как «работа не сделана».** Черновик и недоделанное
+  выглядят одинаково; находит такие заявки сверка — ночью, в чужой сессии, после закрытого
+  разговора.
+- **Логин рядом со служебным числом не сверяет никто.** Промах в почте изнутри не виден вовсе:
+  коммит выглядит своим, а подписан посторонним.
+
+- **Ключ задач, разошедшийся с формой ветки в профиле.** Они не отказывают, а перестают узнавать
+  номер: проверка, искавшая работу без задачи, пропускает всё подряд.
+- **Сложение у указателя зовут не ради спора, а ради тишины.** Без объявления человека зовут при
+  каждом слиянии — по строке, которая нужна целиком с обеих сторон.
+
+- **Гейт — обещание, что пуш не приедет красным.** Набор без сборки и снимков обещает то, чего не
+  проверяет.
+- **Борда показывает, что сделано и что осталось.** Заявка отвечает на другой вопрос и
+  связывается с карточкой сама — отдельной карточки ей не нужно.
+
+- **Сливаемость выводили из локального вливания.** Между ним и взглядом владельца главная уходит
+  вперёд, и «у меня слилось» о кнопке не говорит ничего. Дерево, чей помощник очереди о поле
+  `mergeable` не говорит вовсе, работает как прежде: поля нет — требования нет.
+- **Личность вызова, открывающего заявку.** Дерево, не назвавшее машинной записи, требования
+  подстановки токена не получает: сверять ответ хостинга не с чем.
+
+- **Ветки, заведённые от главной подряд, роняют друг друга.** Замер по ста шести накопленным
+  веткам одного основания: вливание одной делает расходящимися до двадцати трёх, в среднем семь с
+  половиной; не расходятся ни с кем двенадцать. Считался он `git merge-tree` в памяти — рабочего
+  дерева замер не трогает и веток не двигает.
+
+    ```bash
+    # проба слияния без единой правки в дереве: коммит-слияние заводится в объектной базе
+    tree="$(git merge-tree --write-tree origin/main <ветка> | head -1)"
+    probe="$(git commit-tree "$tree" -p origin/main -p <ветка> -m проба)"
+    git merge-tree --write-tree "$probe" <другая ветка> >/dev/null; echo $?   # 1 — разойдутся
+    ```
+
+    Дерево аргументом сюда не годится: истории у него нет, общее основание не считается, и любая
+    проба отвечает «сойдётся».
+
+- **Расходится не правка, а строка, куда дописали обе стороны.** В том же замере исходник
+  ресурса сливался чисто, а его разложенная копия расходилась первой строкой — той, где стоит
+  контрольная сумма ресурса. Две работы правили разные разделы разных файлов, и всё равно
+  требовали разбора. Отсюда и правило ветвиться чередой: снимать пришлось бы не расхождение, а
+  сам способ хранить копию рядом с исходником.
+
 - **Сборка входит в набор гейта.** Четыре мержа подряд уехали в главную ветку, ломая выкатку:
   ошибка типов в непокрытом коде пережила линт и юниты и всплыла на сборке образа.
+- **Набор, переписанный строками, выглядит полным.** В одном дереве шесть проверок лежали рядом
+  с гоняемыми и не гонялись ни гейтом, ни конвейером: восемь строк из четырнадцати читались как
+  весь набор, и разница была видна только сличением с умолчанием пакета.
 - **Набор гейта не бывает уже набора конвейера.** Дважды подряд правка, прошедшая гейт целиком,
   была отбита конвейером — и оба раза зелёный гейт был прочитан как «локально всё зелено». Отсюда
   и требование отбивать пуш на шаге без строки в наборе, а не печатать предупреждение рядом.
@@ -110,6 +174,12 @@
   в шести ветках за один заход. Обещать по объявлению «конфликтов больше не будет» нельзя: не
   будет ручной работы, а вливать главную в открытые ветки после каждого слияния придётся
   по-прежнему.
+- **Заведённое видно только заводящему.** Шестнадцать задач так были заведены дважды, а заявка
+  названа владельцу номером, которого для него не существовало: ограниченная запись видела своё,
+  а хостинг отвечал остальным «не найдено».
+- **Обойдённый отказ унёс признак ограничения.** Предел запросов у ограниченной записи стоял на
+  нуле — не исчерпан, а не положен вовсе. Отказ обошли вызовом другого рода, обход сработал, и
+  расхождение всплыло через двадцать минут и четыре следа, которые пришлось переписывать.
 - **Личность вызова, открывающего заявку.** Прежде обе стороны — подстановка токена и ответ
   хостинга об авторе — держались статьёй и разбором происшествия, и промах повторился на третий
   день.
@@ -131,3 +201,21 @@
   дали, а запрос разбора на автора хостинг принимает молча и не создаёт.
 - **Ревьюверы спрашиваются вызовом REST.** Под токеном машинной записи выборка клиента падает
   целиком, без токена проходит зелёной — отличить «сошлось» от «спросить было нечем» нечем.
+
+- **Полнота набора гейта судится по именам шагов конвейера.** Проверки, которой нет и в
+  конвейере, там нет тоже: набор, переписанный строками вместо вызова умолчания пакета, теряет
+  ровно те проверки, которые пакет заведёт следующей редакцией. Своя строка вместо умолчания
+  законна там, где она покрывает то же строже либо зовёт названный скрипт.
+- **Черновик, чья ветка везёт папку задачи, означает идущую работу, а не брошенную.** Оба
+  признака нужны вместе: зелёный прогон на вершине без разобранной папки говорит, что работа
+  ещё не отдана. Дерево, не назвавшее машинной записи, этой сверки не получает вовсе.
+- **Метку сливаемости не гасит и объявленное сложение обеих сторон.** Хостинг считает сложение
+  своим приёмом и настроек слияния не читает: пока ветка не вобрала главную и это не уехало на
+  хостинг, заявка стоит конфликтующей при разрешённом на месте расхождении.
+- **Сверки раскладки нет в конвейере, поэтому шага, который она бы закрывала, там тоже нет.**
+  Правка мимо источника в день, когда её делают, не ломает ничего.
+- **Рабочее дерево не опустошается ради прогона инструмента.** Вопрос «этот долг был до моих
+  правок или от них» решается второй копией дерева, а не прятаньем работы: спрятанного не видит
+  ни статус, ни сверка, а команда, прошедшая между прятаньем и возвратом, пишет в те же файлы —
+  и возврат встаёт конфликтом. Так ушли в прятанье восемь незакоммиченных файлов при живом
+  запрете на эту команду: запрет читался в начале захода, а команда набиралась через сорок ходов.

package/assets/pitfalls/spec-driven.md

@@ -34,3 +34,25 @@
   его привязка перестают находиться друг по другу. После разрешения гоняется
   `npm run check:specs` — конфликт в спеке кода не задевает, и ни сборка, ни линтеры его не
   увидят.
+
+- **Строку требования к соседнему ресурсу не проверяет ничто, и расхождение видно только
+  счётом.** Правило без неё выглядит целым: разделы на месте, привязки сходятся, сверка
+  полноты зелёная. Требовать её у всех нельзя — правило, которому нечего требовать, её не
+  пишет, — поэтому судит не проверка, а два числа рядом: сколько правил в каталоге и сколько из
+  них требование объявило.
+
+    ```bash
+    ls <каталог правил> | wc -l
+    grep -rl '^\*\*Требует:\*\*' <каталог правил> | wc -l
+    ```
+
+    Расхождение отказом само по себе не бывает. Оно называет, сколько правил прочитать глазами,
+    и число это падает по мере того, как их читают. Счёт при этом грубый: строка, показанная
+    образцом внутри ограды, считается наравне с настоящей — тот, кто учит её писать, попадает
+    в число объявивших.
+- **Привязка пишется по тексту статьи, а не по смыслу имени гарда.** Гард, чьё имя звучит про то
+  же самое, статью не закрывает: статья перечисляла шесть действий по отдельному слову владельца
+  — коммит, пуш, открытие заявки, запись в вики, заведение задачи, правка закона, — а
+  поставленный ей гард не держит ни одного из них и отправки предложения среди перечисленного
+  нет вовсе. Читается текст статьи целиком, и в привязке называется то место, которое держит
+  названное ею, а не соседнее по смыслу.

package/assets/pitfalls/task-flow.md

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

package/assets/pitfalls/testing.md

@@ -7,6 +7,12 @@
 
 ## Ловушки
 
+- **Зелёный тест чистой функции молчит о ряде, которого рабочий путь не порождает.** Функция
+  верна на том, что ей подали, а подаёт ей ввод сам тест: ряд, собранный ради удобства
+  проверки, доказывает поведение на случае, которого в работе не бывает. Так стояли два зелёных
+  теста решения об оповещении, а предохранитель, ради которого решение писали, не сработал ни
+  разу. Форма ввода берётся с той границы, откуда решение зовут, — у процедуры, у службы, у
+  обработчика, — и сверяется с ней, а не выдумывается рядом с проверкой.
 - **Зелёный `nx test <проект>` не значит, что хоть один файл исполнялся.** Либа без своего
   `vitest.config.mts` не запускает ничего — так тесты домена броней не запускались ни разу.
   Либа с конфигом, но без единого `*.spec.ts`, проходит зелёной из-за `passWithNoTests: true`,

package/assets/pitfalls/turn-conduct.md

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

package/assets/rules/browser-verification.md

@@ -67,10 +67,25 @@ flowchart TD
   идентификатору процесса, а не по имени команды — у обоих экземпляров оно одно.
 - **Браузер водится одним драйвером на закреплённом профиле.** Остальные двери — второй
   драйвер, `open`, `osascript`, запуск бинарника — закреплённый профиль не спрашивают вовсе.
+- **Браузер, поднятый библиотекой изнутри скрипта, — та же дверь, что и запуск бинарника.** В
+  строке команды её не видно вовсе: там стоят имя интерпретатора и путь файла, а вождение лежит
+  внутри самого файла. Поэтому судится содержимое запускаемого файла и код, переданный доводом
+  вместо файла; правило, судившее одну командную строку, обещало больше, чем проверяло, и
+  профиль обошли этой дверью дважды за один заход.
 - **Выбор браузера протухает и требует повторного вызова.** Выбор, сделанный в начале
   сессии, не держится: после паузы следующий вызов открывает вкладку в другом профиле молча.
 - **Профиль не выбирается из списка и не спрашивается у владельца.** Список отдаёт неустойчивые
   имена, которые не опознают ничего, а выбор из него ведёт на профиль без входа.
+- **Ненастроенная стража — повод остановиться, а не разрешение ехать.** Пропуск гарда при
+  молчащем помощнике сделан затем, чтобы сломанная обвязка не заводила работу в тупик, и
+  разрешением работать мимо профиля не является. Исполнитель, получивший от помощника пустой
+  вывод, называет это владельцу и браузер не водит: вкладка откроется в том профиле, который
+  расширение сочло активным, а какой это профиль — не знает никто.
+- **Экран, закрытый входом, проверяется стендом с подменённым ответом входа, а не живой учётной
+  записью.** Приложение получает вход тем же путём, что у человека, — формой, — а отвечает на неё
+  стенд; признак, которым закрыт экран, приходит подменённым профилем. Просьба к человеку сделать
+  шаг проверки — набрать пароль, открыть вкладку, нажать кнопку — означает неверно выбранный
+  путь, а не нехватку прав у исполнителя.
 - **Замер делается на самом длинном значении, а не на образцовом.** Наезд, вылезание за край и
   обрезка без признака видны только там, где содержимое в своё место не влезает; на коротком
   значении всё три выглядят исправными. Значение для замера берётся предельное — то, какое узел
@@ -93,6 +108,13 @@ flowchart TD
   замеряются те же вычисленные значения, а выдумывается только содержимое строки. Обходом было
   бы измерить чужой экран и назвать это замером нужного.
 
+- **Замер, который придётся повторять, снимает сквозная спека, а не драйвер.** Ширина окна,
+  положение узла и уход содержимого вбок читаются в ней теми же вычисленными значениями, вьюпорт
+  задаётся на весь набор, и число сходится при каждом прогоне — а замер руками живёт один заход
+  и уходит вместе с ним. Драйвер остаётся там, где смотрят на незнакомый экран: он отвечает на
+  «что тут происходит», а не подтверждает известное число. Вывод «замер снять нечем», сделанный
+  на закрытом входе, чаще всего означает, что искали не тем.
+
 Вывод о вёрстке подкрепляется числом: «выглядит нормально» результатом проверки не является.
 Этого не стережёт ничто — как измерять, разобрано в паттерне `browser-verification-measure`.
 
@@ -121,6 +143,21 @@ flowchart TD
   процесса, снятый разбором порта; им и останавливают, поштучно. Обратный промах тот же по
   природе — оболочка запускает процесс под именем, которого в шаблоне нет, и снятие не попадает
   ни во что.
+- **Снятие процесса бывает отбито, и тогда стенд поднимается рядом, а не вместо.** Отбить его
+  может среда исполнения — и по своему же стенду прошлого захода; ни разрешение на команду, ни
+  переформулировка тут не помогают. Ход отсюда один: свободный порт для нового стенда, а список
+  оставленного называется владельцу в конце захода — снять их может только он. Не названные так,
+  стенды копятся заходами и держат соединения к хранилищу.
+- **Замер снимает и сквозная спека, а не только драйвер браузера.** Ширина окна, положение узла
+  и уход документа вбок читаются в ней теми же вычисленными значениями, вьюпорт задаётся на набор
+  тестов, а результат повторяется при каждом прогоне — в отличие от замера руками, который живёт
+  ровно один заход. Драйвер остаётся там, где смотрят на незнакомый экран, а не подтверждают
+  известное число.
+- **Утверждение о прод-сборке делается по самой сборке, а не по ветке.** Между веткой и тем, что
+  отдано читателю, стоит сборка образа: она подставляет значения окружения, вырезает
+  неиспользованное и переименовывает символы. Сказанное «в сборке лежит вот это» проверяется
+  поиском по отданному файлу — тем более когда речь идёт как раз о значении, которое сборка и
+  подставляет.
 - Инкрементальная сборка протухает поштучно: разметка бывает уже новая, а клиентский чанк — от
   компиляции до правки. Признак дев-сборки — имена бандла без хеша (`main.js`). Расхождение
   между `curl` и страницей после гидратации — повод пересобрать, а не искать дефект в коде.
@@ -129,6 +166,13 @@ flowchart TD
   только пакеты из `node_modules`, кода репозитория там нет вовсе. Вывод «дефекта нет, это
   кэш» закрывает разбор, поэтому принимается только после проверки на чистой сборке — три
   круга ушло на застрявшую панель ленты событий, пока дефект лежал в снятии аутлета.
+- **Кэширующий шаг сборки без объявленных выходов отдаёт прошлое молча.** Попадание в кэш при
+  этом происходит, а восстанавливать нечего: сборщик не запускается, и в каталоге сборки
+  остаётся то, что лежало от прошлого раза. Стенд поднимает эту сборку, и приложение ведёт себя
+  как код, которого в дереве нет. Ловушка выше — про другой кэш: тот объясняет расхождение, этот
+  его создаёт, и вывод сборщика при нём зелёный. Прежде чем искать дефект в экране, у шага
+  сборки спрашивают объявленные выходы; проверяется это сносом каталога сборки и повторным
+  вызовом — после попадания в кэш он обязан восстановиться.
 - Сообщение `Angular debugging APIs are not available` в консоли принадлежит расширению
   Chrome, а не приложению: прод-сборка не публикует `window.ng`. Лечить правкой кода не надо —
   `window.ng` в проде это карта внутренностей в руках любого, кто откроет консоль.
@@ -146,3 +190,17 @@ flowchart TD
   проверки, не говорит про образ ничего: в составе прода она есть, а ручной прогон того же
   образа идёт без неё. Пути перечисляются до проверки, а не после того, как один из них
   сошёлся.
+- **Признак снимается с вопроса владельца, а не с предмета правки.** Отданная сервером страница
+  отвечает на «собралось ли», и на «видно ли» она не отвечает никогда: показ живёт после
+  гидратации, а картинка — после запроса к чужой службе. Признаки под второй вопрос свои —
+  `naturalWidth` у картинки больше нуля, узел показа появился на поднятой странице, — и снимаются
+  они драйвером, а не запросом к адресу.
+- **Чужой отказ службы диагнозом настройки не бывает.** `403` называет состояние проекта у
+  поставщика и молчит о том, какое значение лежит в настройке дерева; прочитанный как диагноз, он
+  уводит в починку того, что цело, — а само значение читается одной командой на своей стороне.
+  Владельцу оно тем более не заказывается: у захода оно уже есть.
+- **Прежнее поведение читается кодом той версии:** `git show <коммит до правки>:<файл>`. Тело
+  коммита называет, что правка сменила, и молчит о том, что было верно до неё; условие показа, в
+  которое дописано ещё одно обязательное значение, гасит показанное раньше и в самой правке
+  выглядит уточнением. Правка соседней задачи, выкатившаяся тем же днём, входит в проверку прода
+  наравне со своей: ветка отвечает за то, что уехало вместе с ней.