@rt-tools/agent-kit 0.23.0 → 0.24.0

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

@@ -17,15 +17,26 @@ description: Паттерн правила browser-verification. Брать, к
 - Порт отвечает не тем, чего ждали.
 - Нужен вход в админку.
 
+## Номера портов объявляет дерево, а не паттерн
+
+Команды ниже называют порты именами — `API_PORT`, `SITE_PORT`, `ADMIN_PORT`, `SSR_PORT`, порты
+стенда и порты прокси. Номеров у паттерна нет: раскладка стендов у каждого дерева своя, а дерево с
+одним приложением, обязанное назвать восемь чужих номеров, называет их выдуманными — и
+подстановки теряют смысл. Номера дерево объявляет своим профилем: в переменных окружения либо
+разделом надстройки при этом паттерне, где стоят его же готовые команды с именами целей раннера.
+
+Роль каждого имени — то, о чём говорит проза: порт приёмника, порт сайта, порт админки, порт
+сервера отрисовки. Дерево, у которого такого приложения нет, эти разделы не читает.
+
 ## Сначала — что отвечает на порту
 
 До первого запроса, а не после непонятного ответа:
 
 ```bash
-lsof -nP -iTCP:{{apiPort}} -sTCP:LISTEN
+lsof -nP -iTCP:$API_PORT -sTCP:LISTEN
 ```
 
-На {{apiPort}} регулярно висит собранный артефакт из прошлой сессии
+На порту приёмника регулярно висит собранный артефакт из прошлой сессии
 (`node -r dotenv/config dist/apps/api/main.js`): он отвечает 200 старым кодом, а процедуры,
 заведённой в ветке, у него нет вовсе. Таких процессов бывает несколько, и снимать надо все —
 по PID из `lsof`, каждый: `pkill` по шаблону `nx serve api` не попадает ни в один.
@@ -34,7 +45,7 @@ lsof -nP -iTCP:{{apiPort}} -sTCP:LISTEN
 
 ```bash
 npx nx build site
-PORT={{prodSitePort}} node dist/apps/site/server/server.mjs
+PORT=$SITE_STAND_PORT node dist/apps/site/server/server.mjs
 ```
 
 Это не дев-сервер: гард ловит `nx|ng serve`, пакетные раннеры и статические серверы, а запуск
