@rt-tools/agent-kit 0.17.0 → 0.19.0

package/assets/patterns/git-workflow-stack.md

@@ -11,6 +11,10 @@ description: Паттерн правила git-workflow. Брать, когда
 `docs/constitution/delivery.md`. Разбор одного конфликта — паттерн `git-workflow-merge`,
 открытие одной заявки — `git-workflow-pr`.
 
+**Вызовы здесь даны клиентом GitHub.** Дерево на другом хостинге читает их как форму, а команду
+берёт у своего клиента: имена полей и подкоманд у клиентов разные, а спрашиваемое — одно.
+Соответствие называет редакция правила поставки, разложенная в этом дереве.
+
 ## Когда брать
 
 - Из одного основания заведено больше двух веток, и все ждут слияния.
@@ -48,6 +52,13 @@ gh pr create --base <предыдущая ветка> --title '[<КЛЮЧ>-<но
 Порядок вливания стоит в теле каждой заявки строкой «стоит на #<номер>, вливать после него»:
 владелец вливает по списку, а родство веток по списку не видно.
 
+**Конвейер дерева проверяется на то, слушает ли он заявку с таким основанием.** Событие заявки
+хостинг шлёт с фильтром по базе, и дерево, оставившее в фильтре одну главную ветку, всей череде
+прогонов не даёт вовсе: заявка стоит зелёно-пустой, а вернуть событие нечем — ни новый коммит,
+ни перезакрытие заявки базы не меняют. Спрашивается это до того, как череду заводить: у
+настройки конвейера, а не у страницы заявки, где отсутствие прогона выглядит так же, как его
+ожидание.
+
 ```bash
 # порядок череды целиком — снизу вверх
 gh pr list --state open --json number,headRefName,baseRefName \
@@ -141,6 +152,25 @@ done | sort | uniq -c | sort -rn | head
 конфликт там, где подряд его бы не было. Порядок называется владельцу в теле заявки — кнопки
 нажимает он, а о родстве веток не знает.
 
+## Волна веток проверяется пробным слиянием
+
+Ветка, лежащая невлитой рядом с соседками, зелена сама по себе: линт, тесты, сборки и сверки
+она проходит одна. Сталкивается она с ними тем, чего на отдельной ветке не видит ни одна
+проверка — тот же следующий свободный номер сценария, тот же заведённый новым файл, та же
+правленная строка отметки. После слияния первые два чинятся уже в главной и стоят отдельной
+работы.
+
+```bash
+git fetch origin
+git checkout -b probe-merge origin/main
+for b in <ветка-1> <ветка-2> <ветка-3>; do git merge --no-edit "origin/$b" || break; done
+npm run check:all
+git checkout - && git branch -D probe-merge
+```
+
+Ветка пробы удаляется, а находки и порядок слияния записываются туда, где живёт замысел линии
+работ: пробное слияние отвечает на «что столкнётся», а не заменяет собой отдачу.
+
 ## Частые промахи
 
 - Открыты все заявки разом, потому что ветки были готовы. Готовность ветки признаком того, что

package/assets/patterns/lib-layers-move.md

@@ -77,6 +77,10 @@ grep -rn "@<область>/<семья>/<домен>" libs/ apps/ | sed 's/:.*/
     npx nx run-many -t lint --projects=<список по изменённым файлам>
     ```
 
+    Этот прогон — быстрый, по горячим следам переноса, и набором перед пушем он не бывает:
+    набор, собранный по изменённым файлам, пропускает то, до чего правка дошла связями. Перед
+    пушем идёт тот же набор, что гоняет конвейер, и теми же командами.
+
 ## Проверить
 
 ```bash

package/assets/patterns/spec-driven-domain.md

@@ -54,6 +54,18 @@ docs/specs/<домен>/
 такой спек по строкам бесполезно, потому что делится в нём не описание домена, а ненаписанное
 правило.
 
+**Заголовок записи раздела решений датой не называется.** Дата говорит, когда решение приняли, а
+раздел отвечает на «почему так, а не иначе»: по дате решение не отобрать и не найти, зато
+названная ею запись читается описанием прошлого и остаётся в спеке навсегда. Запись начинается с
+самого решения.
+
+**Утверждение, стоящее в другом разделе того же спека, вторым пунктом правил не заводится.**
+Устройство записи живёт в разделе данных, порядок вызовов — в разделе контракта, причина
+существования домена — в разделе «Зачем»: все три говорят о том же, о чём говорило бы правило.
+Второй экземпляр расходится с первым молча, и заметить это нечем — сверка знает пункт правила
+против якоря, а два утверждения об одном не сравнивает никто. Решение при этом из раздела решений
+уезжает целиком: место, где требование живёт, найдено.
+
 Шапка несёт статус, дату ревизии, префикс сценариев, зависимости от других доменов, строку
 `**Законы:**` — законы, которые домен применяет, — и строку `**Процедуры:**` — корни либ, чьи
 процедуры домен обслуживает.
@@ -84,7 +96,7 @@ docs/specs/<домен>/
 ```
 
 Правило, которому места в коде не нашлось, — намерение: ему место в «Открытых вопросах» как
