@sberbusiness/triplex-next-mcp-server 0.24.0-beta2 → 1.40.0-beta

package/bundle/components/Title.md

@@ -0,0 +1,296 @@
+---
+component: Title
+category: Typography
+related: [Text, Caption, CodeText]
+tokens:
+  - --triplex-next-Typography-Primary_Color
+  - --triplex-next-Typography-PrimaryInvert_Color
+  - --triplex-next-Typography-Complementary_Color
+  - --triplex-next-Typography-ComplementaryInvert_Color
+  - --triplex-next-Typography-Secondary_Color
+  - --triplex-next-Typography-SecondaryInvert_Color
+  - --triplex-next-Typography-Tertiary_Color
+  - --triplex-next-Typography-TertiaryInvert_Color
+  - --triplex-next-Typography-Disabled_Color
+  - --triplex-next-Typography-DisabledInvert_Color
+  - --triplex-next-Typography-Brand_Color
+  - --triplex-next-Typography-BrandInvert_Color
+  - --triplex-next-Typography-Info_Color
+  - --triplex-next-Typography-InfoInvert_Color
+  - --triplex-next-Typography-Success_Color
+  - --triplex-next-Typography-SuccessInvert_Color
+  - --triplex-next-Typography-Warning_Color
+  - --triplex-next-Typography-WarningInvert_Color
+  - --triplex-next-Typography-Error_Color
+  - --triplex-next-Typography-ErrorInvert_Color
+  - --triplex-next-Typography-System_Color
+  - --triplex-next-Typography-SystemInvert_Color
+stories: stories/Typography/Title.stories.tsx
+version: "1.0"
+---
+
+# Title
+
+## Назначение
+
+Заголовок (типографика). Рендерит семантический heading `<h1>`–`<h3>` (тег по умолчанию совпадает со значением `size`) со шрифтом SBSansDisplay и цветом из палитры `EFontType`. `margin` у заголовков обнулён — отступы задаёт layout потребителя.
+
+Используй когда: нужен заголовок страницы, секции, карточки или модального окна.
+
+Не используй когда:
+- Нужен обычный текст интерфейса — используй `Text`.
+- Нужна крупная цифра/показатель (32px), не являющаяся заголовком — используй `Caption` с размером `D1`.
+
+---
+
+## Варианты и props
+
+### Обязательные props
+
+| Prop | Тип | Описание |
+|---|---|---|
+| `size` | `ETitleSize` | Размер заголовка: `H1` (28/36px), `H2` (24/32px), `H3` (20/28px). В скобках — font-size/line-height. Значения enum — строки `"h1"`/`"h2"`/`"h3"`. |
+
+### Опциональные props
+
+| Prop | Тип | По умолчанию | Описание |
+|---|---|---|---|
+| `weight` | `EFontWeightTitle` | `SEMIBOLD` | Начертание: `REGULAR` / `MEDIUM` (500) / `SEMIBOLD` (600) / `BOLD` (700). Каждому соответствует своё семейство SBSansDisplay*. |
+| `type` | `EFontType` | `PRIMARY` | Цвет текста из общей палитры типографики (11 базовых + 11 `*_INVERT`). |
+| `underline` | `boolean` | — | Подчёркивание. Совместим со `strikethrough` (оба сразу — `underline line-through`). |
+| `strikethrough` | `boolean` | — | Зачёркивание. |
+| `tag` | `string` | значение `size` | HTML-тег корневого элемента. По умолчанию равен значению `size` (`"h1"`/`"h2"`/`"h3"`) — визуальный размер и уровень heading связаны. Передай `tag` явно, чтобы развязать их (например, `size={ETitleSize.H1} tag="h2"`). |
+
+Компонент типизирован как `TTitleProps<T extends keyof JSX.IntrinsicElements>` и принимает все атрибуты соответствующего HTML-элемента через spread.
+
+### Ограничения
+
+- Внешний тип `forwardRef<HTMLElement, TTitleProps<keyof JSX.IntrinsicElements>>` «растворяет» дженерик: TypeScript не сужает атрибуты под конкретный `tag`. Известное ограничение публичного API, не исправлять без обсуждения (breaking).
+- Дефолт `` tag = `${size}` `` — намеренный трюк (значения `ETitleSize` совпадают с именами тегов); при изменении значений enum сломается и дефолтный тег — ещё одна причина не трогать значения.
+- `EFontType.BRAND` дополнительно задаёт `user-select: none` (особенность стилей `Typography.module.less`).
+
+---
+
+## Дизайн-токены
+
+Цвета — общие CSS-переменные семейства Typography (см. frontmatter): `--triplex-next-Typography-{Type}_Color` и `--triplex-next-Typography-{Type}Invert_Color`.
+
+Размеры шрифта и line-height — фиксированные пиксельные значения в `styles/Title.module.less` (токенов для них нет).
+
+---
+
+## Инварианты
+
+- **`forwardRef`** — обязателен, `ref` пробрасывается на корневой heading-элемент.
+- **Значения enum** `ETitleSize` (строки `"h1"`/`"h2"`/`"h3"`), `EFontWeightTitle`, `EFontType` — публичный API из barrel. Изменение — breaking change; значения `ETitleSize` дополнительно используются как дефолтный `tag`.
+- **`TTitleProps`**, **`ITypographyProps`** — публичные типы.
+- **`displayName = "Title"`** — не убирать.
+- `margin: 0` на `h1`–`h3` в `Title.module.less` — контракт: отступы вокруг заголовка задаёт потребитель.
+- Классы собираются только через `clsx`.
+
+---
+
+## Accessibility
+
+- По умолчанию рендерится настоящий heading (`<h1>`–`<h3>`) — уровень в accessibility-дереве определяется `size`. Следи за иерархией заголовков страницы; если визуальный размер не совпадает с нужным уровнем — задай `tag` явно.
+- Компонент не интерактивный: focus management и keyboard navigation не применимы.
+- Цвет (`type`) не передаёт семантику для screen reader'ов.
+
+---
+
+## Связанные компоненты
+
+- `Text` — основной текст интерфейса (B1–B4, SBSansText).
+- `Caption` — мелкие подписи и крупный показатель D1.
+- `CodeText` — моноширинный текст.
+
+---
+
+## Stories
+
+Основные истории: `stories/Typography/Title.stories.tsx`
+Файлы примеров: `stories/Typography/examples/Title/`
+
+| Story | Example file | Что демонстрирует |
+|---|---|---|
+| `Playground` | `Playground.tsx` | Интерактивный контроль props `size`, `weight`, `type`, `tag`, `underline`, `strikethrough` |
+| `Default` | `Default.tsx` | Минимальное использование |
+| `Sizes` | `Sizes.tsx` | Размеры H1 / H2 / H3 |
+| `Weights` | `Weights.tsx` | Начертания REGULAR / MEDIUM / SEMIBOLD / BOLD |
+| `Types` | `Types.tsx` | Все значения `EFontType`: базовые + инвертированные на тёмной подложке |
+| `Decorations` | `Decorations.tsx` | `underline`, `strikethrough` и их комбинация |
+
+---
+
+## История изменений
+
+| Дата | Изменение |
+|---|---|
+| 2026-07-20 | Создан документ. AI-рефакторинг: decoration-логика вынесена во внутренний хелпер `getTextDecorationClassName` (`utils.ts`), комментарии переведены в JSDoc, unit-тесты расширены (все значения `ETitleSize`/`EFontWeightTitle`, дефолтные heading-теги). Stories переведены на modern pattern (`examples/Title/`). |
+
+---
+
+## Примеры использования
+
+### Default
+
+`stories/Typography/examples/Title/Default.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize } from "@sberbusiness/triplex-next";
+
+export const Default = () => <Title size={ETitleSize.H1}>Заголовок страницы</Title>;
+```
+
+### Sizes
+
+`stories/Typography/examples/Title/Sizes.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize } from "@sberbusiness/triplex-next";
+
+export const Sizes = () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+        <Title size={ETitleSize.H1}>Заголовок H1</Title>
+        <Title size={ETitleSize.H2}>Заголовок H2</Title>
+        <Title size={ETitleSize.H3}>Заголовок H3</Title>
+    </div>
+);
+```
+
+### Weights
+
+`stories/Typography/examples/Title/Weights.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize, EFontWeightTitle } from "@sberbusiness/triplex-next";
+
+export const Weights = () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.REGULAR}>
+            Regular - Обычный вес
+        </Title>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.MEDIUM}>
+            Medium - Средний вес
+        </Title>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.SEMIBOLD}>
+            Semibold - Полужирный
+        </Title>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.BOLD}>
+            Bold - Жирный
+        </Title>
+    </div>
+);
+```
+
+### Types
+
+`stories/Typography/examples/Title/Types.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize, EFontType } from "@sberbusiness/triplex-next";
+
+export const Types = () => (
+    <div style={{ display: "flex", gap: "16px" }}>
+        <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+            <Title size={ETitleSize.H2} type={EFontType.PRIMARY}>
+                Primary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.COMPLEMENTARY}>
+                Complementary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SECONDARY}>
+                Secondary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.TERTIARY}>
+                Tertiary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.BRAND}>
+                Brand
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.INFO}>
+                Info
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SUCCESS}>
+                Success
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.WARNING}>
+                Warning
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.ERROR}>
+                Error
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.DISABLED}>
+                Disabled
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SYSTEM}>
+                System
+            </Title>
+        </div>
+        <div style={{ display: "flex", flexDirection: "column", gap: "16px", backgroundColor: "#1F1F22" }}>
+            <Title size={ETitleSize.H2} type={EFontType.PRIMARY_INVERT}>
+                Primary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.COMPLEMENTARY_INVERT}>
+                Complementary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SECONDARY_INVERT}>
+                Secondary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.TERTIARY_INVERT}>
+                Tertiary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.BRAND_INVERT}>
+                Brand Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.INFO_INVERT}>
+                Info Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SUCCESS_INVERT}>
+                Success Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.WARNING_INVERT}>
+                Warning Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.ERROR_INVERT}>
+                Error Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.DISABLED_INVERT}>
+                Disabled Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SYSTEM_INVERT}>
+                System Invert
+            </Title>
+        </div>
+    </div>
+);
+```
+
+### Decorations
+
+`stories/Typography/examples/Title/Decorations.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize } from "@sberbusiness/triplex-next";
+
+export const Decorations = () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+        <Title size={ETitleSize.H2}>Заголовок без декораций</Title>
+        <Title size={ETitleSize.H2} underline>
+            Заголовок с подчеркиванием
+        </Title>
+        <Title size={ETitleSize.H2} strikethrough>
+            Заголовок с зачеркиванием
+        </Title>
+        <Title size={ETitleSize.H2} underline strikethrough>
+            Заголовок с подчеркиванием и зачеркиванием
+        </Title>
+    </div>
+);
+```
+

