@rt-tools/agent-kit 0.14.0 → 0.16.0

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

@@ -2,7 +2,7 @@
 name: git-workflow-pr
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow. Брать на открытие PR и всё, что с ним связано, — формат заголовка, черновик и его снятие, строка связи с задачей, ревьювер, исполнитель и метки, образец тела с разделом об оставшемся шаге, чтение состояния PR, перевод задачи в колонку разбора, чеклист проверок до снятия черновика. Не брать на заведение задачи, ветки и коммит — это паттерн git-workflow-commit.
+description: Паттерн правила git-workflow. Брать на открытие PR и всё, что с ним связано: формат заголовка, черновик и его снятие, связь с задачей, ревьювер и метки, образец тела, чтение состояния PR, чеклист проверок. Заведение задачи и коммит — паттерн git-workflow-commit.
 ---
 
 # Заявка на слияние

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

@@ -2,7 +2,7 @@
 name: git-workflow-pr
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow. Брать на открытие MR и всё, что с ним связано, — формат заголовка, черновик и его снятие, строка связи с задачей, ревьювер и метки, образец описания с разделом об оставшемся шаге, чтение состояния MR, перевод задачи в список разбора, чеклист проверок до снятия черновика. Не брать на заведение задачи, ветки и коммит — это паттерн git-workflow-commit.
+description: Паттерн правила git-workflow. Брать на открытие MR и всё, что с ним связано: формат заголовка, черновик и его снятие, связь с задачей, ревьювер и метки, образец описания, чтение состояния MR, чеклист проверок. Заведение задачи и коммит — паттерн git-workflow-commit.
 ---
 
 # Заявка на слияние

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

@@ -2,7 +2,7 @@
 name: git-workflow-restart
 kind: pattern
 rule: deploy-flow
-description: Паттерн правила deploy-flow. Брать при ручном перезапуске прода — после правки .env.prod, при разборе выкатки, при подъёме контейнера на сервере. Готовые команды с IMAGE_TAG по sha, способ узнать выкаченный sha и чем сверять результат. Не брать для коммита и миграций — это паттерны git-workflow-commit и git-workflow-migration.
+description: Паттерн правила deploy-flow. Брать при ручном перезапуске прода — после правки .env.prod, при разборе выкатки, при подъёме контейнера на сервере. Готовые команды с меткой образа по sha и чем сверять результат. Накат миграций — паттерн git-workflow-migration.
 ---
 
 # Ручной перезапуск прода

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

@@ -2,7 +2,7 @@
 name: git-workflow-secrets
 kind: pattern
 rule: deploy-flow
-description: Паттерн правила deploy-flow. Брать при работе с ключами внешних служб — где они лежат, чем ключ, заводимый владельцем, отличается от ключа окружения, что означает каждое состояние строки интеграции и почему зелёная проба не обещает работающей возможности. Не брать для перезапуска прода и выбора образа — это паттерн git-workflow-restart.
+description: Паттерн правила deploy-flow. Брать при работе с ключами внешних служб: где они лежат, чем ключ владельца отличается от ключа окружения, что означает каждое состояние строки интеграции и почему зелёная проба не обещает работающей возможности.
 ---
 
 # Ключи внешних служб

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

