@rt-tools/agent-kit 0.8.1 → 0.8.3

package/assets/checks/check-specs.mjs

@@ -93,8 +93,32 @@ const E2E_ROOTS = CONFIG.e2eRoots;
  * выглядит как правило без якоря. Заглавные и десять букв нужны ради `api.Dockerfile`:
  * без них правило про режим исполнения образа считалось правилом с пустой привязкой,
  * а привязать его больше не к чему — режим объявлен ровно там.
+ *
+ * Символ — любая буква, а не только латинская: тексты, которые исполняет модель, написаны
+ * своим языком, и латиницей в них называется ровно то, что утверждения не держит — имя поля
+ * шапки, имя инструмента. Привязанное к имени поля утверждение остаётся зелёным, когда текст
+ * переписан целиком. Алфавит не перечисляется диапазонами: перечисленные молча не покрывают
+ * соседнего, и промах выглядит отсутствием привязки. Путь при этом остаётся латинским — он
+ * адрес в дереве, а не слово текста.
+ */
+const ANCHOR = /`([\w./-]+\.[A-Za-z]{2,10}):(\p{L}[\p{L}\p{N}_-]*|_[\w-]*)`/gu;
+/**
+ * Явный вердикт вместо якоря: статья, которой в дереве исполняться негде. Так бывает
+ * законно — правило говорит о службе, которой дерево не держит, или о движении человека,
+ * до которого проверке не дотянуться: кнопку слияния нажимают в браузере, где хуков нет
+ * вовсе. Якорь такой статье можно поставить только в файл, который её не исполняет, —
+ * проверка примет, а читателю совратёт.
+ *
+ * Принимается вердикт с причиной, а не одно слово: пустой он становится способом закрыть
+ * любую строку, и таблица за месяц превращается в список отговорок. Порог длины — та же
+ * мера, что у обхода гарда документов: причина короче его причиной не считается.
+ *
+ * Конец слова ищется отрицательным просмотром, а не `\b`: границей слова JavaScript знает
+ * только латиницу, и после кириллической буквы её нет вовсе — вердикт не опознавался ни
+ * разу.
  */