-`Q-N`, а не формальный якорь.
+`Q-<буква закона>-<номер>`, а не формальный якорь.
 
 ## Сценарий
 

package/assets/patterns/spec-driven-rule.md

@@ -33,7 +33,10 @@ description: Паттерн правила spec-driven. Брать при зав
 вопрос есть, и стираются вместе с последним закрытым: закрытый вопрос из закона убирается, а
 не превращается в пустой раздел.
 
-Ни истории правок, ни доводов о том, почему когда-то выбрали так, в законе нет. Историю
+Даты в законе тоже нет: у одного закона из семнадцати она стояла, у остальных не появлялась
+никогда, а прочитанная как срок годности — старит верный текст, которого никто не трогал, потому
+что трогать было нечего. Ни истории правок, ни доводов о том, почему когда-то выбрали так, в
+законе нет. Историю
 держит система контроля версий, а довод с отвергнутой альтернативой — свойство работы, а не
 продукта: ему место в «Ловушках» правила под этим законом, где и путям к файлам можно.
 Утверждение, которое нельзя написать как «верно всегда», статьёй не становится вовсе.
@@ -43,8 +46,6 @@ description: Паттерн правила spec-driven. Брать при зав
 
 Как правка доезжает до работающего приложения. …
 
-**Ревизия:** 2026-08-05
-
 ## Статьи
 
 - **Выкатывается образ того коммита, который выкатывают.** Умолчание «последний» отстаёт от