@@ -0,0 +1,93 @@
+---
+name: git-workflow-stack
+kind: pattern
+rule: git-workflow
+description: Паттерн правила git-workflow. Брать, когда из одного основания заведено больше двух веток и все ждут слияния: единица работы, порядок вливания, перевливание главной по факту конфликта, сложение у общих указателей. Один конфликт — паттерн git-workflow-merge.
+---
+
+# Стопка заявок из одного основания
+
+Паттерн правила `git-workflow`. Что при этом должно быть верно — закон
+`docs/constitution/delivery.md`. Разбор одного конфликта — паттерн `git-workflow-merge`,
+открытие одной заявки — `git-workflow-pr`.
+
+## Когда брать
+
+- Из одного основания заведено больше двух веток, и все ждут слияния.
+- За заход сделано несколько работ, и они лежат в дереве невыложенными.
+- Решается, в каком порядке отдавать накопленное владельцу.
+
+## Единица работы — влитая заявка, а не открытая
+
+Открытый черновик работой не является: кнопка слияния у него заблокирована, в главной ветке его
+правок нет, и очередь работ им не сокращается. Восемнадцать открытых черновиков и ни одного
+влитого — это ноль сделанного, сколько бы времени на них ни ушло.
+
+Отсюда порядок: одна работа доводится до слияния, потом берётся следующая. Не наоборот.
+
+## Цена стопки растёт квадратично
+
+Ветки одного основания, дописывающие в одни и те же тексты, роняют друг друга при каждом
+слиянии: влитая первая устаревает остальные, влитая вторая — все, кроме двух, и так до конца.
+Открыв все разом, исполнитель назначает себе порядка половины квадрата их числа вливаний
+главной — и делает их он, а слияния нажимает человек в своём темпе.
+
+Считается это до открытия, а не после: закрыть лишние заявки дешевле, чем вести их, но время на
+их тела к тому часу уже потрачено.
+
+## Главная вливается по факту конфликта, а не по расписанию
+
+Отставшая ветка и конфликтующая — разное. Отставшую хостинг вливает сам: правки разных мест
+одного файла сводятся без человека. Конфликтует только та, где обе стороны тронули одни строки.
+
+Поэтому после чужого слияния главная вливается не во все открытые ветки, а в те, о которых
+хостинг сказал, что они конфликтуют. Спрашивается это одним вызовом на всю стопку:
+
+```bash
+gh pr list --state open --json number,headRefName,mergeable \
+    --jq '.[] | select(.mergeable == "CONFLICTING") | "\(.number)\t\(.headRefName)"'
+```
+
+Ответ `UNKNOWN` означает, что хостинг ещё считает, а не что конфликта нет: вызов повторяется
+через несколько секунд. Вливание «на всякий случай» — это и есть та квадратичная цена, и
+платится она за состояние, которого чаще всего нет.
+
+## Указателю, куда дописывают все, объявляется сложение
+
+Список закрытых работ, оглавление спеков, перечень задач — файлы, куда каждая ветка добавляет
+строку в конец. Они конфликтуют на пустом месте у каждой ветки стопки, и разрешение у них одно:
+нужны обе стороны целиком. Объявляется это один раз, в `.gitattributes`:
+
+```
+docs/archive/README.md merge=union
+```
+
+Сложение ставится только на указатели, где правка всегда добавляющая. На текст, который
+переписывают, оно оставит в файле обе редакции.
+
+## Порядок вливания задаётся заранее и называется владельцу
+
+Порядок считается до открытия заявок — по тому, кто какие файлы правит:
+
+```bash
+for b in $(git branch --list '<префикс>-*' --format='%(refname:short)'); do
+    git diff --name-only origin/main...$b
+done | sort | uniq -c | sort -rn | head
+```
+
+Ветки, правящие один и тот же файл, идут подряд: разведённые чужими слияниями, они соберут
+конфликт там, где подряд его бы не было. Порядок называется владельцу в теле заявки — кнопки
+нажимает он, а о родстве веток не знает.
+
+## Частые промахи
+
+- Открыты все заявки разом, потому что ветки были готовы. Готовность ветки признаком того, что
+  её пора отдавать, не является: отдаётся столько, сколько владелец успевает влить.
+- Главная влита во все открытые ветки после каждого чужого слияния. Половина этих вливаний не
+  меняла ничего: ветки не конфликтовали, а сливаемость у них не спрашивали.
+- Состояние стопки выведено из своего дерева, а не спрошено у хостинга. Локально влитая главная
+  о сливаемости не говорит: между вливанием и взглядом владельца главная уходит вперёд.
+- Стопка отдана без порядка. Владелец вливает в порядке списка, то есть в порядке номеров, — и
+  две ветки одного файла попадают друг на друга ровно тогда, когда между ними встала третья.
+- Время потрачено на тела заявок, а не на доведение первой до слияния. Тело нужно тому, кто
+  заявку читает; у заявки, до которой очередь дойдёт через сутки, читателя сегодня нет.

package/assets/patterns/seo-page.md

@@ -2,7 +2,7 @@
 name: seo-page
 kind: pattern
 rule: seo
-description: Паттерн правила seo. Брать, когда правится разметка страницы публичного сайта, заводится новый маршрут или новая страница должна попасть в карту сайта — готовый вызов PropertySeoService, ветки локалей в app.routes.ts, строка в sitemap. Не брать для проверки отданной разметки — это паттерн seo-verify.
+description: Паттерн правила seo. Брать, когда правится разметка страницы публичного сайта, заводится маршрут или страница должна попасть в карту сайта: готовый вызов службы мета-тегов, ветки локалей, строка карты. Проверка отданной разметки — паттерн seo-verify.
 ---
 
 # Разметка страницы публичного сайта

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

