@rt-tools/agent-kit 0.20.0 → 0.22.0

package/assets/laws/frontend-application.md

@@ -26,6 +26,16 @@
   рабочим и молча ничего не делает.
 - **Набор записей приходит с сервера страницей, а не целиком.** Список, растущий вместе с
   данными, однажды перестаёт открываться, и заметно это становится уже у пользователя.
+- **У значения, положенного приложением в браузер, есть род: устройство либо вошедший.**
+  Хранилище браузера переживает и перезагрузку, и выход, и смену того, кто вошёл; род решает,
+  снимается ли значение при выходе. По имени ключа он не виден: язык интерфейса принадлежит
+  устройству, выбранная рабочая область — вошедшему, и по именам они неразличимы. Умолчания у
+  рода нет тоже: оставленное значение сеанса отдаёт следующему вошедшему чужой выбор, а снятая
+  настройка устройства заставляет выбирать язык при каждом входе. Значит род называет человек, и
+  называет до того, как ключ заведён.
+- **Значения сеанса снимает то же место, которое снимает вход.** Уход по истёкшему входу идёт
+  мимо кнопки выхода, и ключ, снятый своим экраном, остаётся лежать — то есть достаётся
+  следующему вошедшему на этом устройстве.
 - **Окружение, которого нет на сервере, приходит экрану извне, а не берётся у среды.**
   Взятое напрямую, оно компилируется и падает при отдаче страницы сервером — то есть у гостя,
   а не у того, кто это написал. Места, где иначе нельзя, названы поимённо.

package/assets/laws/work-conduct.md

@@ -32,6 +32,11 @@
   «здесь нет», «этого не заводили», «такого файла не бывает» — произносится только как вывод
   команды. Не проверенное отрицание опаснее вопроса: вопрос владелец поправит, а факт от
   исполнителя примет на веру, потому что тот в дерево смотрит.
+- **Пустой вывод утверждением не бывает.** Он значит либо «ноль строк», либо «спрошено не то», и
+  различает эти два только повторный вызов — без конвейера и без глушения потока ошибок: в
+  конвейере код возврата принадлежит последнему звену, а заглушённый поток уносит текст промаха.
+  Пока такой вызов не сделан, о дереве не сказано ничего, а «ничего нет» — самая дорогая из
+  возможных ошибок: она отменяет работу, которую владелец велел сделать.
 - **Отрицание, полученное одним источником, отрицанием не является.** Ответ «не найдено», отказ в
   доступе и пустой список говорят о правах спрашивающего, а не о предмете: тот же вопрос, заданный
   оттуда, где предмет виден, отвечает обратным. Сказать «этого нет» можно только после второго
@@ -50,6 +55,9 @@
   просьбы, даже когда свой даёт тот же ответ: равноценность инструментов решает тот, кто просит.
   Одинаковый результат равноценностью не является — у названного инструмента бывает видно то,
   чего у заменителя нет вовсе.
+- **Случившаяся подмена называется в том же докладе.** Чем сделано вместо названного и почему —
+  двумя словами, рядом с ответом на просьбу. Без этой строки владелец узнаёт о подмене, повторяя
+  указание: к той минуте работа по нему уже сделана не тем, и заплачено за неё дважды.
 - **Понимание записано там, где идёт работа.** Оставленное в переписке живёт у одного участника и
   до следующего дня; работу продолжает тот, у кого этой переписки нет.
 - **Сказанное владельцем записывается его словами и задним числом не переписывается.** Пересказ

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

@@ -54,15 +54,26 @@ npx nx build admin --base-href=/
 Angular DevTools, нужна ещё и dev-конфигурация (`--configuration=development`): прод-сборка не
 публикует `window.ng`. Выводы о размере бандла и минификации на такой сборке делать нельзя.
 