@@ -98,7 +99,7 @@ description: Правило под «Закон о поставке». Брат
 ```
 
 Утверждение, которому места в коде не нашлось, в этот раздел не ставится: оно уходит прозой в
-«Ловушки» или вопросом `Q-N` в закон.
+«Ловушки» или вопросом `Q-<буква закона>-<номер>` в закон.
 
 ## Паттерн
 

package/assets/patterns/spec-driven-sweep.md

@@ -47,7 +47,7 @@ description: Паттерн правила spec-driven. Брать при спл
 тридцати шести строк расхождений не оказалось ни одной. Поэтому число находок прошлого домена на
 следующий не переносится — переносится только сам порядок проходов.
 
-## Ловушки
+## Частые промахи
 
 - **Урожайность прохода обещана фактом.** «Проход даст столько-то» — оценка, и по чужому слою она
   промахивается целиком. Разбор просьбы называет проходы, а не число находок.

package/assets/patterns/status-report-table.github.md

@@ -57,7 +57,7 @@ gh api repos/:owner/:repo/issues/<номер> --jq '{t:.title,s:.state,labels:[.
 имя команды в оболочке бывает занято чужим псевдонимом, и тогда вызов уходит в интерактивный
 вход вместо ответа.
 
-## Ловушки
+## Частые промахи
 
 - **Задача на борде читается запросом, а не подкомандой просмотра.** Подкоманда тянет за собой
   доски старого образца, хостинг отвечает отказом о них, и вызов краснеет целиком, ничего не

package/assets/patterns/task-flow-archive.md

@@ -46,7 +46,17 @@ description: Паттерн правила task-flow. Брать, когда т
 | `grill.md`      | в `docs/archive/` — ответы владельца невосстановимы, и это единственная запись о том, почему задача поставлена так |
 | `progress.md`   | в `docs/archive/`, если в нём есть решения по ходу с причинами; иначе удаляется                                    |
 | `plan.md`       | удаляется — после выкатки на его вопрос отвечает код, а на «как работает» отвечает спек домена                     |
-| находки разбора | переезжают к замыслу эпика — их читает владелец, когда эпик кончится; работа вне эпика показывает их сразу         |
+| находки разбора | пишутся сразу рядом с замыслом эпика — не переезжают отсюда; работа вне эпика показывает их владельцу тем же ходом |
+
+Находки в папке задачи не живут вовсе. Разбор идёт фоном, и когда он кончится, не знает никто:
+папка к этой минуте разобрана, а ветка бывает уже влита и снята. Оба срока назначает не
+исполнитель, поэтому переезд «из папки к замыслу эпика» держался бы на совпадении, которого может
+и не случиться. Тем же местом пользуется находка, замеченная не разбором, а по ходу работы.
+
+Находки, вернувшиеся после того, как ветка ушла, едут веткой следующей задачи: пуш в снятую ветку
+её не обновляет, а заводит заново, и коммит остаётся вне главной. Следующая задача к этой минуте
+уже взята — её веткой уборка за предыдущей и едет, тем же порядком, каким разбирают чужую папку
+задачи. Эпик кончился и следующей задачи нет — находки уезжают своей задачей.
 
 Уезжающее складывается одним файлом с говорящим именем, а не папкой из трёх:
 
@@ -187,7 +197,7 @@ npm run cargo:mark -- --state fixed \
 котором владелец сказал вслух, уходит наружу в тот же ход: написанное и не отправленное лежит в
 дереве неотличимо от отправленного.
 
-## Ловушки
+## Частые промахи
 
 - **Папку разбирают до открытия заявки — потом о ней уже никто не вспомнит.** Сверка очереди
   считает задачу закрытой по слиянию: после него за папку никто не отвечает — работа перешла к

package/assets/patterns/task-flow-close.md

@@ -258,33 +258,40 @@ PR #<номер> готов к слиянию: прогон зелёный, че
 ветки. Что именно чинится, берётся из замечания, а не из замысла.
 
 Главная ветка, влитая ради того, чтобы что-то посмотреть, — такая же правка, как влитая ради
-работы, и уезжает тем же ходом. Конфликт тут ни при чём: он делает промах заметнее, а не создаёт
-его. Слияние, оставшееся в рабочей копии, либо пушится тем же ходом, либо не делается — иначе
-владелец видит прежнее состояние и решает по нему.
+работы, и уезжает тем же ходом. Слияние, оставшееся в рабочей копии, либо пушится тем же ходом,
+либо не делается — иначе владелец видит прежнее состояние и решает по нему.
 
 **Следующее движение:** прогон зелёный и замечаний нет — черновик снимается, и владельцу
 говорится, что работа готова.
 
-## Ловушки
-
-- **Тексты правятся до разбора папки.** Список того, что перечитывать, лежит в замысле, а
-  разбор папки его удаляет. После разбора остаётся только память о том, что задевали.
-- **Утверждение правила снимается вместе со строкой привязки.** Связь идёт по тексту
-  утверждения. Убрали утверждение и оставили строку в `implementation.md` — сверка спеков
-  краснеет; убрали строку и оставили утверждение — тоже.
+## Частые промахи
+
+- **Тексты правятся до разбора папки:** список того, что перечитывать, лежит в замысле, а разбор
+  папки его удаляет.
+- **Запись раздела решений, повторяющая статью правила слово в слово, доводом при ней не
+  считается.** Правило приходит в контекст само, спек — только когда его открыли; пара расходится
+  молча. Такая запись уезжает целиком, даже если раздел пустеет; довод, в статье не сказанный,
+  дописывается в статью.
+- **Тело заявки остаётся старше разбора папки.** Разбор — последний коммит ветки, и он делает
+  неправдой всё, что тело обещало сделать до слияния. Ревьювер читает список оставшегося как
+  оставшееся, поэтому тело правится тем же ходом.
+- **Утверждение правила снимается вместе со строкой привязки.** Связь идёт по тексту: строка без
+  утверждения и утверждение без строки одинаково краснят сверку спеков.
 - **Раздел «Чего из закона здесь нет» читается глазами, греп тут не помогает.** Искать
-  приходится не то слово, которое ждёшь: правило ссылалось на статью закона, которой в законе
-  нет вовсе, и по слову из своей темы эта строка находилась — а неправда была в другом.
-- **Сказать «сверено», не открыв файл, нельзя.** Правило читается целиком. Устаревшее
-  утверждение стоит в списке среди верных и ничем от них не отличается.
+  приходится не то слово, которое ждёшь: правило ссылалось на статью, которой в законе нет, и по
+  слову своей темы эта строка находилась — а неправда была в другом.
+- **Сказать «сверено», не открыв файл, нельзя.** Правило читается целиком: устаревшее утверждение
+  стоит среди верных и ничем от них не отличается.
 - **Вливание после мержа не делается.** В главной ветке тогда лежит раздел «предложено, но не
-  выкачено» с тем, что работает месяц, — беззвучная ложь, тем убедительнее, чем старше.
-- **Номера сценариев при вливании не пересчитываются.** Идентификатор — ключ связи с тестами;
-  сдвиг рвёт сверку у соседей, которых правка не касалась.
-- **«Что не входит» после вливания читается целиком, а не дописывается.** Договорённость несёт
-  свои границы, и при вливании они ложатся рядом с границами домена: половина повторяет уже
-  стоявшее другими словами, а строка «этого раздела ещё нет» становится ложью ровно той
-  работой, которая её вливает. Сверка спеков в этот раздел не смотрит вовсе. Снимается
-  дословный повтор и то, что работа сделала входящим.
-- **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет —
-  значит это намерение, и место ему в открытых вопросах домена, а не в правилах.
+  выкачено» с тем, что работает месяц: беззвучная ложь, тем убедительнее, чем старше.
+- **Номера сценариев при вливании не пересчитываются.** Идентификатор — ключ связи с тестами, и
+  сдвиг рвёт сверку у соседей.
+- **«Что не входит» после вливания читается целиком, а не дописывается.** Границы фичи ложатся
+  рядом с границами домена: половина повторяет стоявшее другими словами, а строка «этого раздела
+  ещё нет» становится ложью той работой, которая её вливает. Сверка спеков туда не смотрит.
+- **Своя строка сверки очереди ищется по имени** — по номеру задачи и имени ветки: сверка
+  отвечает про всё дерево, и на одном закрытии чужих папок было восемь при одной своей.
+- **Пара «метка объёма и строка в замысле эпика» рвётся с двух сторон:** задача по следу закрытой
+  наследует метку без строки о заходах, а закрытый эпик уносит строку у всех, кто её несёт.
+- **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет — значит
+  это намерение, и место ему в открытых вопросах домена.

package/assets/patterns/task-flow-handoff.md

@@ -89,6 +89,8 @@ mkdir -p <каталог передачи>
 ```markdown
 Работа: <КЛЮЧ>-<номер> «<название задачи>». Рабочее дерево — <полный путь>, ветка
 <КЛЮЧ>-<номер>-<slug> (заведена, в работе).