@@ -105,6 +105,23 @@ description: Паттерн правила git-workflow. Брать … Не б
 Разделы: `## Когда брать` · готовый код · `## Частые промахи`. Привязки у паттерна нет:
 проверка его не сверяет, потому что сверять готовый код с ним самим нечем.
 
+## Описание: триста знаков и один вопрос
+
+Описание правила и паттерна едет в системный промпт каждого захода целиком — за него платит
+всякий заход, чем бы ни занимался. Отвечает оно на один вопрос: брать это или нет.
+
+| В описании                                          | Не в описании                                  |
+| --------------------------------------------------- | ---------------------------------------------- |
+| под каким законом правило                           | пересказ его статей                            |
+| когда брать — путями правки или именем предмета     | перечисление разделов                          |
+| у паттерна — когда не брать, с именем соседнего     | довод, зачем правило заведено                  |
+| имена паттернов при правиле                         | их содержимое                                  |
+
+Считает длину проверка описаний: она называет превысивших поимённо, с числом знаков. Описание,
+которое иначе перестанут находить по своей теме, оставляют длиннее предела — и тогда имя скила
+встаёт в перечень принятого долга с причиной, чтобы молчаливое превышение и осознанное не
+выглядели одинаково.
+
 ## Порядок
 
 1. Статья пишется в закон — без путей и имён файлов.
@@ -114,6 +131,44 @@ description: Паттерн правила git-workflow. Брать … Не б
 4. Готовый код уезжает в паттерн, а правило на него ссылается.
 5. `npm run check:specs` — до пуша.
 
+## Сжатие статьи: живой образец
+
+Форма — в правиле рядом; здесь одна настоящая статья до и после, с числами. Взята из правила о
+проверке компонента: 1110 знаков, из них утверждение — 90.
+
+**До.** Утверждение, механизм, два случая из замера, отвергнутое лекарство, следствие в эталоне:
+
+```markdown
+- **Съёмка за пределы окна трогает страницу под затвором, и лечится это не циклом, а окном.**
+  Кадр целой страницы шире или выше окна браузер снимает, подменив окно на время кадра: страница
+  получает `resize`, и всё, что от размеров окна считается, съезжает прямо в кадре. Замер поймал
+  это дважды в одной задаче — лента просмотрщика фото теряла прокрутку, и в кадр попадал первый
+  снимок набора вместо последнего; высота страницы уезжала на два пикселя. Успевает ли сдвиг лечь
+  в растр, решает гонка, поэтому одна и та же история то краснеет, то нет… Цикл до совпадения
+  двух кадров подряд тут не лекарство, а закрепление поломки: сдвиг устойчив… Лечится обратным
+  порядком — окно раздвигается до страницы **до** кадра…
+```
+
+**После — 517 знаков, то же решение:**
+
+```markdown
+- **Съёмка за пределы окна трогает страницу под затвором, и лечится это не циклом, а окном.**
+  Кадр шире или выше окна браузер снимает, подменив окно: страница получает `resize`, и всё, что
+  считается от размеров окна, съезжает прямо в кадре. Цикл до двух совпавших кадров тут не
+  лекарство, а закрепление поломки — сдвиг устойчив. Окно раздвигается до страницы **до** кадра,
+  показ ждут вставшим, и снимается обычный кадр; в эталоне `100vh` и `100vw` считаются от
+  раздвинутого окна. Ловушки — в холодной части.
+```
+
+**Куда уехал остаток — 593 знака в `pitfalls.md`:** какая именно история краснела, сколько раз,
+на сколько пикселей уезжала высота, почему виноватой всякий раз выглядела другая история и
+почему это читается как плавающая вёрстка. Ни одно решение по правке на этом не стоит: оно
+нужно тому, кто разбирает красный снимок, — и грузится тогда же.
+
+**Что осталось при статье:** утверждение целиком, механизм одной фразой, отвергнутое лекарство
+(без него следующий заход заведёт тот же цикл заново) и следствие в эталоне — оно меняет то, как
+пишут историю.
+
 ## Частые промахи
 
 - Закон назвал файл проекта — проверка отбивает. Путям место в правиле.

package/assets/patterns/status-report-table.github.md

