@rt-tools/agent-kit 0.2.0 → 0.3.0

package/assets/hooks/sql-guard.sh

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+# Гард пишущих запросов к хранилищу. PreToolUse.
+#
+# Правка данных — единственное действие, которое нельзя откатить правкой кода. Удаление по
+# маске однажды уносит вместе с пробными записями настоящие: маска совпадает шире, чем ожидал
+# автор запроса, и узнаётся это уже по восстановлению из копии.
+#
+# Отсюда правило: строки адресуются по первичному ключу. Перечисление идентификаторов
+# затрагивает ровно столько строк, сколько их перечислено, и промах виден до выполнения;
+# отбор по подстроке не виден никогда.
+#
+# Три уровня:
+#   отказ    — снос, очистка, правка схемы, удаление и обновление без условия или с условием
+#              не по идентификатору;
+#   вопрос   — остальная запись: адресная правка и вставка, решение за владельцем;
+#   пропуск  — чтение.
+#
+# Боевое хранилище отдельно: его адреса перечисляет профиль проекта ({{projectProfile}},
+# переменная RT_PROD_DSN) — там любая запись отказывается без опт-аута. Бой правится миграцией
+# через выкатку, а не запросом из редактора.
+#
+# Опт-аут для остальных случаев: маркер `destructive-ok` в тексте запроса вместе с объяснением,
+# почему адресация по идентификатору не подходит, понижает отказ до вопроса. Последнее слово
+# остаётся за владельцем — гард лишь не пропускает такое молча.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+
+sql=""
+case "$tool" in
+    mcp__webstorm__execute_sql_query)
+        sql="$(printf '%s' "$input" | jq -r '.tool_input.queryText // empty' 2>/dev/null)"
+        ;;
+    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
+        cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+        [ -z "$cmd" ] && exit 0
+
+        # Клиент ищется КАК СЛОВО в любом месте команды, а не только в начале: удаление на бою
+        # выглядит как заход по сети с вложенной командой клиента, и проверка одного лишь
+        # начала строки проходит мимо него целиком.
+        #
+        # Порядок принципиален. Отсечка «команда начинается с гита», снимающая ложные
+        # срабатывания на тексте коммита, открывает обход: в составной команде первое звено
+        # уносит с собой весь остальной запрос. Поэтому сперва ищется клиент.
+        printf '%s\n' "$cmd" | grep -qE '(^|[^[:alnum:]_.-])(psql|pg_restore|pg_dump|prisma)([^[:alnum:]_.-]|$)' || exit 0
+
+        # Ложные срабатывания на описаниях снимаются вырезанием текстов сообщений, а не отказом
+        # от проверки всей команды: в самом сообщении запрос не исполняется, но слова «удалить»
+        # и «обновить» в нём обычны.
+        if command -v perl >/dev/null 2>&1; then
+            # Флага файла в списке быть не должно: под него попадает файл запроса у клиента, и
+            # признак «запрос приехал файлом» умирает раньше, чем его проверят.
+            cmd="$(printf '%s' "$cmd" | perl -0pe '
+                s/(^|[^[:alnum:]])--?[a-zA-Z]*(m|message|body|title|body-file|F)(=|\s+)("([^"\\]|\\.)*"|\x27[^\x27]*\x27|[^\s;&|]+)/$1/gs
+            ' 2>/dev/null || printf '%s' "$cmd")"
+            printf '%s\n' "$cmd" | grep -qE '(^|[^[:alnum:]_.-])(psql|pg_restore|pg_dump|prisma)([^[:alnum:]_.-]|$)' || exit 0
+        else
+            # Без разборщика вырезать текст сообщения нечем, и разбирать его как запрос нельзя:
+            # штатный коммит упирался бы в отказ. Доставки запроса внутри команды истории не
+            # бывает, поэтому здесь дешевле пропустить, чем ломать работу.
+            case "$cmd" in
+                git\ *|*/git\ *|gh\ *|*/gh\ *) exit 0 ;;
+            esac
+        fi
+
+        sql="$cmd"
+        ;;
+    *) exit 0 ;;
+esac
+
+[ -z "$sql" ] && exit 0
+
+# Дальше разбираем без учёта регистра: запрос, разбитый на строки, — тот же запрос.
+flat="$(printf '%s' "$sql" | tr '\n' ' ' | tr '[:upper:]' '[:lower:]')"
+
+deny() {
+    echo "$1 Адресуй строки по первичному ключу: перечисление идентификаторов затрагивает ровно столько строк, сколько их названо, и промах виден до выполнения. Если адресация по идентификатору здесь не подходит, поставь маркер destructive-ok в текст запроса с объяснением — решение тогда примет владелец." >&2
+    exit 2
+}
+
+ask() {
+    jq -n --arg r "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"ask",permissionDecisionReason:$r}}' 2>/dev/null
+    exit 0
+}
+
+# Бой: адреса знает профиль. Там любая запись отказывается, и опт-аут не действует.
+profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
+if [ -f "$profile" ]; then
+    # shellcheck disable=SC1090
+    . "$profile" 2>/dev/null
+    if [ -n "${RT_PROD_DSN:-}" ] && printf '%s' "$flat" | grep -qF "$RT_PROD_DSN"; then
+        case "$flat" in
+            *insert\ *|*update\ *|*delete\ *|*drop\ *|*truncate\ *|*alter\ *)
+                echo "Запись в боевое хранилище запрещена совсем: схема меняется миграцией через выкатку, данные — через интерфейс." >&2
+                exit 2 ;;
+        esac
+    fi
+fi
+
+opt_out=0
+case "$flat" in *destructive-ok*) opt_out=1 ;; esac
+
+case "$flat" in
+    *drop\ *|*truncate\ *|*alter\ table*)
+        [ "$opt_out" = 1 ] && ask "Схемная команда с маркером destructive-ok. Решение за тобой."
+        deny "Снос, очистка или правка схемы запросом." ;;
+esac
+
+case "$flat" in
+    *delete\ from*|*update\ *set\ *)
+        # Условие по идентификатору — единственная форма, где число задетых строк известно
+        # заранее. Отбор по подстроке им не является, даже когда сегодня совпадает точно.
+        if printf '%s' "$flat" | grep -qE 'where[^;]*\b(id|uuid)\b[[:space:]]*(=|in[[:space:]]*\()'; then
+            ask "Адресная правка данных. Решение за тобой."
+        fi
+        [ "$opt_out" = 1 ] && ask "Правка без адресации по идентификатору, с маркером destructive-ok. Решение за тобой."
+        deny "Удаление или обновление без условия по идентификатору." ;;
+esac
+
+case "$flat" in
+    *insert\ into*) ask "Вставка данных. Решение за тобой." ;;
+esac
+
+exit 0