package/bundle/guides/codestyle.md

@@ -24,15 +24,15 @@
 
 ### Именование
 
-| Сущность | Префикс | Пример |
-|---|---|---|
-| Interface | `I` | `IButtonProps`, `IButtonGeneralProps` |
-| Union type | `T` | `TButtonProps` |
-| Enum | `E` | `EButtonTheme`, `EComponentSize` |
-| Константа (модульного уровня) | UPPER_SNAKE_CASE | `DEFAULT_TIMEOUT` |
-| Компонент | PascalCase | `Button`, `DateField` |
-| Хук | camelCase с `use` | `useClickOutside` |
-| Утилита | camelCase | `formatDate`, `uniqueId` |
+| Сущность                      | Префикс           | Пример                                |
+| ----------------------------- | ----------------- | ------------------------------------- |
+| Interface                     | `I`               | `IButtonProps`, `IButtonGeneralProps` |
+| Union type                    | `T`               | `TButtonProps`                        |
+| Enum                          | `E`               | `EButtonTheme`, `EComponentSize`      |
+| Константа (модульного уровня) | UPPER_SNAKE_CASE  | `DEFAULT_TIMEOUT`                     |
+| Компонент                     | PascalCase        | `Button`, `DateField`                 |
+| Хук                           | camelCase с `use` | `useClickOutside`                     |
+| Утилита                       | camelCase         | `formatDate`, `uniqueId`              |
 
 ### Интерфейсы компонента
 