@@ -0,0 +1,88 @@
+---
+name: status-report-table
+kind: pattern
+rule: status-report
+description: Паттерн правила status-report. Брать, когда владельцу отвечают, где работа стоит, — готовые вызовы для каждой клетки: ветка и её коммиты, состояние заявки, прогон конвейера и сверка его с вершиной, задача на борде, порядок задач из замысла эпика. Образец заполненной таблицы прилагается.
+---
+
+# Чем спрашивается состояние и как оно ложится в таблицу
+
+Паттерн правила `status-report`. Что при этом должно быть верно — закон о ведении работы.
+
+## Когда брать
+
+- Владелец спросил, где стоит работа: «какой статус», «что за эпик», «что сейчас делаешь».
+- Ход кончается отчётом о сделанном, и в нём называется состояние заявки или прогона.
+- Работа идёт под эпиком, и в ответе перечисляются все его задачи.
+
+## Вызовы
+
+Ветка, её коммиты сверх главной, незакоммиченное и вершина:
+
+```bash
+git branch --show-current
+git log --oneline <главная>..HEAD
+git status --short
+git rev-parse --short HEAD
+```
+
+Порядок задач эпика берётся из его замысла, а не из борды: назначен он там, и номера задач на
+борде идут не подряд.
+
+```bash
+sed -n '/## Порядок задач/,/^## /p' <замысел эпика>
+```
+
+Состояние заявки — черновик ли она, сходится ли с главной, сколько файлов:
+
+```bash
+gh api repos/:owner/:repo/pulls/<номер> \
+  --jq '{n:.number,draft:.draft,state:.state,mergeable:.mergeable,changed:.changed_files}'
+```
+
+Прогон конвейера по ветке и разбор одного прогона:
+
+```bash
+gh run list --branch <ветка> --limit 5
+gh run view <идентификатор>
+```
+
+Задача на борде — заголовок, состояние, метки:
+
+```bash
+gh api repos/:owner/:repo/issues/<номер> --jq '{t:.title,s:.state,labels:[.labels[].name]}'
+```
+
+Чем зовётся исполняемый файл хостинга и где лежат замыслы эпиков, говорит компаньон правила:
+имя команды в оболочке бывает занято чужим псевдонимом, и тогда вызов уходит в интерактивный
+вход вместо ответа.
+
+## Ловушки
+
+- **Задача на борде читается запросом, а не подкомандой просмотра.** Подкоманда тянет за собой
+  доски старого образца, хостинг отвечает отказом о них, и вызов краснеет целиком, ничего не
+  показав. Берётся прямой запрос.
+
+- **Прогон старше вершины.** Список прогонов показывает последний прогон ветки, а не прогон
+  нынешнего коммита. Сверяется с вершиной прежде, чем число встанет в ответ.
+
+- **Папка задачи из шаблона.** Скопированные, но незаполненные разбор и замысел держат угловые
+  скобки шаблона. Это «заведена, не начата», и в клетке «Состояние» пишется так.
+
+- **Заявка зелёная, но черновик.** Прогон успешен, а слияние заблокировано хостингом; в клетке
+  «Осталось» стоит снятие черновика либо названное вслух ожидание.
+
+## Образец
+
+Эпик над таблицей — абзацем, а не строкой:
+
+> **Эпик «<название>» (<ключ>)** — <зачем он, одной фразой>. Задач <сколько>, идёт <номер по
+> порядку>.
+
+| №   | Задача                       | Номер   | О чём                          | Состояние                                  |
+| --- | ---------------------------- | ------- | ------------------------------ | ------------------------------------------ |
+| 1   | <название задачи из замысла> | <ключ>  | <одной фразой, что она делает> | код готов, прогон `<id>` success 12 м 14 с |
+| 2   | <название задачи из замысла> | —       | <одной фразой>                 | не заведена                                |
+| —   | <заведённая вне эпика>       | <ключ>  | <одной фразой>                 | заведена, папка — пустой шаблон, ветки нет |
+
+Под таблицей — строка о том, чего ждём от владельца, и вызов, которым это снимается.

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

@@ -2,7 +2,7 @@
 name: task-flow-archive
 kind: pattern
 rule: task-flow
-description: Паттерн правила task-flow. Брать, когда тексты приведены и папка задачи разбирается последним коммитом до открытия заявки: переезд в описание прошлого, сверка очереди работ, разбор закрытой работы правилами и то, что делать с его находками. Не брать для вливания договорённости, открытия заявки и снятия черновика — это паттерн task-flow-close.
+description: Паттерн правила task-flow. Брать, когда тексты приведены и папка задачи разбирается последним коммитом до открытия заявки: переезд в описание прошлого, сверка очереди работ, разбор закрытой работы правилами и что делать с находками.
 ---
 
 # Разбор папки задачи и разбор работы правилами