package/assets/patterns/angular-patterns-state.md

@@ -0,0 +1,94 @@
+---
+name: angular-patterns-state
+kind: pattern
+rule: angular-patterns
+description: Паттерн правила angular-patterns. Брать при объявлении состояния и потоков в классе фронтового каркаса — реактивные входы и выходы, производные значения, состояние службы, долгоживущая подписка с источником действия. Не брать для раскладки файла компонента — это паттерн component-structure-new.
+---
+
+# Состояние и потоки
+
+Паттерн правила `angular-patterns`. Что при этом должно быть верно — закон
+`{{lawsDir}}/frontend-application.md`.
+
+## Когда брать
+
+- Объявляется состояние компонента или службы.
+- Появляется поток, на который надо подписаться.
+- Значение считается из другого значения.
+
+## Реактивные входы и выходы
+
+```typescript
+public readonly data: InputSignal<Item[]> = input.required<Item[]>();
+public readonly isNarrow: InputSignal<boolean | undefined> = input<boolean>();
+public readonly save: OutputEmitterRef<void> = output<void>();
+
+protected readonly myButton: Signal<ElementRef | undefined> = viewChild<ElementRef>('button');
+```
+
+Декораторной формы входов, выходов и запросов к разметке в дереве нет: у неё нет типа, который
+видно в месте использования, и нет реактивности, на которую можно подписаться.
+
+## Производное значение — вычисляемое, а не эффект
+
+```typescript
+✗ effect((): void => { this.count.set(this.items().length); });
+✓ protected readonly count: Signal<number> = computed((): number => this.items().length);
+```
+
+Эффект, кладущий значение в реактивное поле, — это ручной пересчёт, и он рано или поздно
+отстаёт от источника. Геттера в компоненте не заводить: он пересчитывается на каждой
+перерисовке, и цена его не видна ни в одном месте кода.
+
+## Состояние службы
+
+Наружу — только чтение:
+
+```typescript
+@Injectable({ providedIn: 'root' })
+export class DomainStateService {
+    readonly #items: WritableSignal<Item[]> = signal<Item[]>([]);
+
+    public readonly items: Signal<Item[]> = this.#items.asReadonly();
+    public readonly itemCount: Signal<number> = computed((): number => this.#items().length);
+
+    public addItem(item: Item): void {
+        this.#items.update((items: Item[]): Item[] => [...items, item]);
+    }
+}
+```
+
+## Подписка объявляется один раз
+
+Метод действия толкает значение в источник, подписка живёт при создании владельца:
+
+```typescript
+readonly #loadSource: Subject<void> = new Subject<void>();
+readonly #destroyRef: DestroyRef = inject(DestroyRef);
+
+constructor() {
+    this.#loadSource
+        .pipe(
+            switchMap((): Observable<IResult> => this.#api.getList(this.#query())),
+            takeUntilDestroyed(this.#destroyRef)
+        )
+        .subscribe();
+}
+
+protected reload(): void {
+    this.#loadSource.next();
+}
+```
+
+Оператор выбирается по тому, что делать с предыдущим запросом: список берёт последний ответ,
+кнопка не плодит дублей, независимые строки идут параллельно.
+
+## Частые промахи
+
+- **Подписка внутри метода:** правило линтера отбивает, а вместе с ним отбивается и гонка
+  ответов на быстрых нажатиях.
+- **Подписка без гашения:** она переживает владельца и держит уничтоженный экран в памяти.
+- **Поле-поток без суффикса источника:** поток и значение в коде становятся неотличимы.
+- **Параметры конструктора вместо функции внедрения** — везде, включая базовые классы.
+- **Эффект без снятия слежения там, где зависимость не нужна:** он просыпается на каждое чужое
+  изменение.