-Сессия кладётся в `localStorage['<ключ сессии админки>']` **строкой JSON** (`JSON.stringify(token)`),
-иначе приложение её не прочитает. Токен не подписывается руками, а берётся у живого API:
-`POST /<область>.v1.AuthService/Login`. Команду с паролем классификатор блокирует — обходить не
-надо, спрашивать разрешение у владельца.
-
-Взять уже открытую сессию нельзя: чтение того же ключа из браузера
-блокируется. Оба пути к своему стенду упираются в пароль, поэтому остаётся третий — смотреть
-на админке владельца, где вход уже сделан. Свой стенд нужен, только когда проверяют
-прод-сборку, `--base-href` или конфиг nginx; чтобы просто посмотреть экраны, он не нужен.
+Собранное отдаётся прокси дерева с его настоящим конфигом, а не статическим сервером. Причин
+две, и обе всплывают в первую минуту: приложение ходит за процедурами на свой же origin, а по
+глубокой ссылке статический сервер отвечает `404` — маршрутов одностраничного приложения он не
+знает и на его точку входа не откатывается. Гард дев-серверов такой сервер отбивает наравне с
+`nx serve`, и это указание на верный ход, а не помеха: готовый вызов — раздел «Стенд под
+настоящим nginx» ниже, он и отдаёт собранное, и проксирует процедуры.
+
+Вход делается формой, как у человека. Учётная запись местной базы разработки — не секрет
+владельца: её кладёт туда засев того же дерева, а пароль лежит в файле окружения рядом.
+Разрешения на неё не спрашивают — спрашивают про боевую запись, а её на местном стенде не
+бывает вовсе. Там, где приёмника рядом нет, ответ входа подменяет сам стенд: путь у приложения
+остаётся тот же, что у человека.
+
+Токен руками не подписывается и в хранилище браузера руками не кладётся: положенный так, он
+проверяет экран, миновав живой путь входа, — то есть отвечает не на тот вопрос. Просьба к
+человеку набрать пароль, открыть вкладку или нажать кнопку означает неверно выбранный путь, а
+не нехватку прав у исполнителя.
+
+Стенд владельца запасным путём не бывает: он собирает главную ветку и о правке в рабочем дереве
+не говорит ничего.
 
 ## Стенд API
 
@@ -163,6 +174,10 @@ done
   это по её длительности.
 - Свой дев-сервер не поднимать: сайт на {{sitePort}}, админка на {{adminPort}}, API на {{apiPort}} уже подняты
   владельцем, и второй экземпляр отбивается гардом.
+- **Отбитый статический сервер читается как запрет проверки, а он указание на верный ход.**
+  Отдавать собранное им нельзя не из осторожности: приложение ходит на свой origin, а глубокая
+  ссылка отвечает `404`. Отсюда идут не к обходу гарда, а к прокси дерева с его настоящим
+  конфигом.
 - **Дев-сервер владельца — место, где смотрят, а не место, где проверяют.** Вывод о том, что
   экран верен, делается на прод-сборке за настоящим прокси: разметка от сервера, локали, кэш,
   перенаправления и заголовки на дев-сервере либо другие, либо отсутствуют вовсе. Взгляд на

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

@@ -94,10 +94,14 @@ GH_TOKEN="$TOKEN" gh pr create --title '[<КЛЮЧ>-86] Письмо владе
 /opt/homebrew/bin/gh issue view 86 --json labels --jq '.labels | map(.name) | join(",")'
 ```
 
-Строка `Closes #<номер>` обязательна: без неё PR не прикрепляется к задаче, и сверка очереди
-это находит. Она же и означает, что задача закрывается целиком — половину задачи одним PR не
-выкатывают: у задачи одна ветка, и работа, которая в неё не влезает, делится на задачи до
-того, как ветка заводится.
+Строка `Closes #<номер>` обязательна: без неё PR не прикрепляется к задаче, и сверка очереди это
+находит. Она же означает, что задача закрывается целиком — половину задачи одним PR не выкатывают:
+работа, которая в одну ветку не влезает, делится на задачи до того, как ветка заводится.
+
+Отказ о превышенной квоте языка запросов (`API rate limit already exceeded`) заявки не заводит
+вовсе; открытие идёт тогда вызовом REST — `$GH api -X POST "repos/$REPO/pulls" -f head=… -f
+base=… -f title=… -F body=@<файл>`, — а метки и ревьювер ставятся следом. Текст такого отказа
+читается как временный, но квота у записи не исчерпана, а равна нулю: ждать нечего.
 
 У уже открытого PR то же ставится тремя вызовами REST. `gh pr edit` здесь не годится: он
 запрашивает карточки Projects (classic), получает отказ о снятом API и до правки не доходит.
@@ -177,11 +181,10 @@ $GH api "repos/$REPO/pulls/321" \
 назначить автора ревьювером нельзя, а отказа на такой запрос не приходит. Владельцу называют
 то, что прочитали, а не то, что заказывали.
 