@@ -58,7 +58,7 @@ rm -r docs/tasks/<КЛЮЧ>-<номер>-<slug>
 Разбор идёт последним коммитом ветки, до открытия заявки: открытие с лежащей папкой отбивает
 гард поставки. Прежде уборка стояла после одобрения — считалось, что замысел нужен на диске всё
 время разбора. Но кнопку слияния нажимает человек на хостинге, куда гард не достаёт, и вливает
-он, как только видит зелёное: трижды подряд папка уехала в главную неразобранной. Замысла после
+он, как только видит зелёное. Замысла после
 уборки на диске нет намеренно, и правку по замечаниям гард хода работы пропускает по признаку
 из истории ветки.
 
@@ -162,8 +162,7 @@ npm run check:docs    # пути, названные в текстах, суще
 
 - **Папку разбирают до открытия заявки — потом о ней уже никто не вспомнит.** Сверка очереди
   считает задачу закрытой по слиянию: после него за папку никто не отвечает — работа перешла к
-  следующей задаче, и находка достанется чужому заходу. Три раза подряд папка закрытой задачи
-  так и уехала в главную ветку, в последний раз их набралось пять. Держит это гард поставки:
+  следующей задаче, и находка достанется чужому заходу. Держит это гард поставки:
   открытие заявки отбивается, пока папка лежит в ветке.
 - **Разбор папки идёт последним коммитом, после того как гейт пуша прошёл целиком.** Порядок
   один: мерж главной ветки, все линтеры и проверки зелёные, вливание договорённости, приведение

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

@@ -2,7 +2,7 @@
 name: task-flow-close
 kind: pattern
 rule: task-flow
-description: Паттерн правила task-flow. Брать при доведении работы до готовности — вливание договорённости в спек домена, приведение текстов домена к сделанному, открытие заявки черновиком и снятие черновика. Не брать для разбора папки задачи и разбора работы правилами — это паттерн task-flow-archive; не брать для хода работы — это паттерн task-flow-resume.
+description: Паттерн правила task-flow. Брать при доведении работы до готовности: вливание договорённости в спек домена, приведение текстов домена к сделанному, открытие заявки черновиком и снятие черновика. Разбор папки задачи — паттерн task-flow-archive.
 ---
 
 # Закрытие работы