-const ANCHOR = /`([\w./-]+\.[A-Za-z]{2,10}):([A-Za-z_][\w-]*)`/g;
+const VERDICT = /^\s*(?:\*\*)?Не (?:исполняется|применимо|проверяется)(?![\p{L}\p{N}_])/u;
+const VERDICT_MIN = 40;
 /** Строка шапки, объявляющая либы, чьи процедуры домен обслуживает */
 const PROCEDURE_ROOTS = /^\*\*Процедуры:\*\*\s*(.+)$/;
 const BACKTICKED = /`([^`]+)`/g;
@@ -204,9 +228,19 @@ function bulletsOf(lines) {
 
 const escapeForRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\-]/g, '\\$&');
 
-/** Символ ищется как слово: подстрока дала бы ложное совпадение на префиксе. */
+/**
+ * Символ ищется как слово: подстрока дала бы ложное совпадение на префиксе.
+ *
+ * Границы слова считаются буквой любого алфавита, а не `\b`: он в JavaScript знает буквой
+ * только латиницу, и `\bСемья\b` не совпадает ни разу — привязка на русском слове читалась
+ * как ведущая в файл, где этого слова нет, при том что слово стоит там первой же строкой.
+ */
 function fileHasSymbol(path, symbol) {
-    return new RegExp(`\\b${escapeForRegExp(symbol)}\\b`).test(read(path));
+    // Дефис здесь не экранируется: вне класса символов он ничего не значит, а под флагом `u`
+    // лишнее экранирование — уже отказ разбора. Общий экранировщик его защищает, потому что
+    // рассчитан и на класс тоже, и `task-flow` роняло всю сверку целиком.
+    const word = symbol.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(?<![\\p{L}\\p{N}_])${word}(?![\\p{L}\\p{N}_])`, 'u').test(read(path));
 }
 
 /**
@@ -287,7 +321,12 @@ function checkRuleImplementation(specFile, text, mapFile, heading = '## Прав
         if (!head || head === 'Правило' || head === 'Статья' || /^-+$/.test(head)) {
             continue;
         }
-        rows.set(head, { anchors: [...cells[2].matchAll(ANCHOR)], used: false });
+        const cell = cells[2].trim();
+        rows.set(head, {
+            anchors: [...cells[2].matchAll(ANCHOR)],
+            verdict: VERDICT.test(cell) && cell.length >= VERDICT_MIN,
+            used: false,
+        });
     }
 
     for (const bullet of bullets) {
@@ -301,13 +340,17 @@ function checkRuleImplementation(specFile, text, mapFile, heading = '## Прав
             report(
                 mapFile,
                 `правило без привязки: «${head.slice(0, 60)}…» — допиши строку с \`файл:символ\`, ` +
-                    'либо перенеси правило в «Открытые вопросы» как Q-N'
+                    'вердиктом «Не исполняется» с причиной либо перенеси правило в «Открытые вопросы» как Q-N'
             );
             continue;
         }
         row.used = true;
-        if (!row.anchors.length) {
-            report(mapFile, `у правила «${head.slice(0, 60)}…» пустая привязка`);
+        if (!row.anchors.length && !row.verdict) {
+            report(
+                mapFile,
+                `у правила «${head.slice(0, 60)}…» пустая привязка — поставь \`файл:символ\` ` +
+                    'либо вердикт «Не исполняется», «Не применимо», «Не проверяется» с причиной'
+            );
         }
         for (const [, path, symbol] of row.anchors) {
             if (!exists(path)) {
@@ -883,9 +926,11 @@ for (const domain of domains) {
 
     const found = walk(base, (name) => name === 'scenarios.md').flatMap(parseScenarios);
 
-    // Префикс судится в пределах одного спека, а не всего дерева домена: у поддомена он свой, и
-    // по номеру видно, о чём сценарий. Два префикса в одном спеке по-прежнему означают, что
-    // предмет описан дважды.
+    // Префикс принадлежит домену вместе с его поддоменами, а не отдельному каталогу. Домен
+    // делится тогда, когда его спек перерос предел длины, и сценарии переезжают в поддомены
+    // прежними: номер — единственное, чем сценарий связан с заголовком теста, и своя нумерация
+    // у каждого поддомена означала бы пересчёт всех номеров разом. Два префикса в одном спеке
+    // по-прежнему означают, что предмет описан дважды.
     const prefixesOf = new Map();
     for (const scenario of found) {
         const dir = dirname(scenario.file);
@@ -906,11 +951,11 @@ for (const domain of domains) {
         }
         for (const prefix of prefixes) {
             const owner = prefixOwners.get(prefix);
-            if (owner && owner !== dir) {
+            if (owner && owner !== base) {
                 report(dir, `префикс \`SC-${prefix}\` уже занят — \`${owner}\`; по номеру не видно, чей сценарий`);
                 continue;
             }
-            prefixOwners.set(prefix, dir);
+            prefixOwners.set(prefix, base);
         }
     }
 
@@ -1008,12 +1053,52 @@ const isProposedLaw = (file) => /^\*\*Статус:\*\*\s*предложен/m.t
     .filter(([law, file]) => !ruled.has(law) && !isProposedLaw(file))
     .forEach(([, file]) => report(file, 'у закона нет ни одного правила — заведи скил с `law:` на него'));
 
+/**
+ * Имена паттернов, которые дерево при раскладке пропустило: ключ `skip` в настройке проекта.
+ *
+ * Пропуск — выбор дерева, а не забытая работа: правило о процедурах бэкенда ложится и в дерево,
+ * где бэкенда нет вовсе. Требовать там паттерн значит требовать завести файл, которому нечего
+ * сказать, — и единственным способом позеленеть становится снятие пропуска.
+ */
+const skippedPatterns = () => {
+    const path = '.claude/rt-kit.json';
+    if (!exists(path)) {
+        return new Set();
+    }
+    try {
+        const skip = JSON.parse(read(path)).skip ?? [];
+
+        return new Set(skip.map((resource) => resource.match(/^patterns\/(.+)\.md$/)?.[1]).filter(Boolean));
+    } catch {
+        return new Set();
+    }
+};
+
+/**
+ * Раздел «Паттерны» самого правила — единственное место, где связь видна без файла паттерна:
+ * пропущенного файла в дереве нет, и поле `rule:` в нём спросить не у кого.
+ */
+// Флага `m` здесь нет намеренно: с ним `$` означает конец строки, и раздел кончается на первом
+// же переводе строки — пустым. Начало заголовка поэтому ищется своей парой, а не якорем.
+const PATTERNS_HEADING = /(?:^|\n)## Паттерны\n([\s\S]*?)(?=\n## |$)/;
+const patternsNamedBy = (text) => [...(text.match(PATTERNS_HEADING)?.[1] ?? '').matchAll(/^-\s+`([\w-]+)`/gm)].map(([, found]) => found);
+
+const skipped = skippedPatterns();
+
 for (const file of walk('.claude/skills', (name) => name === 'SKILL.md')) {
-    const head = frontMatterOf(read(file));
+    const text = read(file);
+    const head = frontMatterOf(text);
     const name = nameOf(head);
-    if (/^kind:\s*rule\s*$/m.test(head) && name && !patterned.has(name)) {
-        report(file, 'у правила нет ни одного паттерна — заведи скил с `rule:` на него');
+    if (!/^kind:\s*rule\s*$/m.test(head) || !name || patterned.has(name)) {
+        continue;
     }
+
+    const named = patternsNamedBy(text);
+    if (named.length > 0 && named.every((pattern) => skipped.has(pattern))) {
+        continue;
+    }
+
+    report(file, 'у правила нет ни одного паттерна — заведи скил с `rule:` на него');
 }
 
 checkTracedAnchors();

package/assets/checks/rt-kit-checks.config.mjs

@@ -71,6 +71,15 @@ const DEFAULTS = {
      * числе на каждой правке, а не о длине файла.
      */
     fileSizeLimit: 500,
+    /**
+     * Внешние пакеты, чьи перечисления считаются наравне с либами: своё перечисление под уже
+     * объявленный там набор — такая же копия, как и между двумя либами. Каждая запись — имя
+     * пакета и каталог объявлений внутри него; каталог ищется разрешением модуля, а не путём в
+     * `node_modules`: пакет, объявленный зависимостью подпроекта, в корне дерева не лежит вовсе,
+     * и зашитый путь на такой раскладке верным не бывает никогда. Пусто — внешние наборы не
+     * считаются.
+     */
+    externalEnums: [],
     /** Корни сквозных тестов; пусто — их в дереве нет. */
     e2eRoots: ['apps/site-e2e', 'apps/admin-e2e'],
     /** Корни бэкенда: у него нет ни компонентов, ни шаблонов, и часть признаков к нему не применяется. */

package/assets/checks/task-new.github.mjs

@@ -31,12 +31,13 @@ import {
     REPO,
     STATUS_FIELD_ID,
     TASK_KEY,
-    TOKEN_PATH,
     botToken,
+    describeTaskState,
     gh,
     ghJson,
     graphql,
     numberFromTitle,
+    taskState,
 } from './board.mjs';
 
 function parseArgs(argv) {
@@ -94,10 +95,13 @@ if (args.slug !== null && !/^[a-z0-9][a-z0-9-]*$/.test(args.slug)) {
     fail('slug — строчные латинские буквы, цифры и дефисы: имя ветки читают в списке из полусотни строк');
 }
 
-const token = botToken();
-if (!token) {
-    fail(`нет токена бота (${TOKEN_PATH}): задача завелась бы от чужого имени`);
-}
+/**
+ * Токен машинной записи необязателен: не назвавшее его дерево заводит задачу учётной записью,
+ * под которой залогинен клиент хостинга. Требование токена держало бы заведение задач у дерева,
+ * машинной записи не заводившего, и у дерева, чью запись ограничил хостинг, — а без заведения
+ * не начинается никакая работа вовсе. Кто именно завёл задачу, читается у неё самой.
+ */
+const token = botToken() ?? undefined;
 
 let number = null;
 try {
@@ -194,5 +198,29 @@ adoptDraft();
 
 console.log(`[${TASK_KEY}-${number}] ${args.title}`);
 console.log(`https://github.com/${OWNER}/${REPO}/issues/${number}`);
+
+/**
+ * Пятый шаг: заведение подтверждается ответом очереди работ, а не выводом этой команды.
+ *
+ * Все четыре шага выше отвечают за свои вызовы и молчат о том, видна ли задача тому, кто по
+ * ней придёт. Шестнадцать заведений подряд так и напечатали номер со ссылкой, не попав в
+ * очередь ни одно: учётная запись была ограничена хостингом, вызовы при этом отказа не дали.
+ */
+let answer;
+try {
+    answer = describeTaskState(number, taskState(number, { token }));
+} catch (error) {
+    const reason = error instanceof OfflineError ? error.message : String(error.message ?? error);
+    answer = describeTaskState(number, { offline: reason });
+}
+for (const line of answer.lines) {
+    (answer.ok ? console.log : console.error)(`task-new: ${line}`);
+}
+
 console.log(`\nВетка заводится отдельным вызовом:\n  git checkout -b ${branch}`);
 console.log(`Взятая в работу задача переставляется на борде:\n  npm run task:move -- ${number} ${IN_PROGRESS_STATUS}`);
+
+if (!answer.ok) {
+    console.error(`task-new: проверь очередь работ целиком — npm run check:board`);
+    process.exit(1);
+}

package/assets/commands/agent-kit-digest.md

@@ -12,17 +12,22 @@ argument-hint: '[пусто | --days N]'
 
 ## 1. Собери, что пришло
 
+Груз уезжает в приём, а не в очередь работ: сводка говорит о рабочих привычках команды, и в
+открытой очереди это выложено всему свету. Записи приёма читает его админка; пока её нет,
+собранное читается запросом к его хранилищу — как именно, сказано в компаньоне этой команды.
+
+Записи, заведённые прежним порядком, лежат в очереди работ и никуда не делись:
+
 ```bash
-gh issue list --label agent-kit-feedback --state open --limit 100 \
+gh issue list --label agent-kit-feedback --state all --limit 100 \
     --json number,title,body,createdAt
 ```
 
 Помощник хостинга и учётная запись машинной работы у каждого дерева свои — как их звать здесь,
 сказано в компаньоне правила `git-workflow`.
 
-Каждая запись заведена командой `agent-kit propose` из дерева, где пакет стоит. В теле — ресурс,
-место, повод, готовый текст и сводка наблюдений того дерева. Имени дерева там нет намеренно:
-различать их можно только по сводке и по времени.
+В каждой записи — ресурс, место, повод и готовый текст. Признак дерева, приехавший с грузом,
+адреса дерева не выдаёт: он считается хешем и по нему различают деревья, а не находят их.
 
 Своё дерево тоже потребитель — его наблюдения читаются прямо:
 
@@ -79,5 +84,5 @@ gh issue close <номер> --comment 'Вошло в #<номер задачи>.
 одна фраза о том, что менялось и почему. Журнал изменений при выпуске собирается из заголовков,
 и переписывать их задним числом — работа заново.
 
-**Выпуск отсюда не запускается.** Это отдельное решение владельца: слияние отчёта пакета не
+**Выпуск отсюда не запускается.** Это отдельное решение владельца: слияние PR пакета не
 публикует. Скажи, что накопилось на выпуск, и остановись.

package/assets/commands/feedback.md

@@ -0,0 +1,95 @@
+---
+description: Слово о слое правил, сказанное посреди работы, ложится блоком в файл предложений
+argument-hint: '<что мешает, чего не хватило, что сработало не так>'
+---
+
+Положи слово пользователя блоком в файл предложений. Слово: `$ARGUMENTS`
+
+Зовётся **посреди работы**, а не после неё: то, обо что споткнулись час назад, к разбору закрытой
+задачи уже забыто, а сама реплика живёт до конца сессии и умирает вместе с ней. Разбор закрытой
+задачи смотрит на загруженное и на ход работы; реплик он не видит вовсе.
+
+Команда ничего не отправляет. Она кладёт блок на диск, а увозит его обычная отправка, позванная
+отдельно. Скажи об этом пользователю последней строкой — иначе положенное читается как
+отправленное, и он ждёт ответа, которого никто не посылал.
+
+## 1. Пойми, о чём слово
+
+Слово пользователя — проза: «вот это правило мешает», «гейт требует не то», «этого в правилах
+нет вовсе». Твоё дело — перевести её в три вещи:
+
+- **адрес** — куда правка идёт;
+- **ресурс** — что именно правится;
+- **готовый текст** — ровно то, что вставить.
+
+Адрес один из трёх, и выбирается он не по удобству:
+
+    пакет      — правка ресурса @rt-tools/agent-kit; верна любому дереву и уезжает наружу
+    компаньон  — implementation.md рядом с правилом: имена этого дерева и привязка статей
+    дерево     — надстройка этого дерева; наружу не уезжает никогда
+
+Ресурс называется идентификатором пакета — `rules/styling-bem.md`, `hooks/skill-gate.sh`,
+`patterns/git-workflow-commit.md`, — а у адресов «компаньон» и «дерево» путём в дереве.
+
+**Непонятный адрес спрашивается, а не назначается по догадке.** Неверный адрес уводит правку в
+чужой репозиторий: сказанное о своём дереве уезжает всем, а сказанное обо всех остаётся лежать
+дома. Пока пользователь не ответил, в файл не записывается ничего.
+
+Спрашивать не надо, когда адрес виден из самого слова: речь о правиле, которое ты только что
+грузил, — это `пакет`; речь об именах, путях и командах этого дерева — `компаньон` или `дерево`.
+
+## 2. Найди файл сегодняшнего дня
+
+Блок ложится туда же, куда его кладёт разбор закрытой задачи: у них один адресат и один формат, а
+второй файл рядом означал бы, что отправка читает два места, а пользователь не помнит, в каком
+лежит его слово.
+
+```bash
+ls .claude/rt-kit/proposals/$(date +%F)-*.md 2>/dev/null
+```
+
+Нашёлся — дописывай в него. Не нашёлся — заведи с образца, назвав по ветке:
+
+```bash
+mkdir -p .claude/rt-kit/proposals
+cp .claude/rt-kit/templates/proposal.md \
+   ".claude/rt-kit/proposals/$(date +%F)-$(git branch --show-current).md"
+```
+
+У свежего файла шапка образца остаётся, а незаполненный образец блока — `rules/<правило>.md` со
+скобками — заменяется твоим блоком: отправка такой образец пропускает, но лежит он молчаливым
+мусором.
+
+## 3. Напиши блок
+
+Форма заголовка — не украшение: по ней отправка отбирает то, что уезжает наружу. Блок без адреса
+в заголовке не уедет никуда и останется лежать молча.
+
+```markdown
+## <адрес> · <ресурс>
+
+- **место:** раздел «<заголовок>», в конец
+- **повод:** что в этой работе пошло не так без этого правила
+
+> Готовый текст правки — ровно то, что вставить, в стиле соседних правил: по-русски,
+> утверждением, без воды.
+```
+
+Повод пишется от случая, а не от желания: «здесь было неудобно» правилом не становится. Слово
+пользователя пересказывается его смыслом, а не твоими выводами о том, как надо было бы.
+
+**Адреса этого дерева в тексте блока не бывает** — ни пути, ни имени корня, ни имени чужого
+репозитория: файл уезжает в чужой репозиторий целиком. Найденный адрес отбивает отправку с
+номером строки, и это проверка, а не напоминание. Правь текст, а не обходи её.
+
+## 4. Скажи, что вышло
+
+Одной строкой: в какой файл лёг блок, сколько блоков в нём теперь и чем он уедет.
+
+```bash
+npx agent-kit propose --dry-run     # что уехало бы
+npx agent-kit propose               # отправить груз в приём
+```
+
+Отправка увозит блоки с адресом «пакет» и метит их отправленными; блоки «компаньон» и «дерево»
+остаются лежать — их правит тот, кто работает в этом дереве.

package/assets/commands/next-session.md

@@ -6,7 +6,7 @@ argument-hint: '[пусто | <что дописать в передачу от
 Закрой заход: приведи дерево к главной ветке, убери влитые ветки и напиши передачу для
 следующего захода. Дописка владельца к передаче: `$ARGUMENTS`
 
-Вызывается **последним действием захода** — после того, как работа закоммичена, а отчёт открыт
+Вызывается **последним действием захода** — после того, как работа закоммичена, а PR открыт
 или влит. Команда ничего не мержит, не пушит и не открывает: закрытие захода — уборка, а не
 поставка.
 
@@ -45,7 +45,7 @@ branch="$(git branch --show-current)"
 ```
 
 Работа идёт **по правилу**, если имя ветки несёт номер задачи — это `rt_task_branch_ok` из
-профиля — или если в каталоге папок задач лежит папка с именем ветки. Отчёт **влит**, когда
+профиля — или если в каталоге папок задач лежит папка с именем ветки. PR **влит**, когда
 коммиты ветки уже есть в удалённой главной:
 
 ```bash
@@ -54,7 +54,7 @@ git merge-base --is-ancestor HEAD "origin/${RT_MAIN_BRANCH:-main}" && echo вл
 
 ## 4. Приведи дерево к главной ветке
 
-- **Работа по правилу и отчёт влит** — задача закрыта, ветка больше не нужна:
+- **Работа по правилу и PR влит** — задача закрыта, ветка больше не нужна:
 
     ```bash
     git switch "${RT_MAIN_BRANCH:-main}" && git pull --ff-only
@@ -116,7 +116,7 @@ mkdir -p "${RT_HANDOFF_DIR:-.claude/handoff}"
 
 ## Чего команда не делает
 
-- не мержит отчёт и не пушит: это поставка, и вслепую она не делается;
+- не мержит PR и не пушит: это поставка, и вслепую она не делается;
 - не сносит невлитую ветку и не трогает папку задачи;
 - не коммитит передачу — она лежит вне дерева намеренно, иначе рядом с ходом работы заводится
   вторая запись об одном и том же.

package/assets/commands/rules-review.md

@@ -0,0 +1,98 @@
+---
+description: Смысловое ревью семьи текстов слоя правил — закон, его правила и паттерны при них
+argument-hint: '<имя закона>'
+---
+
+Прогони смысловое ревью одной семьи текстов пакета правил. Семья: `$ARGUMENTS`
+
+Зовётся **в репозитории самого пакета**, а не в дереве, где он стоит: судятся исходные тексты
+ресурсов, и лежат они только здесь. В чужом дереве лежит разложенная копия выбранных ресурсов, а
+не семья целиком, и путей, по которым команда ходит, в нём нет вовсе: обход по ним вернёт
+пустоту, неотличимую от «такого закона не бывает». Каталог ресурсов ниже назван так, как он
+зовётся в репозитории пакета.
+
+Считаемое ловит проверка полноты текстов — недостающий раздел, правило без паттерна, имя соседа,
+которому в наборе ничего не отвечает. Здесь ищется то, чего она не считает: два текста,
+говорящих об одном разное, и случай, которого не назвал ни один. Ответ роли не повторяется от
+запуска к запуску, поэтому в гейт он не идёт и ветку не отбивает.
+
+## 1. Пойми, какая семья
+
+Семья зовётся именем закона — без пути и без расширения: `work-conduct`, `delivery`,
+`project-documentation`.
+
+```bash
+ls projects/agent-kit/assets/laws/*.md projects/agent-kit/assets/laws/*/*.md
+```
+
+**Имени нет** — назови человеку перечень имён и остановись. Догадываться по похожести нельзя:
+ревью уйдёт на чужую семью, и его находки человек примет за находки о своей.
+
+**Названо несколько** — гони по одной, по очереди, и ответы не смешивай: находка семьи читается
+вместе с её законом, а сваленные в кучу они теряют адрес.
+
+**Довода нет вовсе** — потребуй имя и напечатай перечень. Умолчания здесь нет: «первый
+попавшийся закон» даёт прогон, неотличимый от осмысленного.
+
+**Закон лежит в слое приложения** — это законный случай, а не промах: у денег, локалей и доступа
+семья такая же. Читается он оттуда же, где лежит.
+
+## 2. Собери семью
+
+Правило принадлежит закону полем `law:`, паттерн правилу — полем `rule:`. Приставка имени
+ненадёжна: её несут не все паттерны.
+
+```bash
+LAW=<имя закона>
+grep -l "^law: $LAW\$" projects/agent-kit/assets/rules/*.md
+```
+
+Дальше по каждому найденному правилу — его паттерны. Имя правила для поиска берётся голым: без
+вида и без требования — оба стоят суффиксами в имени файла, а поле `rule:` у паттерна несёт
+только само имя.
+
+```bash
+RULE=<имя правила: первое слово имени файла, до первой точки>
+grep -l "^rule: $RULE\$" projects/agent-kit/assets/patterns/*.md
+```
+
+**Виды берутся все.** `git-workflow.github`, `git-workflow.gitlab`, `git-workflow.azure` — три
+редакции одного правила: дерево раскладывает одну, а расходятся они молча.
+
+**Суффикс требования — не вид.** `entity-conventions.needs-admin`, `observability.needs-app` —
+это правила, которые дерево берёт, только когда объявило нужную черту. Имя с этим суффиксом в
+поле `rule:` не стоит ни у одного паттерна: поиск по нему возвращает пустоту, и семья уезжает в
+ревью без паттернов вовсе — молча, потому что пустой ответ выглядит как «паттернов нет».
+
+**У закона нет ни одного правила** — скажи это человеку и остановись. Читать один закон нечем:
+расхождение живёт между двумя текстами, а пробел уровня статьи без правил под ней — не находка
+ревью, а отсутствие целого слоя. Сам по себе такой закон стоит разговора: его находит и проверка
+полноты текстов, и она же скажет, сколько их.
+
+## 3. Запусти роль
+
+Инструментом `Agent`, `subagent_type: 'rules-reviewer'`. В промпт — имя закона и полный список
+путей: закон, все его правила со всеми видами, все паттерны при них. Список собираешь ты: роль
+git-команд не зовёт и историю не читает.
+
+Одна роль на семью. Веер из нескольких ролей со сведением ответов здесь не заводится: взгляд на
+предмет один — два текста об одном говорят разное, — а сведение превращает дословные цитаты в
+пересказ.
+
+## 4. Покажи находки человеку
+
+**Как есть.** Роль возвращает цитаты дословно, и пересказ их портит: по пересказу человек не
+отличит настоящее расхождение от прочтения роли.
+
+Порядок сохрани: сперва расхождения — у каждого два места и две цитаты, — потом пробелы, у
+которых второго места нет.
+
+По каждой находке скажи своё: согласен или нет и почему. Правку не вноси — тексты правил
+действуют на все будущие сессии всех деревьев, и решает по ним человек.
+
+Находка, с которой человек согласился, идёт дальше двумя путями, и выбирает он:
+
+- **правится тут же** — если это правка текста пакета и она укладывается в текущую работу;
+- **уходит задачей** в очередь работ — если тянет за собой код, раскладку или другой закон.
+
+Пустой ответ роли — тоже результат: скажи, что находок нет, и не выдумывай их из вежливости.