@@ -72,17 +83,32 @@ Angular DevTools, нужна ещё и dev-конфигурация (`--configur
 человеку набрать пароль, открыть вкладку или нажать кнопку означает неверно выбранный путь, а
 не нехватку прав у исполнителя.
 
+**Спрашивают режим работы, а не ввод.** Ввод в поле пароля отбивает классификатор
+автоматического режима: он судит само действие и адресов не различает — стенд на местном порту
+выглядит для него боевым сайтом. Ход отсюда один: назвать владельцу отбитое действие, попросить
+обычный режим, заполнить форму парой засева самому и вернуться в автоматический режим. Просьба
+«войди сам» и «введи пароль» перекладывает на владельца работу агента и выглядит законной ровно
+потому, что перед ней стоит настоящее препятствие: отбитое поле, чужое расширение в браузере,
+отключившийся профиль. Препятствие остаётся препятствием агента.
+
+Пути, которыми препятствие снимается своими силами, — до всякой просьбы: подстановка значения
+инструментом формы по ссылке на элемент, выключение мешающего расширения в профиле браузера,
+подъём стенда на другом адресе. Второй драйвер полем пароля не оправдывается: он заполняет то же
+поле без классификатора, но обойдённый запрет снимается не с одного поля, а со всех сразу.
+Оставленный обычный режим снимает подтверждение и со всех последующих действий захода, поэтому
+возврат — часть входа, а не отдельная уборка.
+
 Стенд владельца запасным путём не бывает: он собирает главную ветку и о правке в рабочем дереве
 не говорит ничего.
 
 ## Стенд API
 
-Собранный артефакт поднимается на свободном порту, а не на {{apiPort}}: на {{apiPort}} отвечает API
+Собранный артефакт поднимается на свободном порту, а не на порту приёмника: там отвечает приёмник
 владельца, и окружение у него не то, которое проверяется.
 
 ```bash
 npx nx build api
-env -u JWT_SECRET NODE_ENV=production API_PORT={{prodApiPort}} DATABASE_URL=… node dist/apps/api/main.js
+env -u JWT_SECRET NODE_ENV=production API_PORT=$API_STAND_PORT DATABASE_URL=… node dist/apps/api/main.js
 ```
 
 Переменные окружения задаются в самой команде, по одной на проверяемый случай. Отказ на
@@ -92,7 +118,7 @@ env -u JWT_SECRET NODE_ENV=production API_PORT={{prodApiPort}} DATABASE_URL=…
 Процедура зовётся полным именем, как её объявляет контракт:
 
 ```bash
-curl -sS -X POST http://localhost:{{prodApiPort}}/<область>.v1.AuthService/GetMe \
+curl -sS -X POST http://localhost:$API_STAND_PORT/<область>.v1.AuthService/GetMe \
     -H 'content-type: application/json' -H "authorization: Bearer $TOKEN" -d '{}'
 ```
 
@@ -108,7 +134,7 @@ curl -sS -X POST http://localhost:{{prodApiPort}}/<область>.v1.AuthServic
 ```bash
 docker run -d --name <префикс>-stand-nginx \
   --add-host api:host-gateway --add-host ssr:host-gateway \
-  -p {{dockerSitePort}}:80 -p {{dockerAdminPort}}:8081 \
+  -p $PROXY_SITE_PORT:80 -p $PROXY_ADMIN_PORT:8081 \
   -v "$PWD/deploy/nginx/main.conf:/etc/nginx/nginx.conf:ro" \
   -v "$PWD/deploy:/etc/nginx/conf.d:ro" \
   -v "$PWD/dist/apps/admin/browser:/usr/share/nginx/html/admin:ro" \
@@ -126,9 +152,24 @@ docker run -d --name <префикс>-stand-nginx \
   тем же, чем и на свой. За настоящим прокси запросы идут со своим заголовком ровно потому, что
   прокси стоит перед дев-сервером, — оттуда и `-H "Host: localhost"`.
 - Переменные окружения стенда обязаны смотреть на процессы стенда. `CACHE_REFRESH_URL`,
-  направленный на {{sitePort}}, сбрасывает кэш мимо того процесса, который держит справочник
+  направленный на порт сайта, сбрасывает кэш мимо того процесса, который держит справочник
   перенаправлений в памяти, — исправный механизм при этом выглядит сломанным.
 
+## Стенд живёт ровно столько, сколько проверка
+
+Стенд поднят под один вывод и после него не нужен. Брошенный не мешает ничему и не подаёт сигнала:
+имя у него своё, порт свободный, места он почти не занимает — увидеть его можно только вызовом
+списка, а звать его незачем. Разбирать накопленное поэтому приходится человеку, и отличить
+брошенный от живого стенда соседнего дерева он по имени не может.
+
+Снос идёт тем же ходом, которым сделан вывод:
+
+```bash
+docker rm -f <имя стенда>
+```
+
+Имя даётся по номеру задачи — так видно, чей стенд остался, если ход всё-таки оборвался.
+
 ## Дерево для сравнения
 
 Сказать «это сломала правка» можно, только если видно, что до правки было иначе. Проверяют это
@@ -142,8 +183,8 @@ pnpm install --frozen-lockfile         # из ../<префикс>-base: node_mod
 - Для сравнения берут не главную ветку, а последний коммит, на котором дерево собирается:
   главная бывает сломана, и тогда «до» и «после» различаются не из-за правки. Собирается ли
   коммит — проверяют сборкой, а не тем, что он в главной ветке.
-- Стенд второго дерева поднимают на своих портах: {{sitePort}}, {{adminPort}} и {{apiPort}} заняты владельцем, а {{ssrPort}}
-  занимать нельзя — стенд разработчика ходит по имени `ssr:{{ssrPort}}`.
+- Стенд второго дерева поднимают на своих портах: порты сайта, админки и приёмника заняты владельцем, а порт отрисовки
+  занимать нельзя — стенд разработчика ходит по имени `ssr:<порт отрисовки>`.
 - Оба стенда держат поднятыми одновременно — ровно до конца сравнения: если сравнивать по памяти
   между двумя запусками, заметишь только то, что успел запомнить. Со сравнением стенд второго
   дерева гасится тем же ходом, а не оставляется до конца захода: оставленные стенды копятся
@@ -157,7 +198,7 @@ pnpm install --frozen-lockfile         # из ../<префикс>-base: node_mod
 приписать своей сборке, ни снять с неё подозрение.
 
 ```bash
-for u in http://localhost:{{apiPort}}/health http://localhost:{{sitePort}}/ http://localhost:{{adminPort}}/; do
+for u in http://localhost:$API_PORT/health http://localhost:$SITE_PORT/ http://localhost:$ADMIN_PORT/; do
     printf '%s %s\n' "$(curl -s -o /dev/null -w '%{http_code}' --max-time 5 "$u")" "$u"
 done
 ```
@@ -170,9 +211,9 @@ done
 - **Одиночная сборка проекта серверы переживают, и отказываться от неё незачем.** Замерено
   ответом до и после: все порты остались за своими процессами. Осторожность здесь стоит дороже
   проверки — целый набор проверок разметки остался незапущенным ровно потому, что сборку
-  сочли опасной, не замерив. Сборка из кэша замером не является: она не собирает вовсе, и видно
+  сочли опасной, не замерив. Сборка из кэша замером не бывает: она не собирает вовсе, и видно
   это по её длительности.
-- Свой дев-сервер не поднимать: сайт на {{sitePort}}, админка на {{adminPort}}, API на {{apiPort}} уже подняты
+- Свой дев-сервер не поднимать: сайт, админка и приёмник уже подняты
   владельцем, и второй экземпляр отбивается гардом.
 - **Отбитый статический сервер читается как запрет проверки, а он указание на верный ход.**
   Отдавать собранное им нельзя не из осторожности: приложение ходит на свой origin, а глубокая
@@ -184,8 +225,8 @@ done
   поднятый дев-сервер годится, чтобы понять, что происходит на незнакомом экране, и не годится
   подтверждением: подтверждение — замер на стенде из прод-сборки.
 - **Общая сборка глушит все три дев-сервера владельца, а не только API.** После
-  `nx run-many -t build` ложатся и сайт на {{sitePort}}, и админка на {{adminPort}}. Собирать надо то, что
+  `nx run-many -t build` ложатся и сайт, и админка. Собирать надо то, что
   проверяешь (`npx nx build site`), а не всё дерево. Если серверы легли, поднять их обратно
   агент не может — мешает гард, поэтому владельцу говорят об этом сразу, а не в конце сессии.
-- Порт {{ssrPort}} занимать осторожно: стенд разработчика на {{sitePort}} ходит по тому же имени `ssr:{{ssrPort}}`
+- Порт отрисовки занимать осторожно: стенд разработчика ходит по тому же имени `ssr:<порт отрисовки>`
   через `host-gateway`, и пока на нём висит чужой процесс, стенд отдаёт чужую сборку.

package/assets/patterns/doc-style-human.md

@@ -0,0 +1,75 @@
+---
+name: doc-style-human
+kind: pattern
+rule: doc-style
+description: Паттерн правила doc-style. Брать при написании задачи в очереди работ, описания заявки и ответа владельцу в чате. Образцы «так» и «не так» на каждый из трёх текстов и разбор слов, которые в них заменяются. Форму ответа о состоянии работы называет правило status-report.
+---
+
+# Задача, описание заявки и ответ владельцу
+
+Паттерн правила `doc-style`. Три текста читает человек со стороны: он помнит продукт и не
+читал ни одного правила слоя. Здесь — как они пишутся; что при этом должно быть верно, говорит
+раздел «Тексты для человека» самого правила.
+
+## Когда брать
+
+- Заводится задача в очереди работ.
+- Пишется описание заявки на слияние.
+- Пишется ответ владельцу в чате — кроме ответа о состоянии работы: его форму называет правило
+  `status-report`.
+
+## Слова, которые заменяются
+
+Левая колонка — слова слоя правил. Они верны внутри слоя и пусты для того, кто в него не
+заглядывает.
+
+| Слово слоя         | Чем сказать владельцу                                      |
+| ------------------ | ---------------------------------------------------------- |
+| заявка на слияние  | правка, которая ждёт вашего слова                          |
+| прогон, набор      | проверки; «проверки прошли», «проверки красные»            |
+| гард, гейт         | что именно не пустило и почему                             |
+| договорённость     | о чём договорились по этому экрану                         |
+| объём правки       | что меняется на экране и где                               |
+| раскладка ресурсов | обновление правил на машине                                |
+
+## Задача
+
+Заголовок называет предмет, тело — что человек не может сделать. Красная проверка стоит в теле
+последней строкой: она говорит, где смотреть, и не говорит, зачем чинить.
+
+```text
+✗ Сквозная спека берёт пункт заглушкой, а прогон на вершине не доходит до выкатки
+✓ Раздел «Отчёты» не открывается у пользователя, и из-за этого не идёт выкатка.
+  Красная проверка — сквозной набор, шаг «отчёты».
+```
+
+## Описание заявки
+
+Первый абзац — что меняется для человека. Дальше — чем это подтверждено. Имена файлов уместны
+в конце, а не вместо первого абзаца.
+
+```text
+✗ Ярус личности вызова получил второй признак, набор гейта зелёный
+✓ Заявки от машинной записи больше не открываются от имени владельца: теперь перед открытием
+  спрашивается, кто приходит по токену. Проверки прошли, 26 сценариев.
+```
+
+## Ответ в чате
+
+Отвечает на заданный вопрос первым предложением. Утверждение о дереве идёт вместе с командой и
+её выводом — этого требует правило `status-report`, и в чате оно верно так же.
+
+```text
+✗ Работа отдана, красное въехало в главную, откат прикрыт гардом
+✓ Правку я отправил, она ждёт вашего слова. В главной ветке сейчас красный шаг «сборка витрины»
+  — упал не на этой правке, вывод: 76 из 76 сценариев не поднялись, витрина лежит.
+```
+
+## Ловушки
+
+- **Короче не значит понятнее.** Текст словами слоя выходит на треть короче и бесполезен тому,
+  кто решает, срочная это работа или нет.
+- **«Не X, а Y» выглядит объяснением и ничего не объясняет.** Владелец узнаёт, чего не было, и
+  не узнаёт, что есть.
+- **Слово «готово» без числа читается как проверенный факт.** Число — номер прогона, сколько
+  сценариев из скольких, время проверки.

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

@@ -25,6 +25,13 @@ description: Паттерн правила git-workflow. Брать на зав
 
 Все четыре делает одна команда дерева, а не рука: делить их значит забывать последний.
 
+**Команду, которой нет, паттерн не заменяет вызовами клиента.** Дерево, взявшее пакет впервые,
+получает файлы проверок, но не записи о них в своём манифесте: раскладка правит ресурсы, а
+манифест потребителя ей не принадлежит. Ходов отсюда два: завести команду тем же ходом либо
+повторить все её шаги поимённо по перечню выше. Обход вызовами клиента выглядит исполнением до
+последнего шага перечня: он забывается первым, потому что предыдущие уже дали видимый
+результат.
+
 ```bash
 npm run task:new -- --title 'Письма владельцу не уходят молча' \
     --type Bug --area '<проект>\<команда>' --slug mail-owner-silence < описание.md
@@ -151,6 +158,11 @@ Docs-skip: правка только в тестах хука, зеркала у
 
 ## Частые промахи
 
+- **Сверка сразу после добавления отвечает «нет», когда карточка уже стоит.** Очередь работ отдаёт
+  новый элемент не в ту же секунду, в какую его завели, а последний шаг читает её следующим
+  вызовом. Ответ на это — перечитать очередь целиком, а не завести карточку второй раз: две записи
+  об одной задаче снимает только администратор. Сама команда заведения при этом требует правки:
+  состояние читается сразу за мутацией, без повтора, и ложный отказ здесь дороже задержки.
 - Область и итерация не заданы: элемент заведён, но на доску команды не попал.
 - Состояние взято не из процесса проекта: перевод отвечает отказом на каждой задаче, и это
   читается как сломанная команда, а не как неверное имя состояния.

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

@@ -26,6 +26,14 @@ description: Паттерн правила git-workflow. Брать на зав
 
 Все четыре шага делает одна команда дерева, а не рука: делить их значит забывать третий.
 
+**Команду, которой нет, паттерн не заменяет вызовами клиента.** Дерево, взявшее пакет впервые,
+получает файлы проверок, но не записи о них в своём манифесте: раскладка правит ресурсы, а
+манифест потребителя ей не принадлежит. Ходов отсюда два: завести команду тем же ходом либо
+повторить все её шаги поимённо по перечню выше. Обход вызовами клиента выглядит исполнением до
+последнего шага перечня: он забывается первым, потому что предыдущие уже дали видимый
+результат. Так карточка простояла вне
+колонок всю работу — два коммита и два закрытых этапа.
+
 **Локальные ветки этой задачи читаются до заведения новой.** Борда не видит ветки, и задача, по
 которой работа лежит доделанной в локальной ветке, выглядит открытой у всех: колонку двигают
 рукой, заявки нет, а ветка видна только на той машине, где её завели. Под один номер так
@@ -87,7 +95,7 @@ gh project item-add <номер борды> --owner <владелец> --url <а
 который его показывает. Не нашлось ни того ни другого — задача не заводится, а строка документа
 правится тем ходом, которым её прочитали.
 
-Название тикета говорит, что не так, а не что сделать: PR потом переводит его в сделанное.
+Название задачи говорит, что не так, а не что сделать: PR потом переводит его в сделанное.
 Номер в заголовок руками не пишется — он известен только после создания, и команда дописывает
 его сама.
 
@@ -97,7 +105,7 @@ gh project item-add <номер борды> --owner <владелец> --url <а
 npm run check:board
 ```
 
-Она смотрит только открытое: тикеты на борде, номер и исполнителя у каждой открытой задачи,
+Она смотрит только открытое: задачи на борде, номер и исполнителя у каждой открытой задачи,
 а у каждого открытого PR — номер в заголовке, строку `Closes`, открытую задачу за ним и то,
 что второго PR с тем же номером нет. Имя ветки не судит: у открытого PR его не переименовать.
 
@@ -209,6 +217,11 @@ Docs-skip: правка только в тестах хука, зеркала у
 
 ## Частые промахи
 
+- **Сверка сразу после добавления отвечает «нет», когда карточка уже стоит.** Очередь работ отдаёт
+  новый элемент не в ту же секунду, в какую его завели, а последний шаг читает её следующим
+  вызовом. Ответ на это — перечитать очередь целиком, а не завести карточку второй раз: две записи
+  об одной задаче снимает только администратор. Сама команда заведения при этом требует правки:
+  состояние читается сразу за мутацией, без повтора, и ложный отказ здесь дороже задержки.
 - `gh` в оболочке пользователя подменён — звать `/opt/homebrew/bin/gh` напрямую.
 - Каталог добавлен целиком при чужом незакоммиченном рядом: чужая папка задачи уехала в главную ветку и стала отслеживаемой.
 - `git add` с несколькими путями не добавляет ничего, если хоть один путь не существует:
@@ -223,7 +236,7 @@ Docs-skip: правка только в тестах хука, зеркала у
 - `gh project` с `--owner` отвечает `unknown owner type`: владелец борды — другая учётная
   запись, и правка идёт только через GraphQL.
 - Заведённую задачу на борду сама она не забирает: репозиторий с ней не связан, и добавление
-  идёт отдельным вызовом. Два тикета так и остались вне очереди работ — поэтому все четыре
+  идёт отдельным вызовом. Две задачи так и остались вне очереди работ — поэтому все четыре
   шага и делает `npm run task:new`, а не рука.
 - Исполнитель у задачи не проставляется сам ни при заведении через веб, ни при добавлении на
   борду: из девяноста девяти открытых задач он стоял у двух.

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

@@ -25,6 +25,13 @@ description: Паттерн правила git-workflow. Брать на зав
 
 Все четыре делает одна команда дерева, а не рука: делить их значит забывать последний.
 
+**Команду, которой нет, паттерн не заменяет вызовами клиента.** Дерево, взявшее пакет впервые,
+получает файлы проверок, но не записи о них в своём манифесте: раскладка правит ресурсы, а
+манифест потребителя ей не принадлежит. Ходов отсюда два: завести команду тем же ходом либо
+повторить все её шаги поимённо по перечню выше. Обход вызовами клиента выглядит исполнением до
+последнего шага перечня: он забывается первым, потому что предыдущие уже дали видимый
+результат.
+
 ```bash
 npm run task:new -- --title 'Письма владельцу не уходят молча' \
     --label bug --label area:api --slug mail-owner-silence < описание.md
@@ -156,6 +163,11 @@ Docs-skip: правка только в тестах хука, зеркала у
 
 ## Частые промахи
 
+- **Сверка сразу после добавления отвечает «нет», когда карточка уже стоит.** Очередь работ отдаёт
+  новый элемент не в ту же секунду, в какую его завели, а последний шаг читает её следующим
+  вызовом. Ответ на это — перечитать очередь целиком, а не завести карточку второй раз: две записи
+  об одной задаче снимает только администратор. Сама команда заведения при этом требует правки:
+  состояние читается сразу за мутацией, без повтора, и ложный отказ здесь дороже задержки.
 - Метка списка не поставлена при заведении: задача есть, а на доске её нет. Доска показывает
   только то, чью метку знает.
 - Перевод по списку не снял прежнюю метку: задача стоит в двух списках сразу.

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

@@ -40,6 +40,7 @@ git diff --name-only --diff-filter=U     # что встало конфликт
 | Что встало конфликтом            | Как разрешается                                                                    |
 | -------------------------------- | ---------------------------------------------------------------------------------- |
 | код                              | ловушка правила `git-workflow` про сторону-удаление; после — `npm run check:dupes` |
+| сборка из описания               | собирается заново из описания после того, как описание разрешено: строки в такой файл пишет генератор, и соединённые руками стороны дают файл, которого он не выдаст |
 | спек в `docs/specs/`             | сохранением обеих сторон, если обе дописывали; снятый одной стороной раздел остаётся снятым — правило `spec-driven`; после — `npm run check:specs` |
 | компаньон правила рядом со скилом | сохранением обеих сторон — те же две дописи в одну таблицу; после — `npm run check:specs` |
 | список работ (`docs/BACKLOG.md`) | признаком отбора — паттерн `doc-style-sweep`                                       |
@@ -92,6 +93,13 @@ git checkout --theirs docs/BACKLOG.md && git add docs/BACKLOG.md
 
 ## Проверки после разрешения
 
+**Конфликт в разложенном файле, который исполняется, разрешается тем же вызовом, каким
+обнаружен.** Маркеры в теле гарда — синтаксическая ошибка, а не расхождение текста: ветка падает,
+диспетчер отдаёт её код отказом, и следующего вызова оболочки уже не будет — вместе с ней
+отбиваются и остальные двери, названные в объявлении этого гарда. Исполняемый файл узнаётся
+строкой `# rt-hook:` в шапке; отложенное «поправлю потом» здесь означает заход, который нечем
+продолжить.
+
 Конфликт в текстах кода не задевает, и зелёная сборка про него ничего не говорит:
 
 ```bash

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

@@ -76,7 +76,7 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 Ведёт главный агент: субагент до владельца не достучится. Команда — `/grill-me`, один вопрос
 за раз, к каждому — свой рекомендуемый ответ с доводом.
 
-Шесть вопросов задаются всегда, даже когда задача кажется понятной:
+Шесть вопросов закрываются все, а задаются те, на которые разведка не ответила:
 
 | Вопрос                                       | Зачем                                                    |
 | -------------------------------------------- | -------------------------------------------------------- |

package/assets/patterns/testing-e2e.md

@@ -33,13 +33,16 @@ description: Паттерн правила testing. Брать при правк
 ## Прогон
 
 ```bash
-npx nx e2e site-e2e -- --project=chromium
-npx nx e2e admin-e2e -- --project=chromium
-BASE_URL=http://localhost:{{dockerSitePort}} npx nx e2e site-e2e -- --project=chromium   # против внешнего стенда
+npx nx e2e <цель набора> -- --project=chromium
+BASE_URL=http://localhost:$PROXY_SITE_PORT npx nx e2e <цель набора> -- --project=chromium   # против внешнего стенда
 ```
 
-По умолчанию конфиг идёт на {{sitePort}} и подхватывает уже поднятый сервер. С `BASE_URL` свой сервер
-не стартует вовсе.
+Имена целей раннера и номера портов у каждого дерева свои: паттерн их не знает. Дерево называет
+их своим профилем — переменными окружения либо разделом надстройки при этом паттерне, где стоят
+готовые команды с его именами.
+
+По умолчанию конфиг идёт на порт стенда сайта и подхватывает уже поднятый сервер. С `BASE_URL`
+свой сервер не запускается.
 
 Полный набор админки гоняется **одним воркером** (`--workers=1`): тесты с настоящей сессией
 правят одни и те же объекты живой базы и в параллельном прогоне мешают друг другу. Одни и те
@@ -107,9 +110,9 @@ expect(answer.headers()['location']).toBe('/новый-адрес');
 
 ## Частые промахи
 
-- **Порт {{ssrPort}} занимать осторожно:** стенд разработчика на {{sitePort}} ходит по тому же имени
-  `ssr:{{ssrPort}}` через `host-gateway`, и пока на нём висит чужой процесс, стенд отдаёт чужую
-  сборку.
+- **Порт сервера отрисовки занимать осторожно:** стенд разработчика ходит по тому же имени
+  `ssr:<порт отрисовки>` через `host-gateway`, и пока на нём висит чужой процесс, стенд отдаёт
+  чужую сборку.
 - Браузер стоит один — chromium; узкий экран — `--project=mobile-chrome`. Ошибка «Executable
   doesn't exist» разобрана в правиле `testing`: она же приходит после смены версии Playwright.
 - Спеки админки без сессии пропускаются молча — прогон выглядит успешным, а проверено меньше
@@ -125,6 +128,13 @@ expect(answer.headers()['location']).toBe('/новый-адрес');
   успевает его прочитать, и тест краснеет через раз. Проверяют либо конечное состояние
   (`data-state` строки стал `done`), либо то же промежуточное — но на ответе, который тест сам
   задержал и сам отпускает.
+- **Двойник, перенесённый из спеки в общий файл набора, выходит из-под исключения проверки
+  повторов.** Она пропускает файлы спек и читает всё остальное, включая двойники и настройки, а
+  сверяет имя объявления — не значение и не назначение. Настройка, лежавшая в спеке под общим
+  именем, после переноса совпадает с одноимённой в другом слое, и проверка краснеет на файле,
+  которого правка не касалась: разбор такого красного занимает отдельный ход. Имя при переносе
+  получает приставку своего набора; строка в список известного не заводится — он только
+  сокращается.
 - **Каталог сборки, удалённый под смонтированным томом, оставляет контейнер с пустым
   корнем:** стенд отвечает 403 на всё, и падают сразу все тесты. Контейнер после
   `rm -rf dist/apps/<приложение>` пересоздаётся.

package/assets/pitfalls/task-flow.md

@@ -14,11 +14,10 @@
   тела задачи в дереве ещё верно.
 
 - **Разрешение владельца, оставленное в репозитории, теряется на каждой новой ветке.** Оно
-  записано номером в файл ветки, а следующая ветка отводится от главной и его не несёт: гард
-  отбивает работу, которую владелец разрешил, — и повторяется это ровно столько раз, сколько
-  веток заведут до слияния разрешившего коммита. Отказ гарда при этом называет файл и молчит о
-  том, что запись принадлежит ветке: из его текста это читается как настройка дерева. Пока
-  разрешение живёт в репозитории, номер дописывается заново в каждую новую ветку.
+  записано в файл ветки, а следующая ветка отводится от главной и его не несёт: гард запрещает
+  разрешённую работу столько раз, сколько веток заведут до слияния. Отказ называет файл и молчит
+  о том, что запись принадлежит ветке. Пока разрешение живёт в репозитории, номер дописывается в
+  каждую новую ветку.
 - **Имя чужого дерева в файлы репозитория не пишется, а путь к образцу — пишется.** Обе вещи
   живут рядом с передачей захода именно поэтому: там законен полный путь, а в репозитории —
   только ссылка без имени.
@@ -37,13 +36,11 @@
   договорённость обязана его пережить: её сценарии получают номера в общей нумерации домена,
   и на них ссылаются заголовки тестов. Обратное тоже верно — ход работы не кладётся в
   `proposed/`: спек, в котором завелись шаги, снова становится планом и умирает после мержа.
-- **У меню нет строки «вопрос не тот».** Меню годится там, где выбор действительно закрыт;
-  пока постановка вопроса не подтверждена, отвергнуть её владельцу нечем — он выбирает из
-  вариантов неверной посылки, и выйти из набора может только руками. Настройки владельца,
-  требующие меню, требование не снимают: тогда к каждому вопросу добавляется свободный вариант,
-  и он же — единственное место, где вопрос отвергается целиком. Три вопроса ушли одним меню, у
-  одного постановка была ложной. Там, где под сомнением сама уместность вопроса, его сперва
-  проверяют по репликам владельца — и чаще всего не задают.
+- **У меню нет строки «вопрос не тот».** Меню годится там, где выбор закрыт; пока постановка
+  вопроса не подтверждена, владельцу нечем её отвергнуть — он выбирает из вариантов неверной
+  посылки. Если настройки требуют меню, к каждому вопросу добавляется свободный вариант. Три
+  вопроса ушли одним меню, у одного постановка была ложной: уместность вопроса сперва проверяют
+  по репликам владельца.
 - **Субагент вопросов владельцу не задаёт.** Ни роли, ни конвейер до него не достучатся —
   они возвращают текст главному агенту. Поэтому разбор ведёт главный агент, а роли стоят по
   обе стороны от него.
@@ -91,11 +88,9 @@
   соседа.
 
 - **Копия образца папки задачи несёт шапку раскладки, и первая же правка отбивается гардом.**
-  Образец разложен пакетом наравне с остальным разложенным, а гард места правки судит по шапке:
-  копия под задачу выглядит разложенным файлом, и отказ называет адрес источника пакета — то
-  есть уводит править образец вместо своей копии. Команда заведения задачи шапку снимает сама,
-  копирование руками — нет. Правится такая копия только записью заново: правку по месту гард
-  отбивает и её.
+  Копия под задачу выглядит разложенным файлом, и отказ называет адрес источника пакета — уводит
+  править образец вместо копии. Команда заведения задачи снимает шапку сама, копирование руками
+  — нет. Такая копия правится только записью заново.
 - **Имя проекта в признаке готовности этапа спрашивается у сборщика, а не пишется по памяти.**
   На неизвестное имя сборщик отвечает «задач не запущено» и выходит нулём: команда признака не
   прогнала ни одной пробы и промолчала так же, как зелёный прогон. Видно это только по числу
@@ -122,19 +117,15 @@
   профиль дерева, и лежит он вне дерева кода.
 
 - **Тело задачи, написанное вперёд замысла, называет способ, и способ стареет раньше дефекта.**
-  Задача серии заводится за недели до того, как её берут, и к этому дню предложенный ход бывает
-  уже неверен: привезённое пакетом умеет то, что задача звала написать, названного места в
-  дереве не осталось, а посылки, на которых ход стоял, разведка не подтверждает. Читается такое
-  тело как действующее указание, поэтому работа начинается с чтения того файла, к которому
-  задача относится, а не с исполнения её тела. Расхождение уходит решением по ходу и меняет
-  способ, но не цель.
+  Задачу серии заводят за недели до взятия; к этому дню предложенный способ бывает уже неверен:
+  пакет уже умеет то, что задача звала написать, названного места в дереве нет. Работа поэтому
+  начинается с чтения файла, к которому задача относится, а не с исполнения её тела. Расхождение
+  меняет способ, но не цель.
 
 - **Работа, упершаяся в разрешение, доводится до конца без той части, которую разрешение
-  открывает.** Чужой шаг бывает двух родов: прогон и разбор идут сами и кончатся без
-  исполнителя, а отбитое разрешение не кончится никогда — его ждут, и ход, объявивший об этом,
-  останавливает работу целиком. Делается всё, что от разрешения не зависит, а непройденное
-  пишется строками тела заявки — там его читает ревьювер; реплика владельцу живёт до следующего
-  сообщения и в приёмку не попадает.
+  открывает.** Прогон и разбор кончатся сами, а отбитое разрешение не кончится никогда: ход,
+  объявивший ожидание, останавливает работу целиком. Делается всё, что от разрешения не зависит;
+  непройденное пишется в тело заявки, где его читает ревьювер.
 
 - **Слово владельца об устройстве — постановка, а не решение.** Названное им обычно уже живёт
   в дереве под этим самым словом: у него есть имя на экране, раздел в спеке и поле в модели, и
@@ -144,17 +135,11 @@
   спрашивается до правки.
 
 - **Указание работать по ходу — это указание делать его шаги, включая меняющие историю.**
-  Отметка сделанного этапа, отправка ветки и открытие заявки ходом предписаны, и отдельного
-  слова на каждый не требуется: спросить надо о том, чего в ходе нет вовсе. Изъятие приходит
-  из общего запрета дерева на действие без просьбы, прочитанного как требование буквального
-  слова, — и получается указание, исполненное наполовину. Граница у этого одна: прямое слово
-  владельца о самом шаге. Сказано «ветку не отправляй» — она не отправляется, сколько бы раз
-  ход её ни предписывал.
-
-- **Строка ожидания живёт дольше причины, по которой её написали.** Записанная в ход работы,
-  она приходит в следующий заход раньше любой реплики и подтверждает себя сама: три указания
-  подряд не пересилили одну строку на диске. Снимается она тем же ходом, которым владелец
-  ответил, — а не тем, в котором о ней вспомнили.
+  Отметка этапа, отправка ветки и открытие заявки предписаны ходом, отдельного слова на каждый
+  не нужно. Общий запрет дерева на действие без просьбы, прочитанный буквально, даёт указание,
+  исполненное наполовину. Граница одна: прямое слово владельца о самом шаге — «ветку не
+  отправляй» действует, сколько бы раз ход её ни предписывал.
+
 
 - **Очередь работ эпиком не кончается.** Занятый другими исполнителями или законченный эпик
   означает следующую задачу из очереди, а не остановку: «свободных задач эпика нет» ответом на
@@ -165,6 +150,21 @@
   колонку разбора и снятие её папки — обязательные шаги закрытия, и оба случаются тем же ходом,
   которым открывается заявка. Ход, в котором больше ничего нет, работу не двигает, сколько бы
   команд в нём ни стояло.
+- **Черновик папки без номера теряется молча.** Он лежит вне истории, и его не видят ни борда,
+  ни сверка очереди, ни следующий заход. Порог брошенного разбора эту потерю не ловит: работа
+  проигрывает соседним поручениям в тот же час, а неделя проходит потом.
+- **Стопка веток стоит дороже, и цена у неё названная.** Заявка в соседнюю ветку не запускает
+  конвейер, объявленный на базу главной; слияние базовой ветки закрывает заявку следующей как
+  слитую, хотя её правок в главной нет; конфликт от чужого слияния разрешается в каждой ветке
+  стопки заново. Расстановка, выбранная молча, собирает всю цену и не показывает ни одной её
+  части. Задачи, идущие одна из другой по коду, законно живут ветками от главной, пока правка
+  следующей не опирается на код предыдущей.
+
+- **Находка посреди этапа ощущается частью текущей работы, когда предмет соседний.** Своего
+  признака у этого нет: до первой правки находки в дереве нет, а после неё файлы соседней работы
+  от файлов своей не отличаются. Поэтому сверяется перечень условий выхода замысла, а не ощущение.
+  Однажды такую правку остановил посторонний отказ по роду файла, а не сверка с замыслом: без него
+  она уехала бы в чужую ветку, и раздельного отката у двух работ не было бы.
 
 ## Поведение исполнителя — по разборам происшествий
 
@@ -207,7 +207,7 @@
   перечисляет шесть обязательных вопросов таблицей, и пустая таблица проходит наравне с
   заполненной.
 - **Отказ гарда разговора исполняется задним числом.** Владелец видит незаданный вопрос вместе с
-  отбитым ходом: прозаический вопрос инструментом не является, и раньше поймать его нечем. Гард
+  отбитым ходом: прозаический вопрос — не вызов инструмента, и раньше поймать его нечем. Гард
   отмечает пропуск, но не отменяет его.
 - **Обход требования папки нужен там, где работа вливается частями.** Тогда её до конца не
   разбирают, а причина остаётся в заявке.