@rt-tools/agent-kit 0.22.0 → 0.24.0

package/assets/patterns/git-workflow-pr-ready.md

@@ -0,0 +1,93 @@
+---
+name: git-workflow-pr-ready
+kind: pattern
+rule: git-workflow
+description: Паттерн правила git-workflow. Брать, когда заявки уже открыты: снятие черновика, разбор красного прогона, доведение череды до готовности, порядок «сначала довести отданное, потом брать новое». Открытие одной заявки — паттерн git-workflow-pr, порядок череды — git-workflow-stack.
+---
+
+# Доведение заявки до готовности
+
+Паттерн правила `git-workflow`. Что при этом должно быть верно — закон
+`docs/constitution/delivery.md`. Открытие заявки — паттерн `git-workflow-pr`, порядок череды —
+`git-workflow-stack`, разбор одного конфликта — `git-workflow-merge`.
+
+## Когда брать
+
+- Заявка открыта черновиком, и прогон по ней кончился.
+- Открыто несколько заявок разом, и надо решить, что делать раньше — доводить их или брать
+  следующую задачу.
+- Прогон заявки красный, а правка в ветке зелёная у себя.
+
+## Черновик — состояние работы, а не её вид
+
+Черновик говорит одно: работу нельзя вливать. Кнопка слияния у него заблокирована хостингом, и
+владелец, открывший список, видит не «сделано», а «делается». Заявка с зелёным прогоном и
+неснятым черновиком — сделанная работа, выглядящая незаконченной, и поправить это может только
+тот, кто её отдал.
+
+Отсюда порядок: **черновик снимается тем же ходом, которым прочитан зелёный прогон.** Не
+следующим, не после соседней задачи.
+
+```bash
+gh pr ready <номер>
+```
+
+Снятие черновика — последний шаг отдачи работы, а не отдельное дело. Пока он не сделан, работа
+не отдана, сколько бы коммитов ни лежало в ветке.
+
+## Сначала довести отданное, потом брать новое
+
+Открытая заявка — работа в полёте: её прогон стареет, её ветка отстаёт от главной, её тело
+описывает дерево на день написания. Всё это чинится дёшево сегодня и дорого через три задачи.
+
+Очередь поэтому такая:
+
+1. Прогоны открытых заявок прочитаны, черновики с зелёных сняты.
+2. Красные разобраны и починены.
+3. И только потом берётся следующая задача.
+
+Взять новую задачу, оставив позади десяток заявок черновиками, — значит отчитаться о работе,
+которой у владельца нет: он видит список «делается», а не список «готово».
+
+## Состояние читается разом
+
+Чем оно читается и как разбирается каждое поле — паттерн `git-workflow-freshness`; здесь
+только то, что делают с прочитанным. Пустой прогон разбирается наравне с красным: у заявки
+череды база не главная ветка, и фильтр по базе такое событие до конвейера не пропускает.
+
+## Красный прогон разбирается по шагу, а не по заявке
+
+```bash
+gh pr checks <номер>
+```
+
+Ответ называет упавший прогон и ссылку на него. Дальше у хостинга спрашивается имя упавшего
+шага — `gh api` по этому прогону, отбором `select(.conclusion=="failure")` по его шагам.
+
+Имя шага и есть диагноз. Правка идёт в ту ветку череды, где причина возникла, а не в ту, где
+прогон покраснел: у череды красным становится всё, что стоит выше причины.
+
+## Правка причины — в нижнюю ветку, оттуда волной вверх
+
+Причина, общая для всей череды, чинится один раз в самой нижней ветке. Наверх она едет
+вливанием, а не перебазированием: перебазирование переписывает историю уже отданных веток, и
+хостинг закрывает заявки верхних как слитые, хотя в главной их правок нет.
+
+Волна идёт снизу вверх, по одной ветке, и каждый шаг — три отдельных вызова: переключение на
+следующую ветку череды, вливание предыдущей в неё, отправка. Одной строкой их не пишут: гард
+поставки такую команду отбивает, и правильно — набор проверок гоняется по тому дереву, какое
+лежит на момент разбора команды, то есть по прежней ветке.
+
+Пропущенная посередине ветка оставляет свою заявку красной и ломает порядок вливания, поэтому
+волна проходит череду целиком.
+
+## Частые промахи
+
+- Черновик не снят, потому что «ещё гоняется прогон». Прогон кончился час назад; читается его
+  состояние, а не память о том, что он шёл.
+- Взята следующая задача, а десяток заявок остался черновиками. Для владельца сделанного нет.
+- Красное чинится в той ветке, где покраснело. У череды это верхняя, а причина — в нижней, и
+  починка сверху оставляет красным всё под собой.
+- Причина разослана по веткам перебазированием. Отданные ветки переписаны, заявки закрыты как
+  слитые, правок в главной нет.
+- Пустой прогон принят за зелёный. Событие до конвейера не дошло, и заявка не проверена вовсе.

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