package/assets/patterns/api-layer-pair.md

@@ -0,0 +1,78 @@
+---
+name: api-layer-pair
+kind: pattern
+rule: api-layer
+description: Паттерн правила api-layer. Брать при заведении или правке слоя обращения к серверу во фронтовом домене — готовые фасад и служба, единственный вход выборки, общий конвертер страницы, типы порядка и отбора при сущности.
+---
+
+# Фасад и служба домена
+
+Паттерн правила `api-layer`. Что при этом должно быть верно — закон
+`{{lawsDir}}/frontend-application.md`.
+
+## Когда брать
+
+- Заводится слой обращения к серверу у нового домена.
+- Список переводится на общую выборку.
+- Появляется новый обработчик, за которым ходит экран.
+
+## Фасад
+
+Принимает запрос контракта, отдаёт ответ контракта, ожидание заворачивает в поток. Ни выборки,
+ни перевода моделей в нём нет:
+
+```typescript
+@Injectable({ providedIn: 'root' })
+export class EntityApiFacade implements IListApiFacade<TListRequest, TListResponse, TItemResponse> {
+    readonly #client: Client<typeof DomainService> = injectClient(DomainService);
+
+    public getList(request: TListRequest): Observable<TListResponse> {
+        return from(this.#client.listItems(request));
+    }
+}
+```
+
+Метод, которого у домена нет, не объявляется: список читают все, правят не все.
+
+## Служба
+
+Принимает доменные модели, отдаёт их же. Тип контракта до стора и шаблона не доходит:
+
+```typescript
+export class EntityApiService implements IListApiService<IEntity.State, ESortProperty, EFilterProperty, IEntity.Draft> {
+    public getList(query: IEntity.Query): Observable<IEntity.ListResult> {
+        return this.#facade
+            .getList({ query: this.#queryMapper.mapTo(query) })
+            .pipe(
+                map((response: TListResponse): IEntity.ListResult =>
+                    convertPaginationApiModelToStateModel((item: TItem): IEntity.State => this.#mapper.mapFrom(item), response)
+                )
+            );
+    }
+}
+```
+
+Выборка — единственный вход: объект, к которому привязан список, род ленты, состояние подписки
+— это условия отбора, и лежат они в её условиях.
+
+## Типы выборки при сущности
+
+```typescript
+export type Query = IList.Query.State<ESortProperty, EFilterProperty>;
+export type ListResult = IList.Result.State<IEntity.State, ESortProperty, EFilterProperty>;
+```
+
+Перечисления порядка и отбора объявляются рядом с сущностью и повторяют набор имён, по которым
+сортирует и отбирает сервер именно этого домена.
+
+## Частые промахи
+
+- **Промежуточный объект между ответом и моделью:** ответ ложится в конвертер целиком.
+- **Выборка из своего запроса вместо применённой из ответа:** умолчание сервера и отброшенное
+  им условие экран иначе не увидит.
+- **Второй вход рядом с выборкой:** отбор, живущий отдельно, не виден ни стору, ни адресу.
+- **Голая строка в поле порядка:** имя, по которому сервер не сортирует, компилируется и падает
+  запросом.
+- **Один класс на две сущности:** подмена источника одной потянет за собой правку другой.
+- **Служба на обещаниях в новом сторе:** основа списочного стора работает потоками.
+- **Своя копия общих переводчиков страницы, порядка и отбора** — её ловит проверка повторов.

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