+Заявка: #<номер>, открыта, ждёт разбора владельцем. Свежесть её основания здесь не записана
+намеренно — она протухает; спрашивается она у хранилища первым делом нового захода.
 
 Ход работы и замысел придут на запуске сессии хуком — перечитывать их файлами не надо. Разбор
 просьбы владельца лежит в папке задачи и читается, когда непонятна причина решения.
@@ -128,7 +130,8 @@ mkdir -p <каталог передачи>
 
 Разделы фиксированы, и порядок у них тот же:
 
-1. **Работа** — номер задачи, её название, рабочее дерево полным путём, ветка и её состояние.
+1. **Работа** — номер задачи, её название, рабочее дерево полным путём, ветка и её состояние; у
+   отданной работы — номер открытой заявки и то, чего она ждёт.
 2. **Где искать** — что придёт хуком само, а что читается по надобности.
 3. **Эпик** — таблица положения; у работы вне эпика раздела нет.
 4. **Сделано и следующий шаг** — одной строкой каждое; подробности уже в ходе работы.
@@ -142,14 +145,23 @@ mkdir -p <каталог передачи>
 заход одной вставкой. Пересказывать содержание передачи в ответе не надо: владелец её и так
 прочитает, а место на неё уже потрачено.
 
-## Ловушки
+## Частые промахи
 
 - **Заход закрывается на втором пороге, а не начинает на нём новый этап.** Напоминание на
   первом — это уже сигнал выбирать точку, а не работать дальше, пока не отобьют.
 - **Передача пишется как пересказ переписки.** В неё идёт то, чего нет ни в ходе работы, ни в
   правилах: дерево, ветка, состояние стендов. Всё остальное следующий заход прочитает сам.
