@rt-tools/agent-kit 0.18.0 → 0.20.0

package/assets/checks/check-board.github.mjs

@@ -241,7 +241,7 @@ function checkEvicted(pull, options) {
  * своей задачи; сверка же смотрит на состояние очереди целиком.
  *
  * Четыре PR так и простояли черновиками двое суток — разбор
- * `docs/postmortems/2026-08-18-ready-work-left-in-drafts.md`.
+ * запись «2026-08-18-ready-work-left-in-drafts» в приёме.
  */
 function checkReadyDraft(pull, options) {
     if (pull.isDraft !== true) {
@@ -266,7 +266,7 @@ function checkReadyDraft(pull, options) {
  *
  * Судится только прямое «конфликтует»: `UNKNOWN` означает, что хостинг сливаемость ещё считает,
  * и строка о нём краснела бы на каждой свежей вершине. Две заявки так и ушли в разбор с
- * конфликтом — разбор `docs/postmortems/2026-08-20-drafts-cleared-without-re-reading-pr-state.md`.
+ * конфликтом — разбор запись «2026-08-20-drafts-cleared-without-re-reading-pr-state» в приёме.
  */
 function checkConflicting(pull) {
     if (pull.mergeable !== 'CONFLICTING') {

package/assets/checks/check-states.mjs

@@ -6,7 +6,7 @@
  * паттерн до последнего раздела, следующего движения в нём нет, и ход кончается
  * отчётом. Так простояло состояние «замысел записан» — оно встречалось один раз,
  * клеткой таблицы, и дыру нашло происшествие, а не проверка. Разбор —
- * `docs/postmortems/2026-08-21-turn-ended-at-the-written-plan.md`.
+ * запись «2026-08-21-turn-ended-at-the-written-plan» в приёме.
  *
  * Сверяются два множества в обе стороны:
  *   перечень — таблица состояний в правиле ведения работы: имя и ведущий паттерн;

package/assets/defaults/gate-map.sh

@@ -121,8 +121,13 @@ skill_for_default() {
                 # скриптов зависимостью не является, и правило про версии на неё не вступает.
                 # Оговорка: удаление зависимости приходит правкой без номера версии и сюда не
                 # попадает — его ловит снимок дерева, который правится тем же коммитом.
+                # Своя редакция зависимостью не является: строка `"version"` в собственном
+                # манифесте говорит о выпуске этого пакета, а не о чужой версии, которую он
+                # тянет. Признак номера её ловил наравне с зависимостью, и подъём своей версии
+                # вёл исполнителя в правило о чужих версиях — не туда, где сказано, как выпускают.
                 */package.json)
-                    printf '%s' "$written" | grep -qE '"(dependencies|devDependencies|peerDependencies|optionalDependencies|overrides|resolutions|packageManager)"|"[^"]+"[[:space:]]*:[[:space:]]*"[~^]?[0-9]+\.[0-9]+' \
+                    printf '%s' "$written" | grep -v '"version"[[:space:]]*:' \
+                        | grep -qE '"(dependencies|devDependencies|peerDependencies|optionalDependencies|overrides|resolutions|packageManager)"|"[^"]+"[[:space:]]*:[[:space:]]*"[~^]?[0-9]+\.[0-9]+' \
                         && printf '%s\n' 'dependencies' ;;
                 */pnpm-lock.yaml | */pnpm-workspace.yaml | */package-lock.json) printf '%s\n' 'dependencies' ;;
 

package/assets/defaults/shell.sh

@@ -17,6 +17,14 @@
 # интерпретатора, будет отбита наравне с командой правки. Узкий список стоил бы дороже —
 # пропущенная форма записи возвращает обход целиком, а найти её можно только промахом.
 #
+# Удаление и перенос стоят в списке нарочно, а не по недосмотру. Снятие файла — правка
+# разрушительнее любой записи: записанное видно в дереве и откатывается, а снятое без замысла не
+# оставляет следа вовсе, и восстанавливать его приходится из истории. Цена этого выбора известна
+# и платится не там, где её ждут: своё временное, положенное под корнем кода, снимается командой,
+# и гард судит это правкой приложения — требует замысла на диске за действие, к приложению не
+# относящееся. Отличить одно от другого признак не может: путь у обоих лежит под тем же корнем.
+# Лечится это местом, а не признаком, — и сказано об этом ловушкой правила ведения работы.
+#
 # Перенаправление в пустое устройство и в поток ошибок снимается до разбора: файла оно не
 # пишет, а выглядит как перенаправление в файл. Так глушат вывод команды чтения, и без этого
 # `grep -rn x libs/ 2>/dev/null` судится наравне с записью — правило требуется на чтение, а

package/assets/hooks/postmortem-guard.sh

@@ -40,9 +40,18 @@ transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/nu
 
 root="${CLAUDE_PROJECT_DIR:-.}"
 
-# Каталог записей у дерева свой. Заданный пустым — отказ дерева от требования: дереву, которое
-# записей не ведёт, гард не навязывается.
-notes_dir="${RT_POSTMORTEMS_DIR-docs/postmortems}"
+# Каталог записей у дерева свой, и называет его настройка дерева — тем же ключом, каким его
+# читает отправка груза. Одно имя на обе стороны: дерево, унёсшее каталог из истории, иначе
+# получало бы гард, ищущий записи по прежнему адресу, — и тот молчал бы всегда. Переменная
+# остаётся обходом на один запуск, а пустая строка в любой из двух — отказ дерева от требования:
+# дереву, которое записей не ведёт, гард не навязывается.
+if [ -n "${RT_POSTMORTEMS_DIR+set}" ]; then
+    notes_dir="$RT_POSTMORTEMS_DIR"
+elif [ -f "$root/.claude/rt-kit.json" ]; then
+    notes_dir="$(jq -r '.postmortems // "docs/postmortems"' "$root/.claude/rt-kit.json" 2>/dev/null)"
+else
+    notes_dir="docs/postmortems"
+fi
 [ -z "$notes_dir" ] && exit 0
 [ -d "$root/$notes_dir" ] || exit 0
 

package/assets/hooks/turn-exit-guard.sh

@@ -166,7 +166,7 @@ work_re='git (add|commit|push|checkout|merge|rm)|npm run|pnpm (run|exec)|nx (bui
 # подтягивание, просмотр истории, чтение заявок и прогонов. Образец работы называет их работой,
 # потому что знает только первое слово — `git` и `gh` стоят в нём целиком, — и ход, в котором
 # исполнитель перешёл на главную ветку, прочитал историю и написал владельцу отчёт, выходил
-# отсюда нулём. Разбор — `docs/postmortems/2026-08-25-read-only-turn-counted-as-work.md`.
+# отсюда нулём. Разбор — запись «2026-08-25-read-only-turn-counted-as-work» в приёме.
 #
 # Разведка выглядит работой лучше всего остального: в ней команды, числа и точные ответы. Тем
 # она и опасна — ход, набитый ею, читается как полный и владельцем, и самим заходом.
@@ -179,7 +179,7 @@ part_re='&&|\|\||;|\n'
 # Ожидание чужого шага. Прогон, разбор владельцем и слияние идут без исполнителя и от взгляда
 # быстрее не становятся — правило прямо говорит, что состоянием работы это не бывает. Судится
 # только ПОСЛЕДНЕЕ действие хода: ожидание в середине законно, а запуск работы в фоне работой
-# остаётся. Разбор — `docs/postmortems/2026-08-25-turn-ended-on-waiting.md`.
+# остаётся. Разбор — запись «2026-08-25-turn-ended-on-waiting» в приёме.
 #
 # Прежний признак спрашивал одно: была ли за ход работа. Ход, где разобран конфликт, сделаны
 # коммит и пуш, а последним действием стал цикл до готовности прогона, проходил его целиком —
@@ -264,7 +264,7 @@ commands="$(printf '%s' "$verdict" | jq -r '.ran // ""' 2>/dev/null)"
 # Ровно так ход и вставал: задача взята, номер назван владельцу, отчёт написан — и следующее
 # действие состояния «задача-взята», написать замысел, не сделано. Отчёт выглядит работой лучше
 # всякой другой, а страж, знающий только «была ли за ход работа», подтверждает это: работа была.
-# Разбор — `docs/postmortems/2026-08-25-task-taken-and-turn-ended.md`.
+# Разбор — запись «2026-08-25-task-taken-and-turn-ended» в приёме.
 #
 # Папка, разобранная коммитом ветки, сюда не попадает: `archived` означает отданную работу, и её
 # судит прежний ярус. Ветка без номера задачи не судится вовсе — под пробу заводят и такие.
@@ -332,7 +332,7 @@ fi
 # вся она по сданной задаче: отдача завершает прошлую работу, а не ход. Девять разборов
 # происшествий за сутки описывают девять разных остановок, и во всех девяти последним действием
 # хода был текст владельцу: отчёт, сводка, объявление намерения.
-# Разбор — `docs/postmortems/2026-08-25-handover-turn-ends-on-intent.md`.
+# Разбор — запись «2026-08-25-handover-turn-ends-on-intent» в приёме.
 if [ "$handed_over" = "true" ] && [ "$started_next" != "true" ]; then
     reason="BLOCKED by turn-exit-guard: заявка открыта, а по следующей работе за этот ход не сделано ничего.
 
@@ -385,7 +385,7 @@ fi
 # Работа, оставшаяся в рабочем дереве. Ветка ушла вперёд своей удалённой ссылки, а заявки при
 # ней в этом ходе не открывали: сделанное лежит там, где его не видит никто, кроме сделавшего.
 # Признак читается без сети и молчит там, где ссылки нет вовсе — под пробу заводят и такие ветки.
-# Разбор — `docs/postmortems/2026-08-25-fifteen-branches-over-one-index.md`.
+# Разбор — запись «2026-08-25-fifteen-branches-over-one-index» в приёме.
 if [ "$worked" = "true" ] && [ "$handed_over" != "true" ]; then
     unpushed="$(git -C "$root" rev-list --count '@{u}..HEAD' 2>/dev/null)"
     if [ -n "$unpushed" ] && [ "$unpushed" -gt 0 ] 2>/dev/null; then

package/assets/laws/verifiability.md

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

package/assets/patterns/browser-verification-measure.md

@@ -48,6 +48,52 @@ description: Паттерн правила browser-verification. Брать, к
 главной сайта. Счёт годится любому наследуемому свойству: смотрится не одно значение, а число
 узлов с неожиданным.
 
+## Замер по всем порогам разом
+
+Замер по одной ширине за вызов даёт числа разных минут: между вызовами страница
+перерисовывается, и сравнивать их нельзя. Ширины поэтому гоняются пачкой в одном заходе —
+каждая живёт своим кадром, замер снимается со всех сразу:
+
+```javascript
+await (async (address, widths, row) => {
+    const frames = widths.map((width) => {
+        const frame = document.createElement('iframe');
+        frame.style.cssText = `width:${width}px;height:900px;border:0;position:fixed;left:-9999px`;
+        frame.src = address;
+        document.body.appendChild(frame);
+        return { width, frame };
+    });
+
+    await Promise.all(frames.map(({ frame }) => new Promise((done) => (frame.onload = done))));
+
+    return frames.map(({ width, frame }) => {
+        const view = frame.contentWindow;
+        const doc = frame.contentDocument;
+        const cells = [...doc.querySelectorAll(row)];
+
+        return {
+            asked: width,
+            got: view.innerWidth,
+            heights: [...new Set(cells.map((el) => Math.round(el.getBoundingClientRect().height)))],
+            scrolls: doc.documentElement.scrollWidth > doc.documentElement.clientWidth,
+            escaped: cells.filter((el) => el.getBoundingClientRect().left > view.innerWidth).length,
+        };
+    });
+})('/screen', [360, 599, 600, 904, 905, 1239, 1240, 1440], '.field');
+```
+
+Ответ читается по трём признакам, и первый не про вид:
+
+- **высоты соседей одной строки равны между собой** — набор значений в `heights` длиной больше
+  единицы означает, что поля встали разного размера;
+- **поперечной прокрутки нет** — `scrolls` истинно там, где содержимое шире кадра;
+- **ни одна левая граница не выходит за ширину кадра** — `escaped` больше нуля. На снимке этого
+  не видно вовсе: элемент за правым краем выглядит отсутствующим.
+
+Ширина кадра меньше заказанной на полосу прокрутки, поэтому сравнивают с `got`, а не с числом
+из списка: порог, названный по заказанной ширине, на кадре оказывается по другую сторону от
+себя.
+
 ## Узкий экран
 
 `resize_window` не работает, когда Chrome в полноэкранном режиме: инструмент рапортует успех,

package/assets/patterns/git-workflow-commit.github.md

@@ -26,6 +26,20 @@ description: Паттерн правила git-workflow. Брать на зав
 
 Все четыре шага делает одна команда дерева, а не рука: делить их значит забывать третий.
 
+**Локальные ветки этой задачи читаются до заведения новой.** Борда не видит ветки, и задача, по
+которой работа лежит доделанной в локальной ветке, выглядит открытой у всех: колонку двигают
+рукой, заявки нет, а ветка видна только на той машине, где её завели. Под один номер так
+завелась вторая ветка со своей папкой задачи и своим замыслом — то есть работа была спланирована
+второй раз, и выбирать из двух пришлось владельцу.
+
+```bash
+git branch --list '<КЛЮЧ>-<номер>-*'
+```
+
+Одна строка ответа означает, что работа уже начата: её состояние читается в ходе работы её
+папки, а не заводится заново. Пустой ответ говорит только про эту машину — ветка, заведённая на
+другой и не отданная хостингу, не видна и отсюда.
+
 **Очередь работ спрашивается до заведения задачи, а не после.** Найденное собственной сверкой
 ощущается новым, и это ощущение — единственное, что стоит за решением завести задачу: команда
 заведения отвечает за свои вызовы и о содержании очереди не знает ничего. Спрашивается она

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

@@ -133,6 +133,23 @@ PR описывал дерево на день, когда его написал
 что ветка везёт теперь, и прогон идёт заново: зелёные задания прошлого прогона после вливания не
 значат ничего.
 
+## Чужие папки задач приезжают вместе с главной веткой
+
+Мерж главной ветки везёт всё, что в неё влилось, — включая папки задач соседних работ, если те
+уехали в главную неразобранными. В своей ветке они выглядят как своё: лежат в том же каталоге,
+названы тем же порядком, и разбирать их отсюда некому.
+
+Кнопку слияния при этом нажимает человек, а там, где он это делает, хуков нет: гард, стерегущий
+разбор папки, до этого пути не достаёт. Поэтому сверка очереди работ гоняется сразу после мержа
+главной, а не перед пушем:
+
+```bash
+npm run check:board
+```
+
+Она называет папку, у которой нет открытой задачи, — это и есть приехавшая чужая. Своей рукой
+она не разбирается: снимает её тот, чья это работа, и делает это в своей ветке.
+
 ## Частые промахи
 
 - «Сохранить обе стороны» применено ко всем файлам одинаково: в спеке это верно, в коде и в

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

@@ -20,6 +20,16 @@ description: Паттерн правила task-flow. Брать, когда т
 
 ## Состояние `разбор-кончился`: папка задачи разбирается
 
+Разбор здесь свой, а не чужой: имя состояния говорит о папке задачи, которую разбирают
+следующим шагом, — не о заявке, которую читает ревьювер, и не о просьбе владельца, с разбора
+которой работа начиналась. Слово одно на три дела, и на беглом чтении имя выглядит чужим шагом:
+исполнитель говорил владельцу, что ждёт разбора, и брался за следующую задачу, а готовая работа
+стояла лишний ход и возвращалась в работу рукой владельца.
+
+Ждать при этом состоянии нечего. Вход в него — два признака, оба читаются в дереве: набор
+зелёный и тексты приведены. Одобрение владельца входом не является, и работа, ждущая его при
+сошедшихся признаках, стоит зря.
+
 Разбор идёт по трём исходам, а не по двум.
 
 **Первым отбирается действующее требование.** Всё, что останется верным и завтра, становится
@@ -161,6 +171,14 @@ npm run cargo:mark -- --state fixed \
 замеченная не разбором, а по ходу работы. Работа вне эпика показывает находки владельцу тем же
 ходом.
 
+**Имя файла находок собирается из имени замысла, а не выдумывается заходом.** Файл — это
+`<имя замысла>-findings.md` рядом с самим замыслом: замысел `<тема>.md` копит находки в
+`<тема>-findings.md`. Имя, выбранное на месте, читается только тем заходом, который его дал:
+следующий ищет находки этого эпика перебором каталога замыслов и, не найдя, заводит второй
+файл о том же — а владелец читает один из двух. Постоянного места здесь мало: у каждого эпика
+свой файл, и находит его по имени тот, кто пришёл к замыслу, а не к каталогу. Форма файла —
+образец находок среди образцов пакета.
+
 **Находки, вернувшиеся после того, как ветка ушла, едут веткой следующей задачи.** Пуш в снятую
 ветку её не обновляет, а заводит заново: коммит остаётся вне главной ветки и пропадает вместе
 с ней. Следующая задача к этому времени уже взята — её веткой уборка за предыдущей и едет.
@@ -172,6 +190,15 @@ npm run cargo:mark -- --state fixed \
 деление идёт задним числом, вместе с правкой ссылок на файл. Не влезает — заводится следующая
 часть, и раздел пишется сразу в неё.
 
+**Часть называется задачей, которая её завела, а не своим порядковым номером.** Имя —
+`<имя замысла>-findings-<КЛЮЧ>-<номер>.md`. Один эпик ведут несколько рабочих деревьев разом, и
+«следующая часть» каждое из них видит своей: две ветки заводят файл с одним именем, а
+столкновение обнаруживается только при вливании главной ветки — конфликтом на весь файл, где обе
+стороны верны и сложением не разрешаются. Номер задачи занят ею одной, и достаться двум деревьям
+он не может. Первая часть номера не несёт и задним числом не переименовывается: переименование
+правит ссылки во всех текстах, которые на неё смотрят, ради ровного ряда имён. Порядок между
+частями не нужен — находки друг друга не продолжают, и владелец читает их разом.
+
 **Наружу без слова владельца уезжает только сводка наблюдений.** Она говорит, чем пользовались
 и чем не пользовались ни разу, — это факт, и мнением он не станет. Предложение — другое дело:
 это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении. Уехавшая

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

@@ -100,6 +100,8 @@ mkdir -p <каталог передачи>
 
 Что учесть в этом заходе:
 
+- разбор работы правилами по <КЛЮЧ>-<номер> запущен фоном и не вернулся — находки писать в
+  `<имя замысла>-findings.md` рядом с замыслом эпика;
 - стенды уже подняты владельцем, свой не поднимать;
 - зависимости этого дерева отстают от главной ветки — при падении сборки на чужой ошибке
   сперва установка зависимостей;
@@ -137,7 +139,15 @@ mkdir -p <каталог передачи>
 4. **Сделано и следующий шаг** — одной строкой каждое; подробности уже в ходе работы.
 5. **Что учесть** — особенности этого захода, которых нет ни в правилах, ни в ходе работы:
    поднятые стенды, отставшие зависимости, чужие процессы на портах, незакрытые вопросы к
-   владельцу.
+   владельцу, запущенный фоном и не вернувшийся разбор.
+
+**Разбор, запущенный фоном и не вернувшийся к концу захода, называется строкой в «Что учесть».**
+Отвечает роль в переписку, а переписки к следующему заходу уже нет: ответ, пришедший после
+закрытия, не читает никто, и находки пропадают целиком вместе с тем, ради чего разбор и
+запускали. На диске следа тоже нет — файл находок пишет исполнитель по ответу, а ответа ещё не
+было. Строка называет задачу, по которой разбор идёт, и файл, куда писать вернувшееся: без
+второго следующий заход знает, что чего-то ждёт, и не знает, куда это класть. Своего раздела
+разбору не заводится — в заходе, где его не запускали, раздел стоял бы пустым.
 
 ### Путь владельцу
 

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

@@ -188,3 +188,8 @@ git log --oneline origin/main..HEAD
   слово стоит на месте: «семь» простояло над восемью перечисленными до самого итога и поехало бы
   дальше — в отчёт и в замысел эпика. Пишется либо перечень без числа, либо число, посчитанное
   тем же ходом, каким пишется итог.
+- **Красный набор на ветке, не тронувшей ни строки кода, спрашивается у соседних заходов раньше,
+  чем у своей правки.** Стенд у прогонов один на машину: соседний заход, поднявший его под себя,
+  роняет чужой набор, и падение выглядит поломкой среды. Прочитанное так, оно заводит второй
+  заход на то же место — чинить то, что не ломалось. Порядок обратный: сперва читаются соседние
+  заходы и занятые порты, и только потом своя правка.

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

@@ -193,7 +193,7 @@
   же, чего гард и добивается.
 - **Свои черновики судятся все разом.** Уход в соседнюю ветку выключал гард целиком: за один
   заход так разошлись с главной четыре заявки подряд, и заметил это владелец, а не проверка.
-  Разбор — `docs/postmortems/2026-08-25-run-left-unwatched.md`.
+  Разбор — запись «2026-08-25-run-left-unwatched» в приёме.
 - **Подпись машинной записи на каждом коммите вклада.** Пять коммитов одной стопки уехали
   подписанными владельцем, который правки не делал: гард судит только коммит, назвавшийся
   машинной записью, и ищет расхождение в числе служебного адреса.
@@ -219,3 +219,8 @@
   ни статус, ни сверка, а команда, прошедшая между прятаньем и возвратом, пишет в те же файлы —
   и возврат встаёт конфликтом. Так ушли в прятанье восемь незакоммиченных файлов при живом
   запрете на эту команду: запрет читался в начале захода, а команда набиралась через сорок ходов.
+- **Очередь конвейера, заведённая на всё дерево, снимает ждущего чужим пушем.** Группа
+  одновременности с отменой уже идущего экономит машину ровно до первого соседа: его пуш снимает
+  прогон чужой ветки, и та остаётся с вершиной без единого прогона — заявка при этом выглядит
+  непроверенной, а прогонять её заново некому. Группа поэтому заводится своя на ветку, и общей
+  остаётся только у шагов, которым нужен стенд: их и правда нельзя гнать вдвоём на одной машине.

package/assets/pitfalls/spec-driven.md

@@ -34,6 +34,14 @@
   его привязка перестают находиться друг по другу. После разрешения гоняется
   `npm run check:specs` — конфликт в спеке кода не задевает, и ни сборка, ни линтеры его не
   увидят.
+- **Сложение отвечает на две дописи, а не на снятие: сторона, у которой текста нет вовсе, тоже
+  правка.** Раздел, вынесенный в описание прошлого или свёрнутый в правило, сложением
+  возвращается обратно — один абзац встаёт в двух редакциях, и снятая читается как
+  действующая. Случай не редкий: он приходит ровно тогда, когда снятия потребовал сам слой
+  правил, а ветки, начатые раньше, несут прежнюю редакцию. Признак прямой — у одной стороны
+  текста нет; тогда конфликт решается тем, что с разделом сделали, а не сложением. Снятое
+  остаётся снятым, а допись второй стороны переезжает туда, куда уехал раздел, — или не
+  переезжает вовсе, если уехал он потому, что стал правилом.
 
 - **Строку требования к соседнему ресурсу не проверяет ничто, и расхождение видно только
   счётом.** Правило без неё выглядит целым: разделы на месте, привязки сходятся, сверка

package/assets/pitfalls/task-flow.md

@@ -81,6 +81,14 @@
   задание, он даёт заходу работу, которой владелец не просил. То же с любой репликой без
   глагола: спросить, что с этим делать, дешевле, чем написать полсотни файлов мимо просьбы.
 
+- **Своё временное кладётся вне дерева кода — иначе его снятие судится как правка приложения.**
+  Признак записи, которым гарды судят команду оболочки, считает записью и удаление, и это в нём
+  нарочно: снятое без замысла не оставляет следа вовсе. Отличить свой временный каталог от
+  каталога домена признаку нечем — путь у обоих под тем же корнем, — поэтому гард требует
+  замысла на диске за уборку черновика, к приложению не относящуюся. Каталог для своего
+  временного называет профиль дерева, и лежит он вне дерева кода; положенный внутрь, он платит
+  этим отказом при каждой уборке.
+
 - **Тело задачи, написанное вперёд замысла, называет способ, и способ стареет раньше дефекта.**
   Задача серии заводится за недели до того, как её берут, и к этому дню предложенный ход бывает
   уже неверен: привезённое пакетом умеет то, что задача звала написать, названного места в
@@ -201,3 +209,8 @@
   — сперва на отказе конца хода, потом на переводе колонки, и оба раза номер дописывался заново.
   Место такому разрешению там же, где передача захода: оно не откатывается вместе с правкой и не
   принадлежит ни одной задаче.
+- **Задача, вынесенная в другой эпик, снимается из состава прежнего тем же ходом.** Вынос — два
+  движения, и сделанное наполовину оставляет задачу в двух составах сразу: итог прежнего эпика
+  считается по числу, которого в нём уже нет, и эпик выглядит незакрытым при всех сделанных
+  работах. Итог вписывается там же, где правится состав: отложенный, он пишется по памяти о том,
+  сколько задач было, а не о том, сколько осталось.

package/assets/pitfalls/testing.md

@@ -38,6 +38,15 @@
 - **Первому прогону сразу после установки браузера верить нельзя.** Два падения сквозного
   набора не повторились ни при отдельном прогоне тех же тестов, ни при втором полном. Такой
   прогон повторяют, а выводы делают по второму.
+- **Повторный прогон через гейт пуша повторяет весь набор, а не упавший тест.** Гейт гоняет то,
+  что перечислил профиль дерева, целиком и с нуля: у сквозного набора это минуты, и каждая
+  попытка пуша стоит их заново. Соседняя ловушка верна ровно до этого места: повторить дёшево —
+  через гейт уже нет, и «повторить» превращается в «пушить, пока не пройдёт». Полный набор
+  поэтому гоняется руками до вызова пуша, а гейт только подтверждает уже известное. Тест,
+  упавший в полном наборе и прошедший при отдельном прогоне, зелёным не считается: это
+  нестабильный тест, и он заводится задачей тем же ходом. Прогон до зелёного уносит признак
+  вместе с падением, и следующий заход встречает то же самое как новость — а отличить чужую
+  нестабильность от своей регрессии ему нечем: оба случая выглядят одинаково.
 - Сквозная спека, которой нужен вход, без учётных данных в окружении пропускается молча — в
   отчёте она значится `skipped`, и прогон выглядит успешным. Имена переменных — при дереве.
 - **Справочник флоу вторых сценариев не заводит.** В `docs/E2E_<ДОМЕН>_FLOWS.md` кладут то,

package/assets/pitfalls/turn-conduct.md

@@ -80,3 +80,11 @@
   в него, встаёт целиком там, где мимо него шло ещё несколько ходов дела. Делается всё, что от
   разрешения не зависит, а несделанное называется в теле заявки, разделом об оставшемся шаге:
   он ровно про это и написан.
+- **Ответ на реплику владельца, пришедшую посреди хода, ход не кончает.** Выход «вопрос
+  владельцу» — про вопрос ОТ исполнителя; обратный случай под него не подходит вовсе, и
+  прочитанный так, он превращает каждую реплику владельца в конец захода. За один заход это
+  стоило трёх остановок подряд: владелец спрашивал, исполнитель отвечал и вставал.
+- **Работа не гейтится на подтверждение, которого владелец не обещал.** «Скажи — и я сделаю»
+  переносит ход к владельцу без его согласия: он не просил, чтобы у него спрашивали, и ответа с
+  него никто не ждал. Выглядит это вежливостью, а не остановкой, и потому не читается как
+  остановка ни исполнителем, ни им.

package/assets/skills/agent-kit.md

@@ -103,7 +103,11 @@ npx agent-kit propose       # отправить груз в приём: сво
     cp -r node_modules/@rt-tools/agent-kit/assets /tmp/agent-kit-assets-<прежняя версия>
     ```
 
-2. **Установка и раскладка.** Обычным порядком.
+2. **Установка и раскладка.** Обычным порядком. Раскладка кладёт ту редакцию, которая **установлена**,
+   а не ту, что объявило дерево: перепутать их легко — установленная остаётся от соседней ветки,
+   где её как раз поднимали, и ложится целиком, молча, с тем же успешным выходом. Расхождение
+   точного номера раскладка отбивает сама и называет обе редакции; починка — поставить
+   зависимости и повторить вызов.
 3. **Сверка замещённых разделов по снимку.** Какие разделы замещены, называет `doctor` — строкой
    «замещено надстройками разделов» и перечнем «ресурс · заголовок». Каждый из них читается в
    снимке и в новой редакции: что пакет дописал, дописывается в надстройку руками.

package/assets/templates/findings.md

@@ -0,0 +1,27 @@
+# Находки эпика <о чём он>
+
+<Копятся здесь, у замысла эпика: папка задачи умирает со слиянием, а находки владелец читает
+разом, когда эпик кончился. Имя файла — имя замысла с хвостом `-findings`, и лежит он рядом с
+самим замыслом.
+
+Раздел на задачу, строка на находку. Каждая называет адрес — слой правил, имена этого дерева
+или надстройку над разложенным: без адреса общее оседает в своём дереве и остаётся неизвестным
+всем остальным.
+
+Длина смотрится перед первой написанной строкой: раздел задачи занимает десятки строк, и предел
+длины документа он переходит молча. Не влезает — заводится следующая часть с именем той задачи,
+которая её завела: `<имя замысла>-findings-<КЛЮЧ>-<номер>.md`. Порядкового номера у части нет —
+его каждое рабочее дерево видит своим, и два дерева одного эпика заводят один и тот же файл.>
+
+## <КЛЮЧ>-<номер> — <что делала задача>
+
+- **<Находка одной фразой — что не так, а не что надо сделать.>** <Чем подтверждена: число,
+  отказ, файл. Что это стоило.> **Адрес:** <слой правил | имена этого дерева — <что именно> |
+  надстройка над разложенным>.
+
+## Осталось нерешённым
+
+<Находка, по которой правки ещё не было. Названная здесь, она переезжает в закрытые вместе с
+той правкой, которая её закрыла, — а не остаётся числиться живой.>
+
+- **<находка>** — <почему не закрыта: ждёт решения владельца, заводится своей задачей, спорна>.

package/bin/agent-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAeA,OAAO,EAAqC,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAoW7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU9E"}
+{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAeA,OAAO,EAAqC,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAuW7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU9E"}

package/bin/agent-kit.js

@@ -79,6 +79,9 @@ function environmentOf(root) {
     return {
         root,
         version: manifest.version,
+        // Имя из манифеста, а не записанное здесь: по нему пакет ищет себя в зависимостях дерева,
+        // и своя копия имени разошлась бы с манифестом молча — у всякого, кто пакет переименовал.
+        name: manifest.name,
         assetsDir: join(pkg, 'assets'),
         // Сверка со своими исходниками возможна только отсюда: здесь пакет знает, где лежит сам.
         // У потребителя исходников рядом нет, и сверка молчит.