@@ -0,0 +1,83 @@
+---
+name: browser-verification-measure
+kind: pattern
+rule: browser-verification
+description: Паттерн правила browser-verification. Брать, когда вывод о вёрстке надо подкрепить числом — готовые замеры, разбивка вычисленного значения по всем узлам, узкий экран вложенной рамкой, ловушки инструмента снимка экрана. Не брать для подъёма стенда — это паттерн browser-verification-stand.
+---
+
+# Замер вместо взгляда
+
+Паттерн правила `browser-verification`. Что при этом должно быть верно — закон
+`{{lawsDir}}/verifiability.md`.
+
+## Когда брать
+
+- Правилась вёрстка, и надо подтвердить результат.
+- Экран выглядит не так, а искать нечего: поиск по коду отвечает «чисто».
+- Проверяется узкий экран.
+
+## Вывод подкрепляется числом
+
+Вычисленный стиль, прямоугольник элемента, контраст, совпадение центров, попадание в видимую
+область. «Выглядит нормально» результатом проверки не является.
+
+Замер отвечает только на тот вопрос, который задали. Совпадение перечисленных свойств ничего не
+говорит о правиле, которого в списке замера нет. Если исходники образца доступны, расхождение
+ищется чтением, а замер остаётся проверкой результата.
+
+Вид элемента, которого сегодня не видно ни на одном экране, замером не подтверждается, и
+правило о нём остаётся гипотезой.
+
+## Значение, которого в коде нет
+
+Гарнитуру, межстрочный интервал, цвет и оформление элементам формы задаёт браузер, и в дереве
+этих значений нет. Поиск по коду на такой дефект отвечает «чисто», линтер и сборка молчат.
+Ищется разбивкой вычисленного значения по всем узлам страницы, а не замером у пары элементов:
+
+```javascript
+[...document.querySelectorAll('*')].reduce((acc, el) => {
+    const key = getComputedStyle(el).fontFamily;
+    acc[key] = (acc[key] ?? 0) + 1;
+    return acc;
+}, {});
+```
+
+Счёт годится любому наследуемому свойству: смотрится не одно значение, а число узлов с
+неожиданным. Так находятся десятки элементов, набранных не той гарнитурой, — по одному их не
+заметил бы никто.
+
+## Узкий экран
+
+Изменение размера окна не работает, когда браузер в полноэкранном режиме: инструмент рапортует
+успех, ширина не меняется, медиазапросы остаются широкими. Узкие ширины проверяются во
+вложенной рамке нужной ширины — внутри неё запрос ширины считается от рамки, и рамка своей
+толщиной уменьшает внутреннюю ширину.
+
+Правка числа элементов в контейнере — это правка раскладки: она проверяется на узкой ширине, а
+не только кодами ответа.
+
+## Ловушки инструмента снимка экрана
+
+- **Координаты нажатия — координаты снимка, а не страницы.** При широком окне снимок приходит
+  уже, и нажатие по «увиденной» координате уходит мимо, давая ложный сигнал: пересчитывать по
+  фактическому масштабу либо целиться поиском элемента.
+- **Область приближения должна целиком лежать внутри видимой области.**
+- **Между нажатиями обязательно ожидание:** цикл «нажал — прочитал разметку» без него читает
+  состояние до перерисовки и возвращает устаревшие значения.
+- **Выбор браузера протухает.** На длинной проверке это срабатывает посреди работы — не сбой
+  стенда, а повод повторить вызов и продолжить.
+
+## Поведение маршрутизации воспроизводится нажатиями
+
+Подстановка адреса, программный переход и заход по прямой ссылке поднимают приложение заново, и
+накопленного состояния — открытой панели, стража прошлого экрана — у него нет. Чистый проход по
+адресам читается как «дефект не подтверждается».
+
+## Частые промахи
+
+- **Комментарий в конфиге — гипотеза наравне с прочими.** Утверждение о поведении кэша
+  переживает несколько кругов разбора кода и опровергается одним запросом.
+- **Вывод «дефекта нет, это кэш» закрывает разбор**, поэтому принимается только после проверки
+  на чистой сборке.
+- **Дефект в клиентском куске от компиляции до правки выглядит как дефект кода** — признак
+  сборки для разработки — имена файлов без хеша.

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