+- **Утверждение о состоянии работы берётся в тот же ход, а не вспоминается.** Родитель задачи,
+  её колонка, открытая заявка, влитая ветка, поднятые стенды живут вне захода и меняются без
+  него, а передача читается первой и не оспаривается: заход исполняет её указание, а не проверяет
+  его. Правдоподобие подтверждением не считается — «ветка не влита, значит и родителя нет» это
+  вывод, а не замер. Спросить нечем — так и пишется вопросом: «родитель не проверен, проверить
+  перед заявкой».
 - **Состояние работы в передачу не переезжает.** Сделанное отмечается в ходе работы — одной
   записью; передача его пересказывает, но не заменяет и в дерево не коммитится.
+- **В передачу записано состояние, которое живёт часами.** Отставание от главной ветки, ход
+  прогона и «проверки зелёные» новый заход читает как верное сегодня. В передачу идёт то, что не
+  меняется без участия исполнителя: дерево, ветка, номер заявки, что не закоммичено.
 - **Незакоммиченное не названо.** Работа живёт в дереве неделями, и строка «что лежит
   несохранённым и почему» — единственное, по чему это видно.
 - **Заход, кончившийся ничем, тоже пишет передачу.** «Пробовали так — не вышло, потому что» —

package/assets/patterns/task-flow-resume.md

@@ -27,6 +27,11 @@ description: Паттерн правила task-flow. Брать при возв
 образца, а `progress.md` заполняется по тому, что видно в дереве и в истории ветки, а не по
 расспросам владельца.
 
+Пришло «РАБОТА ЗАКРЫВАЕТСЯ» — папку разобрала сама ветка перед заявкой, и собирать её заново не
+надо: состояние работы читается у заявки и в передаче захода. Понадобилась правка кода по
+замечаниям разбора — папка восстанавливается на время правки, а разбор повторяется тем же
+коммитом.
+
 ## Чего не делать
 
 - **Не спрашивать владельца о том, что записано.** Ради этого всё и заведено.
@@ -139,19 +144,25 @@ git log --oneline origin/main..HEAD
 Берётся, а не выбирается: порядок назначен на планировании и лежит в замысле эпика. Выбор,
 предложенный владельцу при назначенном порядке, — просьба назначить его заново.
 
+У работы вне эпика замысла с порядком нет, и следующая берётся из очереди работ — тем же
+движением и с тем же запретом на выбор вслух: очередь спрашивается командой, а не памятью о том,
+что заводил сам исполнитель. Пусто в очереди — это утверждение о дереве, и подтверждается оно
+выводом команды.
+
 ```bash
 # что назначено следующим — читается в замысле эпика, а не спрашивается
 # состояние задач — в очереди работ: замысел о закрытом не знает
 ```
 
 Останавливает заход только предел заполнения окна — тогда идёт передача, паттерн
-`task-flow-handoff`. Эпик кончился — заход закрывается тем же порядком, и владельцу называется,
-что кончился именно эпик, а не одна его задача.
+`task-flow-handoff`. Кончившийся эпик поводом остановиться не бывает: работа берётся вне его —
+из очереди работ, — а владельцу тем же ходом называется, что кончился именно эпик, а не одна его
+задача. Он называется вместе со взятой работой, а не вместо неё.
 
 **Следующее движение:** по следующей задаче делается действие — заведена задача, ветка или
 папка. Ход кончается после него, а не после слов о нём.
 
-## Ловушки
+## Частые промахи
 
 - **Заход, кончившийся ничем, тоже записывается.** Иначе следующий пойдёт той же дорогой:
   «пробовали так — не вышло, потому что» стоит одной строки и экономит целый заход.
@@ -173,3 +184,7 @@ git log --oneline origin/main..HEAD
   через один ход после записи механизм повторился в той же форме. Поэтому разбор кончается не
   текстом, а тем, что из него вышло: правкой ресурса, гардом или предложением с адресом. Заход,
   дописавший разбор и вернувшийся к работе прежним, платит за него дважды.