@@ -113,10 +113,12 @@ import { Button } from "../Button";
 ```
 
 Правила:
+
 - В новых stories/examples, которые показывают копируемый код, импортируй публичный API из `@sberbusiness/triplex-next` или публичных subentry.
 - В unit-тестах и внутреннем коде следуй локальному паттерну файла и предпочитай ближайшие импорты для тестируемого модуля и внутренних зависимостей.
 
 Порядок импортов (prettier-plugin-organize-imports не используется, но придерживайся):
+
 1. React
 2. Сторонние библиотеки
 3. Внутренние (`@sberbusiness/triplex-next/...`)
@@ -133,9 +135,31 @@ import { Button } from "../Button";
 - Имена классов — **camelCase**: `styles.secondaryLight`, `styles.iconOnly`.
 - Никаких **inline styles** в компонентах (в stories допустимо для лейаута примеров).
 - **Цвета** — только через CSS-переменные токенов (`var(--triplex-next-...)`). Никаких hex/rgb.
+- Runtime CSS-переменные, которые компонент задаёт сам (например через `style` для динамической высоты,
+  transform или координат), называй с префиксом `--triplex-next-runtime-...`.
+  Они не являются дизайн-токенами и не должны попадать в `src/components/DesignTokens` или generated-файлы.
 - **Переиспользуемые размерные константы** (z-index, отступы страницы, ширины оверлеев) — через LESS-переменные из `src/styles/components/` (`@page-padding-desktop-x`, `@sideOverlayLGWidth` и т.д.). Компонент-специфичные значения (высота кнопки, радиус скругления) можно задавать литералом.
 - `!important` — только в крайнем случае, с комментарием почему.
 
+Паттерн runtime CSS-переменных:
+
+```text
+--triplex-next-runtime-{Component}-{Element}_{Property}
+```
+
+Примеры:
+
+```tsx
+interface IStyle extends React.CSSProperties {
+    "--triplex-next-runtime-ImageGalleryExtended-Track_Shift": string;
+}
+```
+
+```less
+.track {
+    transform: translateX(var(--triplex-next-runtime-ImageGalleryExtended-Track_Shift, 0%));
+}
+```
 
 ### Применение LESS-переменных (общие размерные константы)
 
@@ -166,7 +190,7 @@ import { Button } from "../Button";
 В stories добавляй пример значения для демонстрации — это не хардкод, а иллюстрация:
 
 ```typescript