-Прочитанное расхождение имеет назначенное действие, а не остаётся наблюдением: автора у заявки
-не сменить, правкой это не чинится. Заявка закрывается и открывается заново токеном машинной
-записи — с переносом тела, меток, ревьювера и исполнителя. Номер при этом сменится, и строки,
-которые ссылались на прежний, переписываются тем же ходом. Развилка, вынесенная тут владельцу,
-означает, что порядок поставки прочитан и не исполнен: ход отсюда один.
+Прочитанное расхождение имеет назначенное действие: автора у заявки не сменить, и она
+закрывается и открывается заново токеном машинной записи — с переносом тела, меток, ревьювера и
+исполнителя. Номер сменится, и ссылки на прежний переписываются тем же ходом. Развилка, вынесенная
+тут владельцу, означает, что порядок поставки прочитан и не исполнен.
 
 Учётная запись, из-под которой пришлось пушить, в этот вызов не переносится: пуш и авторство
 PR выбираются отдельно, и `GH_TOKEN` для публикации — всегда токен бота.
@@ -191,10 +194,16 @@ PR выбираются отдельно, и `GH_TOKEN` для публикац
 фразой владелец успевает влить PR, и всё сказанное о нём после этого — про вчерашний день. Так
 владельцу и было предложено влить то, что он влил часом раньше.
 
-Читается состояние и перед пушем в ветку, у которой есть заявка, а не только перед словом о
-ней. Влитая заявка означает, что ветки на сервере уже нет: пуш её не обновит, а заведёт заново,
-и вклад останется вне главной ветки. Ответ пуша говорит это одной строкой — отметкой о новой
-ветке вместо перечня коммитов, — и её читают: на удачную отправку такой ответ похож целиком.
+Читается состояние и перед пушем в ветку, у которой есть заявка. Влитая заявка означает, что
+ветки на сервере уже нет: пуш её не обновит, а заведёт заново, и вклад останется вне главной
+ветки. Ответ пуша говорит это отметкой о новой ветке вместо перечня коммитов — на удачную
+отправку он похож целиком.
+
+**Итог прогона читается отдельным вызовом, а не кодом возврата ожидания.** Команда клиента,
+которая ждёт конца прогона, возвращает ноль и на красном: дождалась она конца, а не успеха.
+Прочитанный как исход, этот ноль делает зелёным то, что упало, и сказанное владельцу о зелёном
+прогоне оказывается про красный. Состояние и заключение прогона спрашивают своим вызовом — тем
+же, каким читают состояние заявки.
 
 Открытый PR означает, что задача ждёт разбора, — колонка переставляется тем же движением:
 
@@ -212,13 +221,11 @@ npm run task:move -- 86 in-review
 гоняет ничего. Линтеры, юниты и сценарии хуков снимает гейт пуша — ниже то, чего он не знает.
 
 1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
-   Свежесть основания между ветками одного захода не наследуется: вторая и третья ветка
-   отводятся после своего `fetch`, а не от ссылки, подтянутой под первую. Пока идёт работа,
-   главная уходит вперёд — чаще всего собственным PR того же исполнителя, влитым час
-   назад.
-   Всё, что проверяется ниже, проверяется от этого основания: PR с разошедшейся ветки
-   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
-   `git-workflow-merge`.
+   Свежесть основания между ветками одного захода не наследуется: вторая и третья отводятся
+   после своего `fetch`, а не от ссылки под первую. Пока идёт работа, главная уходит вперёд —
+   чаще всего собственным PR того же исполнителя. Всё, что проверяется ниже, проверяется от
+   этого основания: PR с разошедшейся ветки показывает ревьюверу правку вперемешку с чужой.
+   Порядок и разбор конфликта — паттерн `git-workflow-merge`.
 2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
    домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
 3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
@@ -281,8 +288,8 @@ in-review`, — и `npm run check:board` прогоняется ещё раз:
 - Второй строкой `Closes` в одном PR задача больше не закрывается: две задачи в одной ветке
   откатываются только вместе. Либо это одна задача — и вторая поглощается, — либо две ветки.
 - Половина задачи, уехавшая своим PR, тоже промах: тело такого PR начинается со слов «Часть
-  #<номер>» вместо `Closes`, задача остаётся открытой, и после отката видно её целой. Работа,
-  которая в одну ветку не влезает, делится на задачи до того, как ветка заводится.
+  #<номер>» вместо `Closes`, и задача остаётся открытой. Работа, которая в одну ветку не
+  влезает, делится на задачи до того, как ветка заводится.
 - PR открыт без ревьювера: он не попадает во входящие владельца вовсе, и очередь стоит,
   выглядя работающей. Так шестнадцать PR ждали разбора, которого никто не запрашивал.
 - Метки поставлены по названию PR, а не прочитаны у задачи: область теряется, и по борде не

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

@@ -108,6 +108,11 @@ docs/specs/<домен>/
 Тогда отказ подаётся владельцу как занятые даты, а не как ошибка базы
 ```
 
