@rt-tools/agent-kit 0.16.1 → 0.18.0

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

@@ -12,14 +12,22 @@ description: Паттерн правила task-flow. Брать при дове
 
 ## Когда брать
 
-- Этапы замысла закрыты, набор гейта прогнан целиком.
+- Этапы замысла закрыты.
 - `npm run check:specs` перечислил договорённость в разделе «Пора вливать».
+- Спек меряется длиной сразу после вливания: выросший делится тем же коммитом.
 - Тексты домена приводятся к тому, что работа сделала.
+- Набор гейта прогнан целиком — после вливания и приведения текстов, а не до них.
 - Папка задачи разобрана, и заявка открывается черновиком.
 - Прогон на вершине зелёный, и с заявки снимается черновик.
 
 Разбор самой папки сюда не относится — это паттерн `task-flow-archive`. Он стоит между
-приведением текстов и открытием заявки: заявка открывается уже за убранной работой.
+прогоном набора и открытием заявки: заявка открывается уже за убранной работой.
+
+**Прогон стоит после вливания договорённости и приведения текстов, а не перед ними.** Оба этих
+шага стоят минуты, а прогон — окно захода: заход, потративший его на прогон, упирался в порог
+заполнения на четырёх строках привязки, и дописать их было уже нечем. Второй довод сильнее
+первого — прогон, идущий после вливания, проверяет и само вливание; идущий до него, он смотрит
+то состояние дерева, которое в главную ветку не поедет.
 
 ## Состояние `этапы-кончились`: договорённость вливается в спек домена
 
