# Для нейросетей

Правила бренда в виде, пригодном для передачи модели: весь свод одним файлом, машинный слепок и закрытый список того, чего модель делать не должна.

Модель получает те же правила, что человек, а не отдельный пересказ: файл со сводом собирается из этих же страниц при каждом обращении. Пересказ, написанный отдельно, разошёлся бы со сводом на первой правке, и дальше две версии правил жили бы параллельно.

> **Скачать.** Что передавать модели.
>
> - [Весь свод одним файлом, llms-full.txt](/llms-full.txt) — собирается порталом из этих же страниц при обращении; это и есть документ, который отдают целиком
> - [Машинный слепок, brand.json](/brand.json) — имя, наборы, пороги и состояние решений полями; пустое поле означает «решения нет»
> - [Оглавление, llms.txt](/llms.txt) — заголовок, краткая строка и адрес исходника каждой страницы

## Постоянные адреса

| Адрес | Что отдаёт |
|---|---|
| `/llms-full.txt` | весь свод одним файлом |
| `/brand.json` | машинный слепок бренда |
| `/llms.txt` | оглавление свода |
| `/raw/<адрес страницы>` | исходный текст одной страницы без оформления |
| `/ai` | страница движка: готовый запрос к справочнику и список адресов |

Адреса не меняются при перевыкладке портала. Записаны они от корня: полный адрес получается подстановкой адреса портала — того, по которому открыта эта страница.

## Готовый запрос

Скопируйте в чат с моделью и подставьте адрес портала вместо `<адрес портала>`.

**Запрос для чата с моделью**

```text
Ты готовишь материал в фирменном стиле gitaspen. Правила целиком лежат по адресу
<адрес портала>/llms-full.txt, машинный слепок — <адрес портала>/brand.json.
Прочитай оба до начала работы и отвечай по ним, а не по памяти.

Что обязательно:
1. Словознак пишется строчными: gitaspen, sknet. В предложении — GitAspen, SKNet.
2. Продукт подписывается принадлежностью: by gitaspen. Убирать приписку нельзя.
3. Словознак набирается Unbounded, текст и интерфейс — Onest. Четвёртого набора нет.
4. Контраст: 4.5 для обычного текста, 3 для крупного и для элементов интерфейса.
   Сомнение решается в пользу большего контраста.
5. Цвет не бывает единственным носителем смысла: рядом слово, значок или форма.

Чего делать нельзя:
1. Подставлять цвет: палитра не выбрана, ни одного значения не существует.
2. Рисовать знак: вектора нет, направление не выбрано. Персонажи с досок —
   ёж и куница — не утверждены оба.
3. Брать значения с картинок и рендеров: цвет, снятый с растра, — придуманный цвет.
4. Достраивать недостающее: пустое поле в brand.json означает «решения нет»,
   а не «подойдёт любое».
5. Выдавать пример из свода за утверждённое правило: примеры подписаны отдельно.
6. Ссылаться на «стиль gitaspen» там, где в своде написано «не заполнено».

Если для задачи нужно то, чего в правилах нет, — назови, чего именно не хватает,
и остановись. Незаполненное решает владелец бренда, а не исполнитель.

Задача:
```

## Что модель обязана соблюдать

Полный перечень решённого. Всё остальное в своде помечено как незаполненное.

1. **Написание имени.** `gitaspen` и `sknet` строчными в словознаке, GitAspen и SKNet в предложении. Закрытый список форм — в [названии](foundations/02-name.md).
2. **Подпись принадлежности.** Продукт идёт со словознаком и припиской `by gitaspen` за разделителем.
3. **Наборы.** Unbounded — словознак, Onest — интерфейс и текст, системный моноширинный — код; четвёртого набора нет. Резервные цепочки в это правило не входят: они не выбраны, см. [типографику](foundations/05-typography.md).
4. **Формулировки представления.** Две, обе приводятся дословно, без пересказа и перевода. Они в [обзоре](guides/01-overview.md).
5. **Пороги контраста.** 4.5 и 3, правило сомнения и запрет на цвет как единственный носитель смысла — в [доступности](foundations/01-accessibility.md).
6. **Архитектура семейства.** Платформа — мастер-бренд, продукт — своё имя и приписка; знаки продуктов родственны знаку платформы и не повторяют его.

## Чего в правилах нет

Это не пропуски в тексте, а отсутствие решений. Задача, которой нужен любой из пунктов, не выполняется до решения владельца:

- палитра: ни одного значения цвета; цвет словознака на тёмной поверхности;
- знак: направление не выбрано, вектора нет, охранного поля, наименьшего размера и списка допустимых фонов нет;
- персонаж: в проработках нарисованы двое — ёж и куница, — ни один не принят;
- визуальный язык: территория не выбрана, ни один приём не утверждён;
- типографика: начертания, иерархия размеров, резервные цепочки, официальный источник файлов гарнитур;
- голос бренда: формальность, форма обращения к читателю, слова, образцы сообщений;
- миссия, аудитория, характер;
- имя в технических обозначениях кода: области пакета, каталоги настройки, заголовки, ключи хранилища;
- материалы для прессы: врезка и её длины, факты, контакт, условия использования;
- правовая рамка: статус знака, правообладатель, условия для третьих лиц.

## Как читать пустое значение

В машинном слепке `null` и пустой список означают «решения нет». Это не «значение по умолчанию» и не «выберите сами»: раздел с пустым значением применять нельзя, его нужно запросить у владельца бренда.

В тексте страниц то же состояние записано словами «не заполнено» и рядом — что именно нужно решить.

> **Осторожно.** Ответ модели — не документ. Свод правится, а выданный однажды ответ остаётся прежним. Прежде чем применять правило из ответа, откройте страницу по названному адресу и сверьтесь с ней.

## Проверка результата

Что проверить в материале, сделанном по этим правилам:

1. **Написание имени.** Словознак строчными, имя в предложении — обычным написанием, приписка у продукта на месте.
2. **Наборы.** Словознак — Unbounded, остальное — Onest; посторонних наборов нет.
3. **Знак.** Знака в материале нет вовсе. Появившийся знак означает, что его кто-то нарисовал.
4. **Цвет.** Фирменного цвета в материале нет; использованные цвета названы как оформление материала, а не как палитра бренда.
5. **Контраст.** Каждая пара «текст на фоне» проходит порог; проверка — на странице [цвета](foundations/04-color.md).
6. **Формулировки.** Приведены дословно либо не приведены.

## Устаревшее и правовая рамка

Изъятых правил нет — см. [устаревшее](legacy.md). Условия использования третьей стороной не определены — см. [правовую рамку](legal.md).