+**«Тогда» называет один исход.** Формулировка через «либо» описывает два устройства сразу, и
+какое из них работает, по сценарию не узнать: сценарий зелен при любом. Развилка описывается
+двумя сценариями с разным «Дано» — тогда смена поведения роняет ровно тот из них, который
+перестал быть верным, а не проходит молча.
+
 Идентификатор ставится в начало заголовка теста, через тире. Сценарий без теста помечается
 `Не покрыто: <причина>`, сценарий с неполным тестом — `Покрытие: частичное — <чего не
 хватает>`.

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

@@ -86,6 +86,11 @@ description: Правило под «Закон о поставке». Брат
 пустой она не бывает. Выводить требование из фразы в тексте нельзя: разложено у потребителя не
 всё, и текст, сказавший «правку отбивает гард», врёт в дереве, где гарда нет.
 
+Читается строка списком идентификаторов ресурсов, поэтому проза в ней превращается в требования,
+которых нет: «требует команду строки запуска и токен дерева» раскладка разбирает на два имени и
+печатает оба неотвеченными — в её выводе такие строки неотличимы от настоящей нехватки.
+Требование объявляется идентификатором ресурса либо не объявляется вовсе.
+
 Разделы: `## Как это называется здесь` · `## Где это лежит` · `## Как закон применяется
 здесь` · `## Чего из закона здесь нет` · `## Паттерны` · `## Ловушки`.
 
@@ -114,7 +119,26 @@ description: Паттерн правила git-workflow. Брать … Не б
 ---
 ```
 
-Разделы: `## Когда брать` · готовый код · `## Частые промахи`. Привязки у паттерна нет:
+Разделы: `## Когда брать` · готовый код · `## Как пишется сама статья
+
+**Довод при статье называет устройство, на котором он верен.** Довод стареет вместе с тем, что
+его вызвало: запрет писать в чужую настройку стоял на том, что слияние JSON молча теряет
+несовпавшее, — и был верен, пока куском была карта из двух десятков объявлений. Пришёл
+диспетчер, кусок стал строкой на событие, довод перестал быть верным, а стоял ещё две редакции
+и читался действующим запретом. Названное устройство — то, по чему при следующей правке видно,
+что довод пора перечитать.
+
+**Требование к шагу стоит в том разделе, который этот шаг ведёт.** Написанное ниже читается
+после шага: раздел об оставшемся шаге требовался и прежде, и образцы стояли готовые, — но само
+требование лежало ниже описания открытия заявки. Читающий доходил до открытия, открывал заявку
+и требования ещё не видел; выглядит это забывчивостью, а не порядком текста.
+
+**Статья о непроверяемом называет, какое именно средство её не берёт.** «Проверить машиной
+нечем» стареет вместе с тем, чем проверяли: тело заявки не читает сверка очереди работ — и это
+было записано как «не читает никто», хотя гард поставки разбирает ту же строку команды и по ней
+судит заголовок. Названное средство даёт следующей правке точку, от которой отсчитывать.
+
+## Частые промахи`. Привязки у паттерна нет:
 проверка его не сверяет, потому что сверять готовый код с ним самим нечем.
 
 ## Описание: триста знаков и один вопрос
@@ -183,6 +207,19 @@ description: Паттерн правила git-workflow. Брать … Не б
 
 ## Частые промахи
 
+- Проверка требования «шаг делается» поставлена на вызов самого шага. Гард, привязанный к
+  вызову, ловит форму сделанного и не видит несделанного вовсе: снятие черновика, которого не
+  было, не даёт ему ни одного события. У такого требования проверка стоит на завершении хода —
+  там видно, чего за ход не случилось.
+- Привязка называет одно место исполнения, а исполняют утверждение несколько сторон. Сверка
+  смотрит наличие строки, а не полноту списка: договорённость обещала объявление нескольких
+  событий, привязка вела в сборку настройки, а диспетчер читал одно — и молчали обе стороны.
+  Статья, чьё утверждение исполняют несколько мест, называет их все.
+- Список, названный деревом, лежит в компаньоне, а общий довод — в самом правиле. В контекст
+  общий довод приходит всегда, а список — только когда его прочитали, и проигрывает он в ту же
+  минуту, когда решение принимают по памяти. Всякий раз, когда правило требует «список назван
+  деревом», оно требует и того, чтобы список читали раньше общих слов, — и говорит это прямо.
+
 - Закон назвал файл проекта — проверка отбивает. Путям место в правиле.
 - Спутник с привязкой лежит рядом с законом: он привязывает закон к этому проекту, а зелёная
   проверка это утвердит, потому что структура совпадёт с тем, чего проверка сама и ждёт.