@@ -180,7 +180,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
-   паттерн `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят, а тело собрано по
     образцу — разделы «Что сделано», «Чем подтверждено» и «Оставшийся шаг». Раздел оставшегося
     шага к этому моменту говорит, что шагов не осталось: черновик снимается после разбора

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

@@ -242,7 +242,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** — паттерн
-   `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **Тело PR собрано по образцу** — начинается строкой `Closes #<номер>`, несёт разделы «Что
     сделано», «Чем подтверждено» и «Оставшийся шаг», а метки, ревьювер и исполнитель стоят.
     Раздел оставшегося шага к этому моменту говорит, что шагов не осталось: черновик снимается

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

@@ -194,7 +194,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
-   паттерн `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **Описание MR собрано по образцу** — начинается строкой `Closes #<номер>`, несёт разделы
     «Что сделано», «Чем подтверждено» и «Оставшийся шаг», а метки, ревьювер и исполнитель
     стоят. Раздел оставшегося шага к этому моменту говорит, что шагов не осталось: черновик

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

@@ -34,16 +34,15 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 
 Находки складываются в раздел «Что уже есть в дереве» разбора.
 
-Дерево — не единственное место, где может лежать ответ. Решение, принятое прошлым заходом и
-никуда не записанное, живёт только в записи того захода: записи заходов лежат в каталоге заходов
-агента, и поиск по ним словом темы стоит одной команды. Найденное там ответом не остаётся на
-месте — тем же ходом оно переписывается в дерево: в замысел эпика, если связывает задачи, и в
-ход работы, если касается одной.
+Дерево — не единственное место, где лежит ответ. Решение прошлого захода, никуда не записанное,
+живёт только в записи того захода: поиск по ним словом темы стоит одной команды. Найденное тем же
+ходом переписывается в дерево — в замысел эпика, если связывает задачи, и в ход работы, если
+касается одной.
 
-Разведка, не нашедшая ничего, разрешением спрашивать не становится. Сначала называется, где
-искали, потом добираются места, которых в списке не было: замысел эпика, описание прошлого,
-записи прошлых заходов. Одно место отрицанием не является: «в таком-то месте не нашёл» говорит о
-месте, а не о дереве, и вопрос называет оба способа, которыми искали.
+Разведка, не нашедшая ничего, разрешением спрашивать не становится: сначала называется, где
+искали, потом добираются места, которых в списке не было — замысел эпика, описание прошлого,
+записи прошлых заходов. «В таком-то месте не нашёл» говорит о месте, а не о дереве, и вопрос
+называет оба способа, которыми искали.
 
 Разведка кончается не ощущением, а выводом команд. До первого вопроса владельцу исполнитель знает:
 как устроен репозиторий (корневая памятка), что лежит в каталоге, о котором пойдёт речь (`ls`), и
@@ -52,11 +51,22 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 дереву не запускается ни одной команды.
 
 Разведка по заведённой задаче кончается воспроизведённым симптомом, а не найденным файлом. Тело
-задачи описывает дерево на день заведения, и чужие правки въезжают в главную ветку между
-заведением и работой: разведка по именам из тела подтверждает, что файлы на месте, — и отпавшая
-задача от живой не отличается ничем. Прежде первой своей правки разведка повторяет то, на что
-задача жалуется: зовёт процедуру, читает ответ, гоняет молчавшую проверку. Симптом не
-воспроизвёлся — задача закрывается отпавшей, и это законный её исход.
+задачи описывает дерево на день заведения, и разведка по именам из тела подтверждает лишь то, что
+файлы на месте: отпавшая задача от живой этим не отличается. Прежде первой правки разведка
+повторяет то, на что задача жалуется, — зовёт процедуру, читает ответ, гоняет молчавшую
+проверку; симптом не воспроизвёлся — задача закрывается отпавшей, и это законный исход.
+
+Дерево, названное образцом, читается раскладкой целиком — обходом каталогов на два уровня, — и
+только потом идут вопросы о приёмах. Ответ на «как здесь делают вот это» даёт одну папку, а
+обобщённая до карты дерева она врёт: соседняя семья каталогов в неё не попадает, и пропажу
+находит владелец.
+
+Выведенное помечается прямо в списке, вместе с тем, чем его подтвердить. Догадка по соседнему
+случаю стоит в одном списке с проверенным, и владелец читает список целиком как проверенный.
+
+Шесть вопросов задаются за вычетом тех, на которые ответила разведка: вместо вопроса с готовым
+ответом в разбор идёт строка «беру такой-то ответ, вот откуда». Признак один — есть ли ответ в
+дереве; «задача кажется понятной» им не является ни в ту, ни в другую сторону.
 
 **Следующее движение:** находки ложатся в разбор, и тем же ходом владельцу уходит первый из
 шести вопросов. Разведка кончилась — состояние осталось прежним, ход тоже.