@@ -0,0 +1,79 @@
+---
+name: browser-verification-stand
+kind: pattern
+rule: browser-verification
+description: Паттерн правила browser-verification. Брать, когда нужен честный стенд — прод-сборка, стенд под настоящим прокси, вход в приложение, разбор того, что висит на порту, стенд серверной стороны с переменными окружения. Не брать для замеров вёрстки — это паттерн browser-verification-measure.
+---
+
+# Честный стенд
+
+Паттерн правила `browser-verification`. Что при этом должно быть верно — закон
+`{{lawsDir}}/verifiability.md`.
+
+## Когда брать
+
+- Проверяется то, чего на сервере разработки не видно: разметка от сервера, локали, кэш,
+  перенаправления, заголовки, размер сборки.
+- Порт отвечает не тем, чего ждали.
+- Нужен вход в приложение.
+
+## Сначала — что отвечает на порту
+
+До первого запроса, а не после непонятного ответа:
+
+```bash
+lsof -nP -iTCP:<порт> -sTCP:LISTEN
+```
+
+На порту регулярно висит собранный артефакт из прошлой сессии: он отвечает успехом на старом
+коде, а заведённого в ветке обработчика у него нет вовсе. Таких процессов бывает несколько, и
+снимать надо все — по идентификатору из вывода, каждый: завершение по шаблону команды не
+попадает ни в один.
+
+## Прод-сборка
+
+Собранный сервер поднимается прямо, а не через сервер разработки: гард ловит запуск сервера
+разработки, пакетные раннеры и статические серверы, а запуск собранного сервера пропускает.
+
+Приложению, отдающему статику, нужен явный базовый адрес — без него стенд отдаёт пустую
+страницу без единой ошибки в консоли. Стенду, на котором нужны отладочные инструменты каркаса,
+нужна сборка для разработки: прод-сборка их не публикует. Выводы о размере сборки и минификации
+на такой сборке делать нельзя.
+
+## Вход в приложение
+
+Сессия кладётся в хранилище браузера ровно в той форме, в какой её читает приложение: значение,
+записанное иначе, приложение молча не увидит. Токен не подписывается руками, а берётся у живого
+сервера входом.
+
+Взять уже открытую сессию нельзя: чтение хранилища чужого профиля блокируется. Оба пути к
+своему стенду упираются в пароль, поэтому остаётся третий — смотреть там, где вход уже сделан.
+Свой стенд нужен, только когда проверяют прод-сборку, базовый адрес или конфиг прокси; чтобы
+просто посмотреть экраны, он не нужен.
+
+## Стенд серверной стороны
+
+Собранный артефакт поднимается на свободном порту, а не на рабочем: на рабочем отвечает сервер
+владельца, и окружение у него не то, которое проверяется.
+
+Переменные окружения задаются в самой команде, по одной на проверяемый случай. Отказ на старте
+— такой же результат проверки, как успешный ответ: приложение, упавшее при сборке зависимостей,
+порт не слушает вовсе, и это видно по списку слушателей, а не по тексту в консоли.
+
+Обработчик зовётся полным именем, как его объявляет контракт. Токен подписывается руками только
+там, где проверяется сама подпись; во всех остальных случаях он берётся у живого сервера входом
+— рукописный скрывает расхождение состава притязаний.
+
+## Стенд под настоящим прокси
+
+Кэш, перенаправления и заголовки живут в конфиге прокси, а не в приложении, и любой вывод о них
+с голого сервера отдачи страниц неверен. Устройство такого стенда — паттерн `testing-e2e`.
+
+## Частые промахи
+
+- **Порт занят чужой сборкой, а ответ читается как дефект ветки.** Сначала список слушателей,
+  потом запрос.
+- **Стенд без явного базового адреса отдаёт пустую страницу** и ни одной ошибки при этом не
+  печатает.
+- **Токен, подписанный руками, скрывает расхождение состава притязаний** — вход берётся у
+  живого сервера.