@@ -190,6 +227,9 @@ description: Паттерн правила git-workflow. Брать … Не б
   правку сущности оказались привязаны к механике, которую не зовёт ни один экран.
 - Утверждение переформулировали, а строку в привязке не тронули: связь идёт по тексту, и
   проверка перестанет её находить.
+- Пустая привязка отбивается сверкой спеков, и вердикт для неё нужен дословный: принимаются
+  «Не исполняется», «Не применимо», «Не проверяется». Фраза своими словами — «держится текстом»,
+  «проверяется глазами» — вердиктом не считается, и узнаётся это отказом сверки.
 - Строка привязки дописана в конец компаньона, а не вставлена в таблицу. После таблицы там идут
   ещё разделы — «Чем это проверяется», «Что ещё стоит знать при чтении кода», — и приписанная в
   конец строка в таблицу не попадает вовсе: утверждение читается непривязанным, а сверка спеков

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

@@ -199,6 +199,18 @@ npm run cargo:mark -- --state fixed \
 правит ссылки во всех текстах, которые на неё смотрят, ради ровного ряда имён. Порядок между
 частями не нужен — находки друг друга не продолжают, и владелец читает их разом.
 
+**Строка находки, закрытой другой работой, помечается номером той работы.** Починенная по
+частям находка со стороны списка неотличима от несделанной: оба её промаха были закрыты своими
+задачами и записаны предметно, каждый при своём поддомене, — а разбор ушёл на то, чтобы
+выяснить, что чинить нечего. Номер стоит в самой строке, и следующий читатель этого пути не
+проходит.
+
+**Пункт сборной находки проверяется на живость до того, как берётся в работу.** Мелочи,
+списанные в один пункт, не стареют вместе: из четырёх промахов живыми оказались два, один был
+закрыт другой работой, четвёртый не воспроизводился — и разведка этого заняла больше времени,
+чем сами правки. Сборная задача поэтому стоит ровно столько, сколько разведка её состава, и
+это говорится владельцу до того, как её берут.
+
 **Наружу без слова владельца уезжает только сводка наблюдений.** Она говорит, чем пользовались
 и чем не пользовались ни разу, — это факт, и мнением он не станет. Предложение — другое дело:
 это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении. Уехавшая

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

@@ -59,13 +59,26 @@ description: Паттерн правила turn-conduct. Брать, когда
 
 ### Передача
 
-Кладётся вне дерева, одним файлом на ветку — каталог передачи называет профиль дерева:
+Кладётся разделом `## Передача захода` в ход работы задачи — в тот же файл, где стоит «Где
+стоим». Он коммитится и едет в ветку, поэтому передача переживает переход на другую машину:
+работу, оборванную заполнением окна, подхватывают там, где её продолжают. Коммитит и пушит
+раздел исполнитель, тем же ходом, что и остальную запись работы.
+
+Раздел один: второе сжатие переписывает прежний, а не дописывает второй — две правды об одной
+работе в одном файле хуже одной устаревшей. Заголовки внутри него идут третьим уровнем, чтобы
+не сталкиваться с разделами самого хода работы.
+
+У работы без папки задачи — отсоединённая голова, ветка без заведённой задачи — разделу лечь
+некуда, и передача уезжает файлом вне дерева; каталог называет профиль:
 
 ```bash
 mkdir -p <каталог передачи>
 # файл — <каталог передачи>/<ветка>.md
 ```
 
+Это запасной путь, а не второе законное место: у ветки с папкой задачи такой файл не заводится
+вовсе, и читающая сторона его не смотрит, найдя раздел.
+
 **Черновик передачи пишет хук, а не рука.** Перед сжатием контекста он кладёт по тому же
 адресу то, что есть на диске: ветку, состояние работы, следующий шаг, незакоммиченное, коммиты
 сверх главной. Сжатие приходит и тогда, когда напомнить некому — ночью или посреди длинного

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

@@ -32,6 +32,17 @@ description: Паттерн правила task-flow. Брать при возв
 замечаниям разбора — папка восстанавливается на время правки, а разбор повторяется тем же
 коммитом.
 
+## Признак этапа проверяется прогоном, а не перечислением по чтению
+
+Пересчитанное глазами расходится с тем, что есть: читая проверку, исполнитель насчитал четыре
+выхода пропуском, а их было пять — пятый лежал за отдельной функцией внутри обвязки клиента
+базы и в перечень не попал. Нашёлся он прогоном, и спасла работу именно та строка замысла,
+которая требовала проверить каждый случай командой.
+
+Отсюда форма признака: он называет команду и то, что в её выводе означает «сошлось», — а не
+перечень, собранный чтением. Перечень годится, чтобы понять, где смотреть; закрытым этап
+делает вывод команды.
+
 ## Чего не делать
 
 - **Не спрашивать владельца о том, что записано.** Ради этого всё и заведено.

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