@@ -30,11 +38,19 @@ description: Паттерн правила task-flow. Брать при дове
 npm run check:specs   # раздел «Пора вливать» называет готовые директории
 ```
 
+**Спек меряется длиной тем же ходом.** Вливание — известное движение, растящее спек: одно
+довело его до 572 строк при пределе 500, и узнал об этом исполнитель отказом гарда пуша, то
+есть после коммита. Выросший делится на поддомены здесь же, а не на пуше.
+
 Порядок переезда:
 
 - правила из `proposed/<фича>/spec.md` дописываются в `spec.md` домена, в его разделы;
 - сценарии переезжают в `scenarios.md` домена **с прежними номерами**: на них ссылаются
   заголовки тестов, и пересчёт рвёт сверку;
+- сценарии, у которых работа переписала обещание, правятся на месте: номер прежний, текст
+  новый, заголовок теста правится тем же коммитом. Работа, снимающая приём, переписывает уже
+  записанное обещание чаще, чем заводит новое, а список, перечисляющий одну допись, эту правку
+  не называет вовсе;
 - привязки из `proposed/<фича>/implementation.md` дописываются в `implementation.md` домена
   и проставляются на код, который теперь есть;
 - законы, объявленные фичей в шапке, дописываются в шапку спека домена;
@@ -103,11 +119,60 @@ grep -rn -A3 "Чего из закона здесь нет" <каталог пр
 работа ждёт владельца, а не машину, и заход на этом не кончается: следующая задача берётся тем
 же движением, паттерн `task-flow-resume`.
 
+**Готовность меряется рассказанностью, а не пройденностью.** Перечень того, что сделано к
+открытию, читается как список обязательных проверок, и границы у него не видно. Она есть:
+проверка, которую исполнитель не может пройти по причине вне работы — отбитое разрешение,
+недоступная среда, ключ у человека, — готовность не отменяет. Она попадает в «Не гонялось» и в
+«Оставшийся шаг», названная вместе с причиной; умолчание о ней читается как пройденная.
+
 Состояния на диске уже нет — ход работы уехал вместе с папкой. Это цена того, что уборка стоит
 до заявки: хвост из четырёх шагов — открыть заявку, дождаться прогона, снять черновик, попросить
 влить — держится этим паттерном, а не строкой в файле. Гард признаёт работу отданной по истории
 ветки: папка, снятая её коммитом, и есть признак.
 
+### Раздел об оставшемся шаге пишется в теле заявки, а не дописывается потом
+
+Он стоит там с минуты открытия. Сказанного вслух мало, и одним этим требование не держится:
+реплика живёт до следующей реплики, а решение о слиянии принимается на странице заявки — там
+переписки нет вовсе. Владелец вливает, как только видит зелёное, и заявка, открытая без раздела,
+уезжает в главную ветку раньше, чем раздел успевают дописать: так папка задачи однажды и уехала
+неразобранной, пока шёл прогон. Раздел стоит последним и говорит ровно одно: осталось ли что-то
+до слияния.
+
+```markdown
+## Оставшийся шаг
+
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
+```
+
+Черновик снят — раздел переписывается тем же вызовом, которым правится тело:
+
+```markdown
+## Оставшийся шаг
+
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
+```
+
+Заголовок раздела и слова обоих образцов пишутся языком заявки, а не языком паттерна. Образцы
+набраны тем языком, которым написан сам паттерн, и переносятся целиком — порядок мыслей,
+формулировки и заголовок, заголовок последним: он выглядит частью формы, а не частью текста.
+То же верно и для двух сообщений владельцу ниже: они образцы того, **что** сказано, а не того,
+какими словами.
+
+Пустым раздел не оставляется и не удаляется вовсе: отсутствие раздела и «шагов не осталось»
+читаются одинаково, а значат разное. Образец тела заявки целиком — в паттерне заведения коммита
+и заявки, если дерево его разложило.
+
+Держит это гард поставки, а не память пишущего: он читает тело прямо из команды открытия —
+доводом оно передано или файлом — и отбивает вызов вместе с остальным несошедшимся. Образец
+заголовка при этом называет дерево, потому что заголовок пишется языком заявки, а пакет чужих
+слов не знает; не названный, раздел не судится вовсе. Сверка очереди работ тела по-прежнему не
+читает: промах ловится в минуту открытия, то есть там, где он ещё исправим одним вызовом.
+
+Разница между разделом и сказанным вслух одна, и она вся: реплику владелец прочитает, только
+если вернётся в переписку, а раздел он видит там, куда смотрит, нажимая кнопку.
+
 ### Два сообщения владельцу, и между ними — прогон
 
 Оба обязательны, и порядок между ними один. Ни одно не заменяется другим: первое говорит, что
@@ -175,6 +240,12 @@ PR #<номер> готов к слиянию: прогон зелёный, че
 читаются одинаково, а значат разное. Образец тела заявки целиком — в паттерне заведения коммита
 и заявки, если дерево его разложило.
 
+Открытая заявка перечитывается той записью, которая будет её вливать, а не той, что её открыла.
+Ответ хостинга автору говорит лишь, что вызов прошёл: право на открытие и видимость открытого —
+разные вещи, и вторая проверяется только со стороны читателя. Невидимая заявка ничем себя не
+выдаёт — она есть в ответе своему автору, у неё стоят метки, а очередь разбора у владельца просто
+пуста.
+
 Проверить это машиной нечем, и проверки не будет: тело заявки не читает ни одна сверка, а
 хостинг не спрашивает ни о чём, кроме заголовка. Требование держится тем же, чем и слова
 вслух, — тем, кто пишет тело. Разница между ними одна, и она вся: реплику владелец прочитает,
@@ -186,29 +257,41 @@ PR #<номер> готов к слиянию: прогон зелёный, че
 нет, и собирать папку заново не надо: гард хода работы пропускает правку по признаку из истории
 ветки. Что именно чинится, берётся из замечания, а не из замысла.
 
+Главная ветка, влитая ради того, чтобы что-то посмотреть, — такая же правка, как влитая ради
+работы, и уезжает тем же ходом. Слияние, оставшееся в рабочей копии, либо пушится тем же ходом,
+либо не делается — иначе владелец видит прежнее состояние и решает по нему.
+
 **Следующее движение:** прогон зелёный и замечаний нет — черновик снимается, и владельцу
 говорится, что работа готова.
 
-## Ловушки
-
-- **Тексты правятся до разбора папки.** Список того, что перечитывать, лежит в замысле, а
-  разбор папки его удаляет. После разбора остаётся только память о том, что задевали.
-- **Утверждение правила снимается вместе со строкой привязки.** Связь идёт по тексту
-  утверждения. Убрали утверждение и оставили строку в `implementation.md` — сверка спеков
-  краснеет; убрали строку и оставили утверждение — тоже.
+## Частые промахи
+
+- **Тексты правятся до разбора папки:** список того, что перечитывать, лежит в замысле, а разбор
+  папки его удаляет.
+- **Запись раздела решений, повторяющая статью правила слово в слово, доводом при ней не
+  считается.** Правило приходит в контекст само, спек — только когда его открыли; пара расходится
+  молча. Такая запись уезжает целиком, даже если раздел пустеет; довод, в статье не сказанный,
+  дописывается в статью.
+- **Тело заявки остаётся старше разбора папки.** Разбор — последний коммит ветки, и он делает
+  неправдой всё, что тело обещало сделать до слияния. Ревьювер читает список оставшегося как
+  оставшееся, поэтому тело правится тем же ходом.
+- **Утверждение правила снимается вместе со строкой привязки.** Связь идёт по тексту: строка без
+  утверждения и утверждение без строки одинаково краснят сверку спеков.
 - **Раздел «Чего из закона здесь нет» читается глазами, греп тут не помогает.** Искать
-  приходится не то слово, которое ждёшь: правило ссылалось на статью закона, которой в законе
-  нет вовсе, и по слову из своей темы эта строка находилась — а неправда была в другом.
-- **Сказать «сверено», не открыв файл, нельзя.** Правило читается целиком. Устаревшее
-  утверждение стоит в списке среди верных и ничем от них не отличается.
+  приходится не то слово, которое ждёшь: правило ссылалось на статью, которой в законе нет, и по
+  слову своей темы эта строка находилась — а неправда была в другом.
+- **Сказать «сверено», не открыв файл, нельзя.** Правило читается целиком: устаревшее утверждение
+  стоит среди верных и ничем от них не отличается.
 - **Вливание после мержа не делается.** В главной ветке тогда лежит раздел «предложено, но не
-  выкачено» с тем, что работает месяц, — беззвучная ложь, тем убедительнее, чем старше.
-- **Номера сценариев при вливании не пересчитываются.** Идентификатор — ключ связи с тестами;
-  сдвиг рвёт сверку у соседей, которых правка не касалась.
-- **«Что не входит» после вливания читается целиком, а не дописывается.** Договорённость несёт
-  свои границы, и при вливании они ложатся рядом с границами домена: половина повторяет уже
-  стоявшее другими словами, а строка «этого раздела ещё нет» становится ложью ровно той
-  работой, которая её вливает. Сверка спеков в этот раздел не смотрит вовсе. Снимается
-  дословный повтор и то, что работа сделала входящим.
-- **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет —
-  значит это намерение, и место ему в открытых вопросах домена, а не в правилах.
+  выкачено» с тем, что работает месяц: беззвучная ложь, тем убедительнее, чем старше.
+- **Номера сценариев при вливании не пересчитываются.** Идентификатор — ключ связи с тестами, и
+  сдвиг рвёт сверку у соседей.
+- **«Что не входит» после вливания читается целиком, а не дописывается.** Границы фичи ложатся
+  рядом с границами домена: половина повторяет стоявшее другими словами, а строка «этого раздела
+  ещё нет» становится ложью той работой, которая её вливает. Сверка спеков туда не смотрит.
+- **Своя строка сверки очереди ищется по имени** — по номеру задачи и имени ветки: сверка
+  отвечает про всё дерево, и на одном закрытии чужих папок было восемь при одной своей.
+- **Пара «метка объёма и строка в замысле эпика» рвётся с двух сторон:** задача по следу закрытой
+  наследует метку без строки о заходах, а закрытый эпик уносит строку у всех, кто её несёт.
+- **Правило без привязки в спек домена не въезжает.** Кода, который его исполняет, нет — значит
+  это намерение, и место ему в открытых вопросах домена.

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

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

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

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

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

@@ -12,7 +12,8 @@ description: Паттерн правила task-flow. Брать в начале
 
 ## Когда брать
 
-- Владелец просит что-то сделать, и работы больше, чем на одну реплику.
+- Владелец просит что-то сделать; размер просьбы значения не имеет — папка заводится под любую
+  работу.
 - Замеченный по ходу дефект становится задачей.
 
 ## Порядок
@@ -33,21 +34,30 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 
 Находки складываются в раздел «Что уже есть в дереве» разбора.
 
+Дерево — не единственное место, где может лежать ответ. Решение, принятое прошлым заходом и
+никуда не записанное, живёт только в записи того захода: записи заходов лежат в каталоге заходов
+агента, и поиск по ним словом темы стоит одной команды. Найденное там ответом не остаётся на
+месте — тем же ходом оно переписывается в дерево: в замысел эпика, если связывает задачи, и в
+ход работы, если касается одной.
+
+Разведка, не нашедшая ничего, разрешением спрашивать не становится. Сначала называется, где
+искали, потом добираются места, которых в списке не было: замысел эпика, описание прошлого,
+записи прошлых заходов. Одно место отрицанием не является: «в таком-то месте не нашёл» говорит о
+месте, а не о дереве, и вопрос называет оба способа, которыми искали.
+
 Разведка кончается не ощущением, а выводом команд. До первого вопроса владельцу исполнитель
 знает: как устроен репозиторий (корневая памятка), что лежит в каталоге, о котором пойдёт речь
-(`ls`), и есть ли уже написанное по теме (поиск по документации и правилам). Вопрос называет,
-где искали: «в таком-то месте не нашёл» — проверяемо, «не знаю» — нет. Без списка того, что
-считается сделанным, разведка исполняется как настроение: прочитанный переданный текст сходит
-за неё, и по текущему дереву не запускается ни одной команды.
+(`ls`), и есть ли уже написанное по теме (поиск по документации и правилам). «Не знаю»
+проверяемым не бывает. Без списка того, что считается сделанным, разведка исполняется как
+настроение: прочитанный переданный текст сходит за неё, и по текущему дереву не запускается ни
+одной команды.
 
 Разведка по заведённой задаче кончается воспроизведённым симптомом, а не найденным файлом. Тело
-задачи описывает дерево на день заведения, и между заведением и работой в главную ветку въезжают
-чужие правки: разведка, читающая код по именам из тела, подтверждает, что названные файлы на
-месте, — и отпавшая задача от живой не отличается ничем. Прежде первой своей правки разведка
-повторяет то, на что задача жалуется: зовёт процедуру, читает отданный ответ, гоняет проверку,
-которая молчала. Симптом не воспроизвёлся — задача закрывается как отпавшая, и это законный её
-исход: чинить нечего, а зелёные проверки после такой правки говорят ровно об этом и ни о чём
-больше.
+задачи описывает дерево на день заведения, и чужие правки въезжают в главную ветку между
+заведением и работой: разведка по именам из тела подтверждает, что файлы на месте, — и отпавшая
+задача от живой не отличается ничем. Прежде первой своей правки разведка повторяет то, на что
+задача жалуется: зовёт процедуру, читает ответ, гоняет молчавшую проверку. Симптом не
+воспроизвёлся — задача закрывается отпавшей, и это законный её исход.
 
 **Следующее движение:** находки ложатся в разбор, и тем же ходом владельцу уходит первый из
 шести вопросов. Разведка кончилась — состояние осталось прежним, ход тоже.
@@ -68,9 +78,21 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 | Чем будет видно, что задача закрыта          | «работает» признаком не является                         |
 | Есть ли образец, с которого снимается подход | разведка найдёт похожее, а не то                         |
 
-Форму вопроса задают настройки владельца: где они требуют меню, спрашивается меню, и тогда к
-каждому вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
-Выбор слова, имени и термина уточняется прозой в любом случае.
+Список шести — набор того, что должно быть закрыто к началу работы, а не набор реплик, которые
+надо произнести. Обязательный вопрос, ответ на который владелец уже дал, отмечается закрытым, а
+не задаётся: ответ ищется в двух местах — в документации и в том, что владелец сказал в этом же
+заходе, включая исходную просьбу. Слово, повторённое в просьбе несколько раз, ответом является.
+Закрытый вопрос отмечается в разборе просьбы вместе с тем, чем он закрыт.
+
+Закрыть его можно и допущением, когда ответ очевиден: в разборе стоит строка «вопрос закрыт
+допущением: <что принято>». Неверное допущение стоит правки, вопрос ради очевидного — захода.
+
+Объём работы основанием для вопроса о границах не бывает: «это большая работа» решает
+исполнитель, «делать ли её целиком» — владелец, и решает раньше, чем работа началась. Вопрос о
+границах задаётся, когда владелец их не назвал, а не когда названные оказались широкими.
+
+Форму вопроса задают настройки владельца: где требуют меню, спрашивается меню, и к каждому
+вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
 
 **Рамка переданного текста на текущее дерево не переносится.** Передача захода, файл
 предложений и спек описывают то дерево, в котором писались. Про текущее знает только текущее:
@@ -121,6 +143,11 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 «не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
 исполняется молча и не считается закрытой правкой текста.
 
+Ход на этой границе не кончается. Закрытый разбор выглядит законченным куском: ответы владельца
+лежат на диске, файл закоммичен, отчитаться есть чем — и отчёт встаёт ровно на то место, которое
+должна была занять договорённость. Пишется она тем же ходом, конвейером ролей или рукой
+исполнителя, и разницы между этими двумя случаями для конца хода нет.
+
 **Следующее движение:** сверенная с разбором договорённость коммитится, и тем же ходом
 заводятся задача, ветка и папка — а вышла из разбора серия, сперва объявляется эпик.
 
@@ -155,6 +182,13 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 таблицы, с меткой эпика. Выданные номера возвращаются в ту же таблицу — колонкой или приставкой
 к названию, — и с этой минуты «взять следующую» отвечает номером, а не названием.
 
+Задача, заведённая под эпик, называет его в своём теле: номер карточки эпика и путь к замыслу —
+одной строкой. Замысел называет задачу со своей стороны, и односторонняя привязка выглядит целой
+ровно так же, как двусторонняя — читатель приходит то от линии работ, то от карточки, и вторая
+сторона существует только для одного из них. Держалась она подражанием: пока тело писалось с
+образца соседней задачи того же эпика, строка копировалась вместе с формой, а задача, заведённая
+посреди работы находкой сверки, писалась не с образца.
+
 **Следующее движение:** объявленный эпик коммитится вместе с номерами задач, и тем же ходом
 берётся первая его задача — заведением ветки и папки.
 
@@ -208,6 +242,13 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
 **Поведение:** меняется
 ```
 