@@ -66,7 +76,7 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 Ведёт главный агент: субагент до владельца не достучится. Команда — `/grill-me`, один вопрос
 за раз, к каждому — свой рекомендуемый ответ с доводом.
 
-Шесть вопросов задаются всегда, даже когда задача кажется понятной:
+Шесть вопросов закрываются все, а задаются те, на которые разведка не ответила:
 
 | Вопрос                                       | Зачем                                                    |
 | -------------------------------------------- | -------------------------------------------------------- |
@@ -77,18 +87,14 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 | Чем будет видно, что задача закрыта          | «работает» признаком не является                         |
 | Есть ли образец, с которого снимается подход | разведка найдёт похожее, а не то                         |
 
-Список шести — набор того, что должно быть закрыто к началу работы, а не набор реплик, которые
-надо произнести. Обязательный вопрос, ответ на который владелец уже дал, отмечается закрытым, а
-не задаётся: ответ ищется в двух местах — в документации и в том, что владелец сказал в этом же
-заходе, включая исходную просьбу. Слово, повторённое в просьбе несколько раз, ответом является.
-Закрытый вопрос отмечается в разборе просьбы вместе с тем, чем он закрыт.
-
-Закрыть его можно и допущением, когда ответ очевиден: в разборе стоит строка «вопрос закрыт
-допущением: <что принято>». Неверное допущение стоит правки, вопрос ради очевидного — захода.
+Список шести — набор того, что закрыто к началу работы, а не набор реплик, которые надо
+произнести. Вопрос, ответ на который владелец уже дал, отмечается закрытым вместе с тем, чем он
+закрыт: ответ ищется в документации и в сказанном этим же заходом, включая исходную просьбу.
+Закрыть его можно и допущением, когда ответ очевиден, — строкой «вопрос закрыт допущением:
+<что принято>»: неверное допущение стоит правки, вопрос ради очевидного — захода.
 
 Объём работы основанием для вопроса о границах не бывает: «это большая работа» решает
-исполнитель, «делать ли её целиком» — владелец, и решает раньше, чем работа началась. Вопрос о
-границах задаётся, когда владелец их не назвал, а не когда названные оказались широкими.
+исполнитель, «делать ли её целиком» — владелец, и решает раньше, чем работа началась.
 
 Форму вопроса задают настройки владельца: где требуют меню, спрашивается меню, и к каждому
 вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
@@ -135,16 +141,14 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 (`spec-critic`) → замысел и разбивка (`project-manager`). Пробелы, которые роли не смогли
 закрыть, возвращаются владельцу — их относит главный агент.
 
-Договорённость, вышедшая из конвейера, сверяется с `grill.md` построчно до того, как по ней
-пойдёт работа. Роль пишет текст, не видя владельца, и способна развернуть его ответ в
-противоположный: очередь этапов оказалась перевёрнута, а два пункта из входящих переехали в
-«не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
-исполняется молча и не считается закрытой правкой текста.
+Договорённость, вышедшая из конвейера, сверяется с `grill.md` построчно до работы по ней: роль
+пишет текст, не видя владельца, и способна развернуть его ответ в противоположный — очередь
+этапов оказывалась перевёрнутой, а входящие пункты переезжали в «не входит». Находка критика,
+расходящаяся с ответом владельца, относится владельцу, а не исполняется молча.
 
-Ход на этой границе не кончается. Закрытый разбор выглядит законченным куском: ответы владельца
-лежат на диске, файл закоммичен, отчитаться есть чем — и отчёт встаёт ровно на то место, которое
-должна была занять договорённость. Пишется она тем же ходом, конвейером ролей или рукой
-исполнителя, и разницы между этими двумя случаями для конца хода нет.
+Ход на этой границе не кончается: закрытый разбор выглядит законченным куском — ответы на диске,
+файл закоммичен, отчитаться есть чем, — и отчёт встаёт на место договорённости. Пишется она тем
+же ходом, конвейером ролей или рукой исполнителя.
 
 **Следующее движение:** сверенная с разбором договорённость коммитится, и тем же ходом
 заводятся задача, ветка и папка — а вышла из разбора серия, сперва объявляется эпик.