-// В stories/examples/DefaultExample.tsx — пример для документации
+// В stories/examples/Default.tsx — пример для документации
 <ModalCloseButton aria-label="Закрыть" />
 ```
 
@@ -191,8 +215,11 @@ import { Button } from "../Button";
 ## Принципы написания кода
 
 ### DRY (Don't Repeat Yourself)
+
 ### KISS (Keep It Simple, Stupid)
+
 ### YAGNI (You Aren't Gonna Need It)
+
 ### Single Responsibility
 
 ### Не добавляй без задачи
@@ -202,4 +229,4 @@ import { Button } from "../Button";
 - Не добавляй обработку ошибок для сценариев, которые не могут произойти.
 - Не мигрируй legacy stories/tests на новый шаблон "по пути", если это не часть текущей задачи.
 
----
+---

package/bundle/guides/commits.md

@@ -2,22 +2,40 @@
 
 ---
 
+## Задачи и тикеты
+
+Задачи ведутся в Linear, команда `TRI` (https://linear.app/triplex-next).
+Номер задачи `TRI-XXX` — обязательный префикс веток и коммитов: по нему
+GitHub-интеграция Linear линкует PR и двигает статусы задачи
+(ветка → In Progress, PR → In Review, merge → Done).
+
+**Legacy:** исторические ветки и коммиты используют префикс `TRIPLEX-XXX`.
+Существующие не переименовываем; всё новое — только `TRI-XXX`.
+
+---
+
 ## Именование веток
 
-**Формат:** `TRIPLEX-XXX-короткое-описание`
+**Формат:** `TRI-XXX-короткое-описание`
 
 - Строчные буквы, слова через дефис.
-- Всегда начинается с номера тикета.
+- Всегда начинается с номера задачи Linear.
 
 ```text