+Дерево, у которого каталога «предложено» нет, называет договорённость самим спеком домена — там
+она пишется прямо в него, и переезжать при закрытии работы нечему:
+
+```markdown
+**Спек:** `docs/specs/bookings/spec.md`
+```
+
 Работа, не задевающая `apps/**` и `libs/**`, договорённости не требует:
 
 ```markdown
@@ -242,19 +283,16 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
 **Следующее движение:** первый этап делается тем же ходом, а закрытым он объявляется после
 того, как прошла его команда из строки «Чем проверяется».
 
-## Ловушки
+## Частые промахи
 
 - **Номер не бывает первым.** До конца разбора неизвестно даже, сколько задач из него выйдет:
   заведённая заранее задача после разбивки закрывается и остаётся мусором в очереди работ.
 - **Разбор пишется на диск сразу, а не копится в переписке.** Сессия обрывается, и разбор,
   прожитый в разговоре, восстанавливается только пересказом владельца.
 - **Из одного разбора вышло несколько задач — общее уезжает в замысел эпика.** Папка задачи
-  умирает с мержем, а порядок задач и зависимости между ними должны его пережить. Каталог для
-  замысла называет компаньон правила.
+  умирает с мержем, а порядок задач его переживает; каталог называет компаньон правила.
 - **Задача заводится командой, а не четырьмя вызовами подряд.** Борда к репозиторию не
   привязана, и задача попадает на неё только явным добавлением.
 - **Slug ветки берётся из терминологии договорённости, а не из слов просьбы.** Договорённость
-  пишется раньше ветки и как раз там отказывается от слова владельца: спек завёл своё имя
-  предмету и прямо сказал, каким словом его не называть, — а ветка и папка задачи остались с
-  отвергнутым. Заголовок задачи и PR поправить можно, имя ветки после открытия PR —
-  уже нет.
+  пишется раньше ветки и как раз там отказывается от слова владельца. Заголовок задачи и PR
+  поправить можно, имя ветки после открытия PR — уже нет.

package/assets/patterns/testing-e2e.md

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

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

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