+- **Число находок, написанное словом, устаревает к следующему абзацу.** Счёт растёт заходами, а
+  слово стоит на месте: «семь» простояло над восемью перечисленными до самого итога и поехало бы
+  дальше — в отчёт и в замысел эпика. Пишется либо перечень без числа, либо число, посчитанное
+  тем же ходом, каким пишется итог.

package/assets/patterns/task-flow-start.md

@@ -12,7 +12,8 @@ description: Паттерн правила task-flow. Брать в начале
 
 ## Когда брать
 
-- Владелец просит что-то сделать, и работы больше, чем на одну реплику.
+- Владелец просит что-то сделать; размер просьбы значения не имеет — папка заводится под любую
+  работу.
 - Замеченный по ходу дефект становится задачей.
 
 ## Порядок
@@ -41,23 +42,22 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 
 Разведка, не нашедшая ничего, разрешением спрашивать не становится. Сначала называется, где
 искали, потом добираются места, которых в списке не было: замысел эпика, описание прошлого,
-записи прошлых заходов.
+записи прошлых заходов. Одно место отрицанием не является: «в таком-то месте не нашёл» говорит о
+месте, а не о дереве, и вопрос называет оба способа, которыми искали.
 
 Разведка кончается не ощущением, а выводом команд. До первого вопроса владельцу исполнитель
 знает: как устроен репозиторий (корневая памятка), что лежит в каталоге, о котором пойдёт речь
-(`ls`), и есть ли уже написанное по теме (поиск по документации и правилам). Вопрос называет,
-где искали: «в таком-то месте не нашёл» — проверяемо, «не знаю» — нет. Без списка того, что
-считается сделанным, разведка исполняется как настроение: прочитанный переданный текст сходит
-за неё, и по текущему дереву не запускается ни одной команды.
+(`ls`), и есть ли уже написанное по теме (поиск по документации и правилам). «Не знаю»
+проверяемым не бывает. Без списка того, что считается сделанным, разведка исполняется как
+настроение: прочитанный переданный текст сходит за неё, и по текущему дереву не запускается ни
+одной команды.
 
 Разведка по заведённой задаче кончается воспроизведённым симптомом, а не найденным файлом. Тело
-задачи описывает дерево на день заведения, и между заведением и работой в главную ветку въезжают
-чужие правки: разведка, читающая код по именам из тела, подтверждает, что названные файлы на
-месте, — и отпавшая задача от живой не отличается ничем. Прежде первой своей правки разведка
-повторяет то, на что задача жалуется: зовёт процедуру, читает отданный ответ, гоняет проверку,
-которая молчала. Симптом не воспроизвёлся — задача закрывается как отпавшая, и это законный её
-исход: чинить нечего, а зелёные проверки после такой правки говорят ровно об этом и ни о чём
-больше.
+задачи описывает дерево на день заведения, и чужие правки въезжают в главную ветку между
+заведением и работой: разведка по именам из тела подтверждает, что файлы на месте, — и отпавшая
+задача от живой не отличается ничем. Прежде первой своей правки разведка повторяет то, на что
+задача жалуется: зовёт процедуру, читает ответ, гоняет молчавшую проверку. Симптом не
+воспроизвёлся — задача закрывается отпавшей, и это законный её исход.
 
 **Следующее движение:** находки ложатся в разбор, и тем же ходом владельцу уходит первый из
 шести вопросов. Разведка кончилась — состояние осталось прежним, ход тоже.
@@ -84,14 +84,15 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 заходе, включая исходную просьбу. Слово, повторённое в просьбе несколько раз, ответом является.
 Закрытый вопрос отмечается в разборе просьбы вместе с тем, чем он закрыт.
 
-Объём работы основанием для вопроса о границах не бывает. «Это большая работа» и «делать ли её
-целиком» — разные вопросы: первый исполнитель решает сам, второй владелец решает раньше, чем
-работа началась. Вопрос о границах задаётся тогда, когда владелец границ не назвал, — а не
-тогда, когда названные оказались широкими.
+Закрыть его можно и допущением, когда ответ очевиден: в разборе стоит строка «вопрос закрыт
+допущением: <что принято>». Неверное допущение стоит правки, вопрос ради очевидного — захода.
 