@@ -45,12 +45,11 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 записи прошлых заходов. Одно место отрицанием не является: «в таком-то месте не нашёл» говорит о
 месте, а не о дереве, и вопрос называет оба способа, которыми искали.
 
-Разведка кончается не ощущением, а выводом команд. До первого вопроса владельцу исполнитель
-знает: как устроен репозиторий (корневая памятка), что лежит в каталоге, о котором пойдёт речь
-(`ls`), и есть ли уже написанное по теме (поиск по документации и правилам). «Не знаю»
-проверяемым не бывает. Без списка того, что считается сделанным, разведка исполняется как
-настроение: прочитанный переданный текст сходит за неё, и по текущему дереву не запускается ни
-одной команды.
+Разведка кончается не ощущением, а выводом команд. До первого вопроса владельцу исполнитель знает:
+как устроен репозиторий (корневая памятка), что лежит в каталоге, о котором пойдёт речь (`ls`), и
+есть ли уже написанное по теме (поиск по документации и правилам). Без списка того, что считается
+сделанным, разведка исполняется как настроение: прочитанный переданный текст сходит за неё, и по
+дереву не запускается ни одной команды.
 
 Разведка по заведённой задаче кончается воспроизведённым симптомом, а не найденным файлом. Тело
 задачи описывает дерево на день заведения, и чужие правки въезжают в главную ветку между
@@ -94,11 +93,10 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 Форму вопроса задают настройки владельца: где требуют меню, спрашивается меню, и к каждому
 вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
 
-**Рамка переданного текста на текущее дерево не переносится.** Передача захода, файл
-предложений и спек описывают то дерево, в котором писались. Про текущее знает только текущее:
-прежде чем принять из такого текста утверждение о раскладке, оно проверяется командой здесь.
-Подтверждение при этом находится само — признаки дерева, только ставящего пакет, стоят и у
-дерева, которое пакет и пишет, и ставит.
+**Рамка переданного текста на текущее дерево не переносится.** Передача захода, файл предложений
+и спек описывают то дерево, в котором писались; про текущее знает только текущее, и утверждение о
+раскладке проверяется командой здесь. Подтверждение находится само — признаки дерева, только
+ставящего пакет, стоят и у того, которое пакет пишет и ставит.
 
 Сообщение, которым исполнитель останавливается, начинается с того, чего он ждёт:
 
@@ -108,12 +106,12 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 ```
 
 Под вопросом идёт таблица положения эпика — та же, что в передаче. Под, а не над: остановка
-называется первой строкой, и положение эпика — то, из чего владелец решает, а не то, о чём его
-спрашивают. Работа вне эпика таблицы не несёт.
+называется первой строкой, а положение эпика — то, из чего владелец решает. Работа вне эпика
+таблицы не несёт.
 
-Замеры, находки ролей и список решений к этому моменту уже записаны в ход работы, и в
-сообщении владельцу они лишние. Отчёт, в конце которого стоит вопрос, выглядит добросовестно
-ровно настолько, насколько надёжно вопрос в нём тонет.
+Замеры, находки ролей и список решений к этому моменту записаны в ход работы, и в сообщении
+владельцу они лишние: отчёт, в конце которого стоит вопрос, выглядит добросовестно ровно
+настолько, насколько надёжно вопрос в нём тонет.
 
 Ответы пишутся в `docs/tasks/_draft-<slug>/grill.md` — папка ещё черновик, номера нет.
 
@@ -153,9 +151,9 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 
 ### Состояние `договорённость-записана`: серия задач объявляется эпиком
 
-Разбор кончился одной задачей — шаг пропускается. Вышло несколько, и порядок между ними
-значим — эпик объявляется здесь, до первой из них, и дважды: карточкой в очереди работ с меткой
-эпика и замыслом эпика рядом с ней.
+Разбор кончился одной задачей — шаг пропускается. Вышло несколько, и порядок между ними значим —
+эпик объявляется здесь, до первой из них, и дважды: карточкой в очереди работ с меткой эпика и
+замыслом рядом с ней.
 
 Замысел эпика называет три вещи, и ни одна не выводится из остальных:
 
@@ -171,12 +169,11 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 ```
 
 Состав без порядка порядком не является: две задачи, у которых он держался пониманием, ушли в
-работу наоборот, и вторая переделывалась под первую. Назначенный здесь порядок держится до конца
-эпика; пересмотр — решение владельца, и записывается он в ход работы той задачи, которая его
-вызвала.
+работу наоборот, и вторая переделывалась под первую. Назначенный порядок держится до конца эпика;
+пересмотр — решение владельца, и пишется он в ход работы той задачи, которая его вызвала.
 