@@ -179,12 +183,10 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 таблицы, с меткой эпика. Выданные номера возвращаются в ту же таблицу — колонкой или приставкой
 к названию, — и с этой минуты «взять следующую» отвечает номером, а не названием.
 
-Задача, заведённая под эпик, называет его в своём теле: номер карточки эпика и путь к замыслу —
-одной строкой. Замысел называет задачу со своей стороны, и односторонняя привязка выглядит целой
-ровно так же, как двусторонняя — читатель приходит то от линии работ, то от карточки, и вторая
-сторона существует только для одного из них. Держалась она подражанием: пока тело писалось с
-образца соседней задачи того же эпика, строка копировалась вместе с формой, а задача, заведённая
-посреди работы находкой сверки, писалась не с образца.
+Задача под эпиком называет его в своём теле — номер карточки и путь к замыслу одной строкой, — а
+замысел называет задачу со своей стороны. Односторонняя привязка выглядит целой так же, как
+двусторонняя: читатель приходит то от линии работ, то от карточки, и вторая сторона есть только
+для одного из них.
 
 **Следующее движение:** объявленный эпик коммитится вместе с номерами задач, и тем же ходом
 берётся первая его задача — заведением ветки и папки.
@@ -197,19 +199,17 @@ git checkout -b <КЛЮЧ>-<номер>-<slug>
 npm run task:move -- <номер> in-progress
 ```
 
-Тело приходит файлом и пустым не бывает: заведённая пустой задача не говорит ничего ни
-исполнителю, ни владельцу, а дописать её потом можно только со слова владельца — и заводится
-пустое молча, номером наравне с полным.
+Тело приходит файлом и пустым не бывает: пустая задача не говорит ничего ни исполнителю, ни
+владельцу, а дописать её потом можно только со слова владельца.
 
 `task:new` переименовывает `_draft-<slug>` в `<КЛЮЧ>-<номер>-<slug>` и проставляет шапку замысла.
 Ветка заводится вторым вызовом: составную «завести и сразу коммитить» гард главной ветки
 отклоняет целиком.
 
-Номер уже выдан — черновика нет и не заводится: папка открывается сразу под именем ветки, а
-разбор пишется в неё же. Так начинается половина работ: номер приходит прошлым заходом,
-замеченным дефектом или соседней задачей, и шаг с черновиком тогда неисполним — переименовывать
-нечего. Ловушка «номер не бывает первым» сюда не относится: она про то, что задачу не заводят до
-разбора, а не про то, что с уже заведённой нельзя работать.
+Номер уже выдан — черновика нет и не заводится: папка открывается сразу под именем ветки. Так
+начинается половина работ: номер приходит прошлым заходом, замеченным дефектом или соседней
+задачей, и переименовывать нечего. Ловушка «номер не бывает первым» сюда не относится — она про
+то, что задачу не заводят до разбора.
 
 Остальные два файла пишутся, а не кладутся образцом впрок: пустой `plan.md` неотличим от
 замысла без этапов, а следующий заход доверяет папке задачи. Образец открывается тем же

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/patterns/ts-procedure.md

@@ -2,7 +2,7 @@
 name: ts-procedure
 kind: pattern
 rule: typescript-conventions
-description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде: готовый класс с полем метода и обработчиком, зависимости конструктором, имена файла и класса. Доступ к процедуре — паттерн permissions-procedure.
+description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде: готовый класс с полем метода и обработчиком, зависимости конструктором, имена файла и класса. Доступ к процедуре описывает правило доступа того дерева, где оно есть.
 ---
 
 # Процедура Connect
@@ -41,7 +41,8 @@ export class PingProcedure implements IConnectProcedure<typeof HealthService.met
 }
 ```
 
-Объявление доступа обязательно, и оно ровно одно — паттерн `permissions-procedure`.
+Объявление доступа обязательно, и оно ровно одно; чем оно объявляется, говорит правило
+доступа того дерева, где такое правило есть.
 
 ## Почему форма такая
 

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 @@
   перечисляет шесть обязательных вопросов таблицей, и пустая таблица проходит наравне с
   заполненной.
 - **Отказ гарда разговора исполняется задним числом.** Владелец видит незаданный вопрос вместе с
-  отбитым ходом: прозаический вопрос инструментом не является, и раньше поймать его нечем. Гард
+  отбитым ходом: прозаический вопрос — не вызов инструмента, и раньше поймать его нечем. Гард
   отмечает пропуск, но не отменяет его.
 - **Обход требования папки нужен там, где работа вливается частями.** Тогда её до конца не
   разбирают, а причина остаётся в заявке.