-Форму вопроса задают настройки владельца: где они требуют меню, спрашивается меню, и тогда к
-каждому вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
-Выбор слова, имени и термина уточняется прозой в любом случае.
+Объём работы основанием для вопроса о границах не бывает: «это большая работа» решает
+исполнитель, «делать ли её целиком» — владелец, и решает раньше, чем работа началась. Вопрос о
+границах задаётся, когда владелец их не назвал, а не когда названные оказались широкими.
+
+Форму вопроса задают настройки владельца: где требуют меню, спрашивается меню, и к каждому
+вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
 
 **Рамка переданного текста на текущее дерево не переносится.** Передача захода, файл
 предложений и спек описывают то дерево, в котором писались. Про текущее знает только текущее:
@@ -282,15 +283,14 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
 **Следующее движение:** первый этап делается тем же ходом, а закрытым он объявляется после
 того, как прошла его команда из строки «Чем проверяется».
 
-## Ловушки
+## Частые промахи
 
 - **Номер не бывает первым.** До конца разбора неизвестно даже, сколько задач из него выйдет:
   заведённая заранее задача после разбивки закрывается и остаётся мусором в очереди работ.
 - **Разбор пишется на диск сразу, а не копится в переписке.** Сессия обрывается, и разбор,
   прожитый в разговоре, восстанавливается только пересказом владельца.
 - **Из одного разбора вышло несколько задач — общее уезжает в замысел эпика.** Папка задачи
-  умирает с мержем, а порядок задач и зависимости между ними должны его пережить. Каталог для
-  замысла называет компаньон правила.
+  умирает с мержем, а порядок задач его переживает; каталог называет компаньон правила.
 - **Задача заводится командой, а не четырьмя вызовами подряд.** Борда к репозиторию не
   привязана, и задача попадает на неё только явным добавлением.
 - **Slug ветки берётся из терминологии договорённости, а не из слов просьбы.** Договорённость

package/assets/patterns/testing-e2e.md