-Лежит замысел вне папки задачи: та умирает с мержем первой же задачи. Каталог для него называет
-компаньон правила — у пакета своего пути нет.
+Лежит замысел вне папки задачи: та умирает с мержем первой же. Каталог для него называет компаньон
+правила — у пакета своего пути нет.
 
 Карточки заводятся на все задачи разом, здесь же: по вызову заведения задачи на каждую строку
 таблицы, с меткой эпика. Выданные номера возвращаются в ту же таблицу — колонкой или приставкой
@@ -200,20 +197,24 @@ git checkout -b <КЛЮЧ>-<номер>-<slug>
 npm run task:move -- <номер> in-progress
 ```
 
+Тело приходит файлом и пустым не бывает: заведённая пустой задача не говорит ничего ни
+исполнителю, ни владельцу, а дописать её потом можно только со слова владельца — и заводится
+пустое молча, номером наравне с полным.
+
 `task:new` переименовывает `_draft-<slug>` в `<КЛЮЧ>-<номер>-<slug>` и проставляет шапку замысла.
 Ветка заводится вторым вызовом: составную «завести и сразу коммитить» гард главной ветки
 отклоняет целиком.
 
-Номер уже выдан — черновика нет и не заводится: папка задачи открывается сразу под именем
-ветки, а разбор пишется в неё же. Так начинается половина работ: номер приходит прошлым
-заходом, замеченным дефектом или соседней задачей, и шаг с черновиком в этом случае неисполним
-целиком — переименовывать нечего, `task:new` звать незачем. Ловушка «номер не бывает первым»
-сюда не относится: она про то, что задачу не заводят до разбора, а не про то, что с уже
-заведённой нельзя работать.
+Номер уже выдан — черновика нет и не заводится: папка открывается сразу под именем ветки, а
+разбор пишется в неё же. Так начинается половина работ: номер приходит прошлым заходом,
+замеченным дефектом или соседней задачей, и шаг с черновиком тогда неисполним — переименовывать
+нечего. Ловушка «номер не бывает первым» сюда не относится: она про то, что задачу не заводят до
+разбора, а не про то, что с уже заведённой нельзя работать.
 
-Остальные два файла пишутся, а не кладутся образцом впрок: пустой `plan.md` на диске
-неотличим от замысла, у которого нет этапов, — а следующий заход читает папку задачи первым
-делом и доверяет ей. Образец открывается тем же движением, которым заполняется:
+Остальные два файла пишутся, а не кладутся образцом впрок: пустой `plan.md` неотличим от
+замысла без этапов, а следующий заход доверяет папке задачи. Образец открывается тем же
+движением, которым заполняется, и шапку раскладки с копии снимают тут же — иначе правку отобьёт
+гард, а ловушка при правиле объясняет почему:
 
 ```bash
 cp docs/tasks/_template/plan.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/plan.md      # и сразу пишется
@@ -229,8 +230,8 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
 Пока не объявлено состояние, в котором код правится, гард отбивает правку и называет
 обязательное действие того состояния, которое стоит в строке.
 
-**Следующее движение:** объявив состояние, тот же ход берётся за замысел — начиная с его
-шапки. Заведённая папка ходом не кончается: в ней ещё нет ни одного написанного файла.
+**Следующее движение:** объявив состояние, тот же ход берётся за замысел с его шапки. Заведённая
+папка ходом не кончается: написанного файла в ней ещё нет ни одного.
 
 ### Состояние `задача-взята`: шапка замысла
 