@@ -166,6 +166,11 @@ PR #<номер> готов к слиянию: прогон зелёный, че
 Не осталось: прогон зелёный, черновик снят. Можно вливать.
 ```
 
+Заголовок раздела и слова обоих образцов пишутся языком заявки, а не языком паттерна. Образцы
+набраны тем языком, которым написан сам паттерн, и переносятся целиком — порядок мыслей,
+формулировки и заголовок, заголовок последним: он выглядит частью формы, а не частью текста. То же верно и для двух сообщений
+владельцу выше: они образцы того, **что** сказано, а не того, какими словами.
+
 Пустым раздел не оставляется и не удаляется вовсе: отсутствие раздела и «шагов не осталось»
 читаются одинаково, а значат разное. Образец тела заявки целиком — в паттерне заведения коммита
 и заявки, если дерево его разложило.

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

@@ -2,7 +2,7 @@
 name: task-flow-start
 kind: pattern
 rule: task-flow
-description: Паттерн правила task-flow. Брать в начале работы от владельца — готовый порядок: разведка до первого вопроса, шесть обязательных вопросов, договорённость о продукте, конвейер ролей, заведение задачи и ветки, сборка папки задачи. Не брать для возвращения к незаконченной работе — это паттерн task-flow-resume.
+description: Паттерн правила task-flow. Брать в начале работы от владельца: разведка до первого вопроса, шесть обязательных вопросов, договорённость о продукте, заведение задачи, ветки и папки. Возвращение к работе — паттерн task-flow-resume.
 ---
 
 # Начало работы
@@ -40,6 +40,15 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 считается сделанным, разведка исполняется как настроение: прочитанный переданный текст сходит
 за неё, и по текущему дереву не запускается ни одной команды.
 
+Разведка по заведённой задаче кончается воспроизведённым симптомом, а не найденным файлом. Тело
+задачи описывает дерево на день заведения, и между заведением и работой в главную ветку въезжают
+чужие правки: разведка, читающая код по именам из тела, подтверждает, что названные файлы на
+месте, — и отпавшая задача от живой не отличается ничем. Прежде первой своей правки разведка
+повторяет то, на что задача жалуется: зовёт процедуру, читает отданный ответ, гоняет проверку,
+которая молчала. Симптом не воспроизвёлся — задача закрывается как отпавшая, и это законный её
+исход: чинить нечего, а зелёные проверки после такой правки говорят ровно об этом и ни о чём
+больше.
+
 **Следующее движение:** находки ложатся в разбор, и тем же ходом владельцу уходит первый из
 шести вопросов. Разведка кончилась — состояние осталось прежним, ход тоже.
 
@@ -82,8 +91,7 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 
 Замеры, находки ролей и список решений к этому моменту уже записаны в ход работы, и в
 сообщении владельцу они лишние. Отчёт, в конце которого стоит вопрос, выглядит добросовестно
-ровно настолько, насколько надёжно вопрос в нём тонет: владелец трижды переспрашивал, почему
-работа стоит, и каждый круг стоил захода обоим.
+ровно настолько, насколько надёжно вопрос в нём тонет.
 
 Ответы пишутся в `docs/tasks/_draft-<slug>/grill.md` — папка ещё черновик, номера нет.
 
@@ -143,8 +151,12 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 Лежит замысел вне папки задачи: та умирает с мержем первой же задачи. Каталог для него называет
 компаньон правила — у пакета своего пути нет.
 
-**Следующее движение:** объявленный эпик коммитится, и тем же ходом берётся первая его
-задача — заведением задачи, ветки и папки.
+Карточки заводятся на все задачи разом, здесь же: по вызову заведения задачи на каждую строку
+таблицы, с меткой эпика. Выданные номера возвращаются в ту же таблицу — колонкой или приставкой
+к названию, — и с этой минуты «взять следующую» отвечает номером, а не названием.
+
+**Следующее движение:** объявленный эпик коммитится вместе с номерами задач, и тем же ходом
+берётся первая его задача — заведением ветки и папки.
 
 ### Состояние `договорённость-записана`: задача, ветка, папка
 

package/assets/patterns/ts-procedure.md

@@ -2,7 +2,7 @@
 name: ts-procedure
 kind: pattern
 rule: typescript-conventions
-description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде — готовый класс с полем method и методом handle, зависимости конструктором, имя файла и класса, почему форма именно такая. Не брать для объявления доступа к процедуре — это паттерн permissions-procedure.
+description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде: готовый класс с полем метода и обработчиком, зависимости конструктором, имена файла и класса. Доступ к процедуре — паттерн permissions-procedure.
 ---
 
 # Процедура Connect

package/assets/pitfalls/doc-style.md

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

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

@@ -84,3 +84,50 @@
   Ветки, дописывающие строку в один и тот же список, роняют друг друга в конфликт при каждом
   слиянии, и вливание главной по кругу — это починка проявления. На третьем круге называется
   причина и спрашивается владелец, а не делается четвёртый круг.
+- **Пустой файл, отправленный телом заявки, стирает описание работы целиком.** Так уехала правка
+  тела, собранная связкой: переход в каталог временных файлов увёл вызов из дерева, выгрузка
+  тела отказала, а следующее звено отправило оставшийся пустым файл. Описание, собранное за три
+  захода, стало пустой строкой; восстановлено историей правок хостинга — и то пока она есть.
+- **`gh project` с `--owner` отвечает `unknown owner type`.** Так бывает, когда владелец борды —
+  не та учётная запись, под которой идёт вызов. Идентификатор берётся у самой борды, а не
+  собирается из имени владельца.
+
+## Что стояло в статьях
+
+Сюда уехали случаи, числа и отвергнутые лекарства, стоявшие прежде при статьях правила. Ни одно
+решение по правке на них не стоит: они нужны тому, кто разбирает промах или спорит с гардом.
+
+- **Сборка входит в набор гейта.** Четыре мержа подряд уехали в главную ветку, ломая выкатку:
+  ошибка типов в непокрытом коде пережила линт и юниты и всплыла на сборке образа.
+- **Набор гейта не бывает уже набора конвейера.** Дважды подряд правка, прошедшая гейт целиком,
+  была отбита конвейером — и оба раза зелёный гейт был прочитан как «локально всё зелено». Отсюда
+  и требование отбивать пуш на шаге без строки в наборе, а не печатать предупреждение рядом.
+- **Черновик не снимается с ветки, которая не сливается.** За один заход так было снято три
+  черновика подряд, и все три заявки владелец увидел конфликтующими. Статья про сливаемость
+  стояла в правиле и до того — промах повторился в тот же день, поэтому требование держится
+  гардом, а не памятью.
+- **Сложение сторон у общего указателя.** До объявления одна и та же строка разрешалась шесть раз
+  в шести ветках за один заход. Обещать по объявлению «конфликтов больше не будет» нельзя: не
+  будет ручной работы, а вливать главную в открытые ветки после каждого слияния придётся
+  по-прежнему.
+- **Личность вызова, открывающего заявку.** Прежде обе стороны — подстановка токена и ответ
+  хостинга об авторе — держались статьёй и разбором происшествия, и промах повторился на третий
+  день.
+- **Незаданный ключ задач.** Собранный из пустого значения заголовок `[-317]` не совпадает ни с
+  чем, и сверка помечает неправильно названной каждую задачу: настоящее расхождение тонет среди
+  этих строк.
+- **Ветка, не тронувшая ни строки показа, прогоняет снимки витрин** с того момента, как вливание
+  главной принесло чужую правку оформления. Это и есть тот случай, ради которого набор проверок
+  пересматривается после вливания.
+- **Возврат PR в черновик — `gh pr ready --undo` — требования разбора не получает:** он делает то
+  же, чего гард и добивается.
+- **Свои черновики судятся все разом.** Уход в соседнюю ветку выключал гард целиком: за один
+  заход так разошлись с главной четыре заявки подряд, и заметил это владелец, а не проверка.
+  Разбор — `docs/postmortems/2026-08-25-run-left-unwatched.md`.
+- **Подпись машинной записи на каждом коммите вклада.** Пять коммитов одной стопки уехали
+  подписанными владельцем, который правки не делал: гард судит только коммит, назвавшийся
+  машинной записью, и ищет расхождение в числе служебного адреса.
+- **Состояние заявки перечитывается у хостинга.** Клиент отвечает от той записи, чей токен ему
+  дали, а запрос разбора на автора хостинг принимает молча и не создаёт.
+- **Ревьюверы спрашиваются вызовом REST.** Под токеном машинной записи выборка клиента падает
+  целиком, без токена проходит зелёной — отличить «сошлось» от «спросить было нечем» нечем.

package/assets/pitfalls/task-flow.md

@@ -57,6 +57,34 @@
   расспрашивает владельца заново. Имя черновику дают словами просьбы, а ветке — терминологией
   договорённости; те же слова, да не те же.
 
+- **У меню с закрытым набором нет строки «вопрос не тот».** Вариантами вопрос выглядит
+  разобранным, и владельцу, чтобы отвергнуть саму постановку, приходится выходить из набора
+  руками. Спрашивают меню то, где выбор действительно закрыт; там, где под сомнением сама
+  уместность вопроса, его сперва проверяют по репликам владельца — и чаще всего не задают.
+
 ## Поведение исполнителя — по разборам происшествий
 
 Переезжает из правила следующей задачей эпика.
+
+## Что стояло в статьях
+
+Случаи и числа, стоявшие прежде при статьях правила. Решения по правке на них не стоят: они
+нужны тому, кто разбирает промах или спорит с гардом.
+- **Папка задачи под любую работу.** Прежде правило судило по числу заходов: работа в один
+  коммит помещалась в тело PR и папки не заводила. За один заход это исключение дважды стало
+  поводом обойти отказ гарда вместо того, чтобы завести папку и пойти дальше.
+- **Разбор папки до открытия PR.** Прежде уборка стояла после одобрения. Трижды подряд папка
+  уехала в главную ветку неразобранной, и разобрать её было уже некому: работа перешла к
+  следующей задаче, а PR закрылся.
+- **Шапка раскладки в копии образца.** Оставленная в копии, она отбивает первую же правку
+  разбора просьбы, а отказ уводит править образец пакета вместо копии под задачу.
+- **Расхождение, не найденное чтением образца целиком, находит владелец** — на приёмке всей
+  работой, а не отдельной правкой.
+- **Папка, уехавшая в главную ветку.** Три раза подряд папка закрытой задачи так и уехала
+  неразобранной, в последний раз их набралось пять.
+- **Заявка на чужом языке.** В дереве, где заявки пишутся на другом языке, чужой заголовок
+  дважды уехал на хостинг, и оба раза до него добрались глазами.
+- **Вопрос, утонувший в отчёте.** Владелец трижды переспрашивал, почему работа стоит, и каждый
+  круг стоил захода обоим.
+- **Чужой эпик в списке очереди.** Дважды подряд следующей была взята первая задача чужого
+  эпика — по списку она выглядела ровно как своя.

package/assets/pitfalls/testing.md

@@ -68,3 +68,17 @@
   сходится и тогда, когда строк стало три. Ожидаемое пишется числом в самой спеке рядом с
   проверкой, а общий модуль сквозных спек держит приёмы — открыть, дождаться, снять со
   страницы, — но не то, что от страницы ожидается.
+- **Красное, пришедшее без правки кода, разбирается со стороны времени.** Зелёный прогон той же
+  вершины часом раньше означает, что искать надо не в правке: срок годности образца, високосный
+  день, смена суток по всемирному времени, часовой пояс машины. Спека прождала двое суток и
+  покраснела сама — прогон пришёлся на четыре минуты позже срока, записанного в её образце.
+
+## Что стояло в статьях
+
+- **Сид и содержимое с автором.** Три выдуманные цитаты дожили до отдельной задачи и всё это
+  время выглядели отзывами настоящих людей.
+- **Растр браузера.** Расхождение гуляет по кадру, приходит примерно раз в четыре прогона и на
+  светлых экранах не показывается вовсе, поэтому читается случайным.
+- **Маска и ширина.** Кадр списка уезжал на пиксель целиком, включая столбцы, где не менялось
+  ничего.
+

package/assets/pitfalls/turn-conduct.md

@@ -0,0 +1,33 @@
+# Ход захода — холодная часть
+
+Ловушки: случаи и числа, стоявшие прежде при статьях правила. Грузится не вместе с правилом, а
+по требованию — при обычном решении она не нужна.
+
+Правило — `turn-conduct`; статьи, которыми держится закон, стоят там.
+
+## Ловушки
+
+- **Сводка о чужом шаге вместо работы.** За один заход это было нарушено четырежды, и готовая
+  работа простояла в невлитом PR почти три часа.
+- **Названная, но не запущенная команда.** Дважды за сутки ход кончился ровно такой строкой, и
+  оба раза владелец возвращал работу сам.
+- **Снятая папка задачи.** Прежде страж выходил здесь молча — и ход, которому до отдачи
+  оставался один шаг, закрывался пустым.
+- **Работа без ветки и папки.** Раньше страж отпускал её молча, и защищена она была меньше
+  всего: просьба владельца «разложи», «обнови», «посмотри» идёт без задачи и без ветки, и
+  именно она чаще всего кончалась объявлением намерения.
+- **Утверждение о состоянии дерева.** Восемь разборов подряд пришлись на этот промах, и каждый
+  раз в правило дописывалась ещё одна статья — держит его теперь машина.
+- **Гард утверждения, прочитавший запись раньше текста.** Молчит он честно и снаружи неотличим
+  от гарда, который посмотрел и пропустил: одним таким ходом мимо прошли сразу трое. Отказ
+  принадлежит одному гарду: печатай своё решение все трое, вывод перестал бы разбираться целиком.
+- **Отданная работа без снятого черновика.** Две готовые заявки простояли так, пока владелец не
+  вернул исполнителя сам.
+- **Повторённый хвост отбитой команды.** Переключение ветки, оставшееся в отброшенном начале,
+  унесло шесть файлов задачи в ветку прошлой работы вместе с коммитом.
+- **Оценка «это безопасно» вместо списка.** За один заход одна и та же команда была сначала
+  слишком опасной, чтобы её позвать, а через два хода — достаточно безопасной, чтобы позвать без
+  спроса.
+- **Почему гард ожидания читает ход, а не хостинг.** Спросить хостинг было бы точнее, но сетевой
+  вызов на завершении хода падает вместе со связью и отбивал бы работу вместо промаха, а вывод
+  команды о прогоне в записи хода уже лежит.

package/assets/rules/angular-patterns.md

@@ -2,7 +2,7 @@
 name: angular-patterns
 kind: rule
 law: frontend-application
-description: Правило под «Закон о фронтовом приложении». Брать при правке любого класса Angular — компонента, стора админки, сервиса, директивы, пайпа, гарда, интерцептора. Называет сигнальный API входов, OnPush, zoneless, inject и место, где живёт подписка. Не действует под libs/api и apps/api. Готовый код — в паттерне angular-patterns-state.
+description: Правило под «Закон о фронтовом приложении». Брать при правке любого класса Angular — компонента, стора, сервиса, директивы, пайпа, гарда, интерцептора. Называет сигнальный API входов, OnPush, zoneless, inject и место подписки. Паттерн angular-patterns-state.
 ---
 
 # Реактивность экрана — как это устроено здесь