-TRIPLEX-844-ai-ready-design-system
-TRIPLEX-901-add-badge-component
-TRIPLEX-912-fix-button-focus-style
+TRI-12-add-badge-component
+TRI-15-fix-button-focus-style
+TRI-21-alert-ai-ready
 ```
 
 **Исключения:**
-- Релизная ветка: `prepare-release-XX` (например, `prepare-release-2`)
-- Перелитие main → release-0: выполняется мейнтейнерами, формат произвольный
+- Релизная ветка: `prerelease-X.Y.Z` (например, `prerelease-1.40.0`) — в неё
+  собираются фиксы релиза и бамп версии, PR идёт в `main`
+- Перелитие main → release-0: выполняется без отдельной ветки, прямым мержем
+
+Исключение касается только **имени ветки**. Коммиты внутри неё подчиняются
+общему правилу `TRI-XXX`: на релиз заводится задача Linear, её номер идёт
+префиксом (`TRI-XXX Подготовка релиза 1.40.0`). Legacy-префикс `TRIPLEX-0`
+для новых релизов не используется.
 
 ---
 
@@ -28,29 +46,34 @@ TRIPLEX-912-fix-button-focus-style
 | `main` | React 18 | `1.xx` | Основная ветка разработки |
 | `release-0` | React 17 | `0.xx` | Поддержка React 17, синхронизируется с main |
 
-**Правило:** все фича-ветки создаются от `main`. Изменения попадают в `release-0` через перелитие — вручную мейнтейнерами. Агент не должен создавать ветки от `release-0` и не должен мерджить в неё напрямую.
+**Правило:** все фича-ветки создаются от `main`. Изменения попадают в `release-0` через перелитие. Агент не должен создавать ветки от `release-0` и не должен мерджить в неё напрямую.
+
+**Единственное исключение** — skill `release-react17` в рамках выпуска релиза:
+он мержит `main` в `release-0` и пушит напрямую, без PR. Там это компенсируется
+обязательными локальными гейтами (`tsc`, `test-unit`, `build`) и показом diff
+разработчику — `ci.yml` триггерится только на `pull_request` и прямой push
+не проверяет. Вне релиза перелитие остаётся за мейнтейнерами.
 
 ---
 
 ## Формат коммитов
 
-**Формат:** `TRIPLEX-XXX Краткое описание`
+**Формат:** `TRI-XXX Краткое описание`
 
 ```text
-TRIPLEX-844 Добавить AI-Ready документацию для компонентов
-TRIPLEX-901 Добавить компонент Badge с темами и размерами
-TRIPLEX-912 Исправить стиль фокуса для Button в теме Link
+TRI-12 Добавить компонент Badge с темами и размерами
+TRI-15 Исправить стиль фокуса для Button в теме Link
 ```
 
 Если нужно уточнение — добавляй через двоеточие:
 
 ```text
-TRIPLEX-844 AI-Ready Design System: фундамент и пилот Button
-TRIPLEX-901 Badge: добавить тему DANGER и размер SM
+TRI-12 Badge: добавить тему DANGER и размер SM
+TRI-21 Alert: AI refactoring + unit-тесты
 ```
 
 **Правила:**
-- Все коммиты в ветке начинаются с одного номера тикета.
+- Все коммиты в ветке начинаются с одного номера задачи.
 - Первая строка — не длиннее 72 символов.
 - Тело коммита опционально (для сложных изменений).
 - Язык: русский или английский — не смешивать в одном коммите.
@@ -86,7 +109,6 @@ npx prettier --write src/components/Button/Button.tsx
 | Файл/папка | Причина |
 |---|---|
 | `__screenshots__/` | Только из Docker/CI. Если нужно — подтвердить в pre-commit hook |
-| `.mcp.json` | Персональный токен Figma — в `.gitignore` |
 | `.env.local` | Секреты — в `.gitignore` |
 | `node_modules/`, `dist/`, `storybook-static/` | В `.gitignore` |
 
@@ -100,30 +122,101 @@ npx prettier --write src/components/Button/Button.tsx
 
 ## Когда коммитить и пушить
 
-**Агент не создаёт коммиты самостоятельно.** После завершения задачи — остановиться и показать результат разработчику. Коммит делается только по явной просьбе.
-
-**Агент не пушит ветку самостоятельно.** Пуш — только по явной просьбе разработчика.
+**Вне задачи Linear агент не создаёт коммиты и не пушит самостоятельно.**
+После завершения работы — остановиться и показать результат разработчику.
+Коммит и пуш — только по явной просьбе.
+
+**Исключение — работа по задаче Linear.** Если работа ведётся в ветке задачи
+`TRI-XXX-...` (взятой через skill `take-task`), агент после завершения работ
+и зелёного ревью (`change-reviewer`) **без подтверждения**:
+
+1. делает коммит по конвенциям этого файла (skill `commit-component`);
+2. пушит ветку;
+3. создаёт PR (см. «PR-воркфлоу»);
+4. если менялись stories или визуал компонентов — обновляет baseline-скриншоты
+   через skill `update-visual-baselines` (CI-workflow «Update Visual
+   Snapshots» + чистка orphan-скриншотов);
+5. запускает skill `finish-task` — комментарий-резюме публикуется в задачу
+   без подтверждения, проверяется линковка PR;
+6. запускает агента `pr-reviewer` — независимое ревью PR «с чистого листа»
+   с комментариями в GitHub (только COMMENT, вердикт и мерж за человеком).
+
+Гейты остаются обязательными и в автоматическом режиме — при любом из них
+остановиться и спросить разработчика:
+
+- упавшие проверки (tsc / vitest / eslint);
+- изменение публичного поведения без записи в release notes;
+- блокеры от `change-reviewer`;
+- подозрительные/посторонние файлы в `git status`.
 
 ---
 
-## PR-воркфлоу
+## GitHub-операции от аккаунта бота
+
+Автоматические GitHub-операции (создание PR, комментарии в PR, запуск
+workflow, авторство коммитов автофинала) выполняются от отдельного
+machine-аккаунта, если у разработчика задан его токен:
+
+```bash
+# fine-grained PAT бота: contents:write, pull-requests:write, actions:write
+export TRIPLEX_BOT_GH_TOKEN=...   # в ~/.zshenv (не ~/.zshrc — агент работает
+                                  # в неинтерактивном shell), НЕ в репозитории
+```
+
+**Паттерн для агентов** — в начале Bash-вызова с командами `gh`:
+
+```bash
+if [ -n "$TRIPLEX_BOT_GH_TOKEN" ]; then export GH_TOKEN="$TRIPLEX_BOT_GH_TOKEN"; fi
+gh pr create ...   # выполнится от бота; без токена — от разработчика (fallback)
+```
 
-**Агент пушит ветку — разработчик создаёт PR.**
+**Авторство коммитов автофинала** (identity бота выводится из токена,
+дополнительные переменные не нужны):
 
 ```bash