@@ -58,6 +58,13 @@ const ALLOW_RENAME: boolean = process.env['E2E_ALLOW_SLUG_RENAME'] === '1';
 test.skip(!ALLOW_RENAME, 'меняет живой адрес объекта: включается E2E_ALLOW_SLUG_RENAME=1');
 ```
 
+Выключатели бывают двух родов, и покрытием считается только первый. **Выключатель по состоянию
+стенда** пропускает случай, которого на этом стенде не бывает по устройству, — сценарий закрыт,
+и отметки он не требует. **Выключатель по переменной окружения** оставляет тест невыполненным:
+сценарий за ним числится покрытым, а не проверен ничем, и такой сценарий несёт отметку
+частичного покрытия с причиной. Из трёх ниже к первому роду не относится ни один: все три
+управляются переменной.
+
 - Спека, необратимо меняющая данные стенда, по умолчанию пропускается и включается своей
   переменной.
 - `BEHIND_NGINX` в `home.smoke.spec.ts` — это `!!process.env['BASE_URL']`: вместе с ним
@@ -67,6 +74,22 @@ test.skip(!ALLOW_RENAME, 'меняет живой адрес объекта: в
 - `playwright/no-skipped-test` выключен в `eslint.config.mjs`: выключатель теста здесь —
   приём, а не забытый `test.skip`.
 
+## Код перехода проверяется ответом, а не переходом по нему
+
+Переход браузер проходит сам, и код после него — код конечной страницы: спека, названная
+«отвечает 301», утверждала 200 и не заметила бы подмены постоянного перехода на временный.
+Спрашивается сам ответ, без хождения по нему:
+
+```ts
+const answer = await request.get('/старый-адрес', { maxRedirects: 0 });
+
+expect(answer.status()).toBe(301);
+expect(answer.headers()['location']).toBe('/новый-адрес');
+```
+
+Отличать постоянный переход от временного нужно там, где на нём стоит договорённость: поисковые
+роботы и браузер запоминают только постоянный, и разница между 301 и 302 видна лишь в ответе.
+
 ## Частые промахи
 
 - **Порт {{ssrPort}} занимать осторожно:** стенд разработчика на {{sitePort}} ходит по тому же имени

package/assets/patterns/turn-entry-map.md

@@ -70,7 +70,7 @@ node tools/check-turn-map.mjs   # размер, полнота состояни
 без передачи, без карты, без обеих. Последний случай обязан дать пустой вывод и нулевой код —
 хук, промолчавший с ненулевым кодом, читается как отбитый запуск.
 
-## Ловушки
+## Частые промахи
 
 - **Предел размера назначается замером, а не на глаз.** Первое число выбрали «вдвое больше
   нынешней карты» — и проверка покраснела на собственном тексте в первом же прогоне: карта в

package/assets/pitfalls/agent-kit.md

@@ -26,6 +26,10 @@
   надстройка, которую она закрыла, не сопоставляются ничем, и надстройка остаётся замещать уже
   исправленный раздел.
 
+  Скопированная пакетная строка правится в источнике пакета, а не в копии: правка внутри
+  надстройки расходится с исходником молча, и видно её только там, где сам текст служит ключом
+  связи — в статье, у которой есть привязка. Перед правкой строки в надстройке она ищется в
+  источнике; не нашлась — строка своя, и правится на месте.
 - **Готовый код пакета не называет имён одного дерева.** Префикс директив кита, ключи подписей
   и имена сущностей принадлежат тому дереву, где паттерн писали; разложенные в соседнем, они
   учат звать то, чего там нет вовсе. Имя директивы при этом отличается от имени в примере: по
@@ -42,12 +46,6 @@
   отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
   зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала
   использование, потом импорт».
-- **Прогонять сценарии гардов можно, ничего не раскладывая, — но только там, где сам пакет живёт
-  исходниками.** Обвязка набора принимает каталог гардов переменной, и пакетную редакцию гоняют
-  по сценариям дерева до установки. Заход, потраченный на диагноз по последствиям, стоил ровно
-  этой строки. В поставке ни обвязки, ни каталога сценариев нет: они живут в репозитории пакета,
-  и дерево-потребитель, поверившее совету, ищет у себя то, чего ему не отгружали.
-
 - **Прогонять сценарии гардов можно, ничего не раскладывая, — там, где эти сценарии есть.**
   Обвязка набора принимает каталог гардов переменной, и пакетную редакцию гоняют до установки.
   Живёт она в репозитории самого пакета: в поставку едут ресурсы, строка запуска и библиотека, а

package/assets/pitfalls/doc-style.md

@@ -88,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` в поле сливаемости означает «ещё не посчитано», а не «конфликтов нет».** Хостинг
+  считает её после каждого чужого слияния, и заявка, прочитанная в эту секунду, выглядит
+  здоровой.
 - **Одна работа — одна задача, сколько бы файлов она ни задела.** Числа, за которым правка
   становится второй задачей, здесь нет: делится то, что придётся откатывать порознь. Сплошная
   правка текстов дерева была заведена тремя задачами «по объёму» — пришлось стирать две,
@@ -199,3 +214,8 @@
   хостинг, заявка стоит конфликтующей при разрешённом на месте расхождении.
 - **Сверки раскладки нет в конвейере, поэтому шага, который она бы закрывала, там тоже нет.**
   Правка мимо источника в день, когда её делают, не ломает ничего.
+- **Рабочее дерево не опустошается ради прогона инструмента.** Вопрос «этот долг был до моих
+  правок или от них» решается второй копией дерева, а не прятаньем работы: спрятанного не видит
+  ни статус, ни сверка, а команда, прошедшая между прятаньем и возвратом, пишет в те же файлы —
+  и возврат встаёт конфликтом. Так ушли в прятанье восемь незакоммиченных файлов при живом
+  запрете на эту команду: запрет читался в начале захода, а команда набиралась через сорок ходов.

package/assets/pitfalls/spec-driven.md

@@ -50,3 +50,9 @@
     и число это падает по мере того, как их читают. Счёт при этом грубый: строка, показанная
     образцом внутри ограды, считается наравне с настоящей — тот, кто учит её писать, попадает
     в число объявивших.
+- **Привязка пишется по тексту статьи, а не по смыслу имени гарда.** Гард, чьё имя звучит про то
+  же самое, статью не закрывает: статья перечисляла шесть действий по отдельному слову владельца
+  — коммит, пуш, открытие заявки, запись в вики, заведение задачи, правка закона, — а
+  поставленный ей гард не держит ни одного из них и отправки предложения среди перечисленного
+  нет вовсе. Читается текст статьи целиком, и в привязке называется то место, которое держит
+  названное ею, а не соседнее по смыслу.