# Финам Дизайн-Машина

Конвейер, превращающий брифы заказчиков в брендированные артефакты Финам.
Единственный источник истины по бренду — `design-systems/finam/`; единственный
способ выпуска — сборка из шаблонов `templates/`.

## Language

### Роли

**Заказчик**:
Человек, который приносит бриф, принимает артефакт на приёмке и распоряжается публикацией.
_Avoid_: клиент, пользователь

**Оператор**:
Тот, кто собирает артефакт по правилам машины — AI-агент или человек.
_Avoid_: исполнитель, дизайнер

**Машина**:
Всё, что не зависит от конкретного задания: дизайн-система, шаблоны, скрипты, правила.

### Конвейер

**Бриф**:
Задание на артефакт, зафиксированное по форме `briefs/TEMPLATE.md`; вход машины и мера допуска.
_Avoid_: ТЗ, задание, спецификация

**Направление**:
Решение «какой шаблон», принятое по брифу; этап между брифом и сборкой.

**Каркас**:
Копия шаблона в `artifacts/<slug>/` с плейсхолдерами `{{…}}`; создаётся только `scripts/new-artifact.mjs`.
_Avoid_: заготовка

**Наполнение**:
Замена всех `{{PLACEHOLDER}}` каркаса контентом из брифа и дизайн-системы.

**Допуск**:
Два обязательных чеклиста — общий (токены, доступность, числа) и форматный (из `INSTRUCTIONS.md`); пропуск артефакта к приёмке.
_Avoid_: QA, проверка

**Приёмка**:
Решение заказчика по артефакту в статусе `review`: правки или `approved`.

**Публикация**:
Передача артефакта наружу (сайт, соцсети, печать); конечный статус `published`.

**Артефакт**:
Собранный вывод машины: папка `artifacts/<slug>/` с манифестом `artifact.json`.
_Avoid_: макет, страница, проект

**Статус**:
Положение артефакта в конвейере: `draft → review → approved → published`.

**Брак**:
Артефакт или решение, нарушившее закон машины (мимо дизайн-системы или мимо шаблона) либо не прошедшее допуск.
_Avoid_: баг, ошибка

### Вещество машины

**Дизайн-система**:
Бренд-пакет Финам в `design-systems/finam/`; единственный источник истины по цвету, шрифту, отступу и радиусу.
_Avoid_: брендбук, гайдлайн, UI-кит

**Токен**:
Именованная переменная `--fn-*` из `tokens.css`; единственная допустимая запись стилевого значения в артефакте.

**Шаблон**:
Формат вывода: `templates/<slug>/` с `SKILL.md` (правила формата) и каркасом (HTML/CSS/JS).
_Avoid_: пресет, тема

**Реестр иконок**:
`design-systems/finam/icons.html` — единственный источник иконок; в артефакт иконка попадает инлайн-копией сниппета.
_Avoid_: иконпак, спрайт

**Intake**:
Папка `design-systems/finam/source/intake/` и процедура из `source/INTAKE.md`: как к машине попадают внешние страницы (скриншоты, PDF, reader-сервис).

**Съём**:
Доставка живой страницы в машину тремя каналами: reader-сервис (текст и структура), статика CDN (точные CSS-значения), intake-папка (визуальные референсы).
_Avoid_: парсинг, скрейпинг

**Гэп-анализ**:
Сверка снятого лендинга с дизайн-системой по фиксированной рубрике — токены, структура, подача контента, движение; результат — отчёт-исследование в `source/` и тикеты эволюции через триаж.
_Avoid_: аудит, QA

**Пульт**:
`index.html` — панель обзора машины: конвейер, токены, шаблоны, артефакты.