package/assets/patterns/component-structure-new.md

@@ -0,0 +1,98 @@
+---
+name: component-structure-new
+kind: pattern
+rule: component-structure
+description: Паттерн правила component-structure. Брать при заведении или правке файла компонента — порядок свойств декоратора, группировка импортов, раскладка полей класса, договорённости шаблона и якорь для спек. Не брать для состояния и потоков — это паттерн angular-patterns-state.
+---
+
+# Файл компонента
+
+Паттерн правила `component-structure`. Что при этом должно быть верно — закон
+`{{lawsDir}}/frontend-application.md`.
+
+## Когда брать
+
+- Заводится новый компонент.
+- Правится декоратор, список импортов или шаблон существующего.
+
+## Декоратор: порядок свойств
+
+```typescript
+@Component({
+    selector: '<префикс>-component-name', // 1. селектор
+    templateUrl: './component-name.component.html', // 2. шаблон
+    styleUrl: './component-name.component.scss', // 3. стиль, в единственном числе
+    changeDetection: ChangeDetectionStrategy.OnPush, // 4. стратегия перерисовки
+    imports: [
+        // 5. импорты, группами
+        // каркас
+        FormsModule,
+
+        // директивы разметки
+        BlockDirective,
+        ElemDirective,
+
+        // компоненты
+        SomeChildComponent,
+    ],
+    providers: [], // 6. провайдеры
+    host: { class: '<префикс>-component-name' }, // 7. привязки хоста
+})
+export class ComponentNameComponent {
+    readonly #someService: SomeService = inject(SomeService);
+
+    public readonly data: InputSignal<Item[]> = input.required<Item[]>();
+    public readonly save: OutputEmitterRef<void> = output<void>();
+
+    protected readonly items: WritableSignal<Item[]> = signal<Item[]>([]);
+    protected readonly itemCount: Signal<number> = computed((): number => this.items().length);
+}
+```
+
+Группирующие комментарии в импортах обязательны: без них список растёт вперемешку, и первое,
+что в нём теряется, — свои компоненты среди чужих.
+
+## Шаблон
+
+- Самозакрывающиеся теги у компонентов без содержимого.
+- Лишних обёрток нет — корнем работает хост, класс блока приходит его привязкой.
+- Сложный шаблон объявляет блок в корне отдельной директивой.
+- Один компонент в обеих ветках условия — это условная привязка:
+
+```html
+<!-- ✗ -->
+@if (isRangeMode()) {
+<calendar [rangeMode]="true" />
+} @else {
+<calendar [rangeMode]="false" />
+}
+
+<!-- ✓ -->
+<calendar [rangeMode]="isRangeMode()" />
+```
+
+- Прокрутка по документу — средствами маршрутизатора, а не ссылкой на фрагмент: при объявленном
+  базовом адресе браузер разрешает фрагмент относительно него и уходит в полную навигацию.
+
+## Якорь для спек — на каждый интерактивный элемент
+
+```html
+<button qa-dataid="calendar-retry-prices" type="button" (click)="retryPrices.emit()">Повторить</button>
+<div rtElem="grid" qa-dataid="admin-calendar-grid"></div>
+```
+
+- Значение — через дефис, по смыслу элемента, без имени компонента-обёртки.
+- Уникальность — в пределах экрана; повторяющиеся элементы списка носят один якорь и
+  различаются атрибутами данных.
+- Декоративный элемент помечается признаком пропуска на самом теге.
+
+## Частые промахи
+
+- **Чужой префикс селектора** — компонент перестаёт узнаваться как свой.
+- **Множественная форма свойства стилей вместо единственной** — стиль молча не подключается.
+- **Вызов метода в привязке** — отбивается линтером; замена — вычисляемое значение, а там, где
+  оно зависит от контекста шаблона, — чистый преобразователь.
+- **Обёртка, которая существует только чтобы быть контейнером раскладки вокруг всех детей:** её
+  раскладка уезжает на хост.
+- **Глубокий относительный импорт между либами** вместо алиаса.
+- **Своя разметка вместо готового компонента** — правило `reuse-first`.