@@ -270,11 +271,10 @@ cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/pr
 - **Этап:** 1 из 3 — <название первого этапа из замысла>
 ```
 
-Ход на этой границе не кончается. Написанный замысел выглядит законченным куском: этапы
-разложены, файл закоммичен, отчитаться есть чем — и отчёт встаёт ровно на то место, которое
-должна была занять работа. Владелец читает такой отчёт как сделанное, а сделано ничего. Так
-и вышло 21 августа: заход кончился строкой «следующий шаг — такой-то» при заполнении окна около
-двух процентов.
+Ход на этой границе не кончается. Написанный замысел выглядит законченным куском: этапы разложены,
+файл закоммичен, отчитаться есть чем — и отчёт встаёт ровно на то место, которое должна была
+занять работа. Владелец читает его как сделанное, а сделано ничего: 21 августа заход кончился
+строкой «следующий шаг — такой-то» при заполнении окна около двух процентов.
 
 Кончают ход четыре вещи, и они те же, что у остальных состояний: предел заполнения окна, отказ
 гарда, вопрос владельцу и отданная работа, по которой начата следующая. Дочитанный до конца

package/assets/patterns/testing-e2e.md

@@ -90,6 +90,21 @@ expect(answer.headers()['location']).toBe('/новый-адрес');
 Отличать постоянный переход от временного нужно там, где на нём стоит договорённость: поисковые
 роботы и браузер запоминают только постоянный, и разница между 301 и 302 видна лишь в ответе.
 
+## Состояние экрана после действия ждётся опросом, а не читается следующей строкой
+
+Между нажатием и новым содержимым лежит сеть: отбор уходит в адрес нажатием, а строки приезжают
+ответом сервера, и прочитанные сразу — ещё прежние. Спека, читающая столбец следующей строкой,
+проходит на своей машине и краснеет в конвейере: там ответ приходит позже, и разница между
+машинами решает исход.
+
+Ждётся поэтому само состояние — опросом до совпадения с ожидаемым, а не одним чтением и не
+паузой на время. Пауза проверяет машину: на свободной её хватает всегда, на занятой не хватает,
+и какая именно спека не успела, оказывается делом случая.
+
+Знание это заводится в правиле, а не в общем модуле набора: записанное только кодом, оно
+известно тому, кто его писал, — следующая спека повторяет промах, потому что читает не код, а
+правило.
+
 ## Частые промахи
 
 - **Порт {{ssrPort}} занимать осторожно:** стенд разработчика на {{sitePort}} ходит по тому же имени

package/assets/patterns/testing-unit.md

@@ -106,6 +106,19 @@ globalThis.fetch = (): Promise<Response> => Promise.resolve(Response.json({ succ
 заголовке и едет в ветке. Признак временного файла — его заголовок не называет ни одного
 сценария.
 
+## Зелёное, которое ничего не проверяет
+
+**Проба, ждущая молчания, идёт в паре с пробой, ждущей отказа.** Молчание наступает и тогда,
+когда проверять было нечем: приставка перед командой в конвейере действует на одно звено, и
+хук, получивший пустое значение, молчит ровно так же, как хук, которому нечего отбивать. Две
+пробы из трёх при этом зелены — они и ждали молчания, — и промах виден только по третьей,
+которая ждёт отказа.
+
+**Проба на мину, которая не срабатывает, зелена и без починки.** Сценарий на таблицу кодов
+отказа у спека без процедур проходил бы и до правки: читать эту таблицу сверке не приходится
+вовсе. Проверяется такая проба обеими сторонами — прежнее состояние возвращается на минуту и
+прогоняется: не покраснело, значит проба ничего не сторожит.
+
 ## Частые промахи
 
 - Либа без своего `vitest.config.mts`: `nx test <проект>` пройдёт зелёным, не запустив ни

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

@@ -219,8 +219,21 @@
   ни статус, ни сверка, а команда, прошедшая между прятаньем и возвратом, пишет в те же файлы —
   и возврат встаёт конфликтом. Так ушли в прятанье восемь незакоммиченных файлов при живом
   запрете на эту команду: запрет читался в начале захода, а команда набиралась через сорок ходов.
+- **Вывод команды, которой нужен репозиторий, собирается в каталоге репозитория.**
+  Перенаправление создаёт файл раньше, чем команда успевает отказать: клиент хостинга, позванный
+  из каталога временных файлов, падает строкой о том, что это не репозиторий, а пустой файл к
+  этой минуте уже записан. Уехав дальше — в тело заявки, в замысел, в правило, — он стирает
+  написанное, и восстанавливается это только историей правок на стороне хостинга. Файл вывода
+  поэтому кладётся в дереве, а записанное проверяется до того, как его куда-то отправят.
+
 - **Очередь конвейера, заведённая на всё дерево, снимает ждущего чужим пушем.** Группа
   одновременности с отменой уже идущего экономит машину ровно до первого соседа: его пуш снимает
   прогон чужой ветки, и та остаётся с вершиной без единого прогона — заявка при этом выглядит
   непроверенной, а прогонять её заново некому. Группа поэтому заводится своя на ветку, и общей
   остаётся только у шагов, которым нужен стенд: их и правда нельзя гнать вдвоём на одной машине.
+
+- **Команды дерева зовутся из его корня, а не из каталога пакета.** В подкаталоге со своим
+  манифестом запуск берёт его, а не корневой, и отвечает «такой команды нет» — при том что в
+  дереве она есть и написана верно. Читается это как поломка команды, а лечится каталогом: путь
+  до неё называется от корня, и звать её оттуда.
+