-git push -u origin TRIPLEX-XXX-feature-name
+if [ -n "$TRIPLEX_BOT_GH_TOKEN" ]; then
+  BOT_LOGIN=$(GH_TOKEN="$TRIPLEX_BOT_GH_TOKEN" gh api user -q .login)
+  BOT_EMAIL=$(GH_TOKEN="$TRIPLEX_BOT_GH_TOKEN" gh api user -q '"\(.id)+\(.login)@users.noreply.github.com"')
+  git -c user.name="$BOT_LOGIN" -c user.email="$BOT_EMAIL" commit -m "..."
+else
+  git commit -m "..."
+fi
 ```
 
-После пуша разработчик сам открывает PR через GitHub UI или `gh pr create`.
+Правила:
+
+- Токен нигде не печатать, не логировать и не коммитить; в репозитории
+  он не хранится ни в каком виде.
+- `git push` остаётся по SSH разработчика — авторство коммита и аккаунт
+  пушащего могут различаться, это нормально.
+- Проверка «кто я» перед автофиналом: `gh api user -q .login`
+  (с учётом паттерна выше) — чтобы в отчёте было видно, от чьего имени
+  созданы PR/комментарии.
+- Действия в Linear выполняются от сессии разработчика — бот на них
+  не распространяется.
 
-**Исключение:** если разработчик явно просит агента создать PR, используй:
+---
+
+## PR-воркфлоу
+
+**Работа по задаче Linear:** после коммита агент сам пушит ветку и создаёт PR:
 
 ```bash
+git push -u origin TRI-XXX-feature-name
 gh pr create \
-  --title "TRIPLEX-XXX Краткое описание" \
+  --title "TRI-XXX Краткое описание" \
   --body "## Что сделано\n- ...\n\n## Как проверить\n- ..."
 ```
 
+После создания PR финал продолжается автоматически: skill
+`update-visual-baselines` (если менялись stories/визуал) и skill
+`finish-task` — комментарий-резюме в задаче Linear и проверка линковки PR
+(GitHub-интеграция Linear подхватит PR по `TRI-XXX` в имени ветки).
+
+**Вне задачи Linear:** агент пушит ветку и создаёт PR только по явной просьбе
+разработчика; по умолчанию PR открывает разработчик через GitHub UI или
+`gh pr create`.
+
 ---
 
 ## Release notes
@@ -163,4 +256,4 @@ stories/release-notes/v1/<текущая версия>.mdx
 - [ ] Нет случайно добавленных файлов (`git status`)
 - [ ] Для новых локальных/временных/генерируемых файлов проверено, не нужно ли добавить правило в `.gitignore`
 - [ ] Нет скриншотов из macOS в `__screenshots__/`
-- [ ] Release notes обновлены (если изменился публичный API компонента)
+- [ ] Release notes обновлены (если изменился публичный API **или наблюдаемое поведение** компонента — не только при breaking change)