# 📐 Гайд: как редактировать промпты в Content Studio

_Для всех, кто правит системные промпты агентов Beauty Sleep руками. Обновлено: 2026-07-10._

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

---

## 1. Чеклист: правишь ТЕКСТОВЫЙ промпт (стратег, копирайтер, фактчекер, критик, редактор)

Структура промпта (не ломай порядок):
- [ ] **Роль в первых 1–2 предложениях** — «Ты — копирайтер бренда X…». Даже одна фраза заметно смещает тон.
- [ ] **Секции в XML-тегах** (`<voice>`, `<rules>`, `<output_format>`, `<examples>`) — модель отделяет инструкции от данных. Имена тегов не переименовывай без нужды.
- [ ] **Длинные данные — наверх, задача — в конец.** Большие вводные (factbook, эталоны) — перед вопросом, не после: до +30% качества.
- [ ] **Формат вывода — явно и в конце**: структура, длина, JSON-схема. «Сам догадается» не работает.

Правила голоса:
- [ ] **Поведенчески, не прилагательными.** «Дружелюбный тон» — дефолт любой LLM, это не сигнал. Работает: «хук в первой строке», «абзацы 1–3 строки», «вы строчными».
- [ ] **Каждый запрет — с альтернативой и причиной.** Не «не пиши канцеляритом», а «живой глагол вместо отглагольного существительного: "улучшает", не "обеспечивает улучшение"». Правило с «почему» соблюдается лучше и обобщается на неперечисленные случаи.
- [ ] **Severity явно**: HARD (юридика, кампанийная CTA-механика, длина) отдельно от SOFT (стилистика). Не капси всё подряд — «CRITICAL: MUST» на каждом правиле вызывает пере-срабатывание и зажатый текст; капс — только для действительно недопустимого.
- [ ] **Приём «X, но не Y»** для границ тона: «с юмором, но без сарказма».
- [ ] **Нет противоречий и дублей.** Первый шаг дебага — искать конфликтующие правила, а не добавлять новые. Дубль в двух формулировках со временем расходится в противоречие.
- [ ] **Стиль промпта заражает вывод**: буллет-простыня в промпте → буллеты в посте. Хочешь прозу — пиши секцию прозой.

Примеры (few-shot):
- [ ] 3–5 эталонов, того же типа контента, разных по темам (иначе модель скопирует случайный паттерн — одинаковый зачин, длину).
- [ ] Каждый пример — в `<example>`, лучше парой «бриф → готовый пост».
- [ ] **Пример не должен нарушать правила промпта** — всё важное из примера должно быть названо и в правилах, иначе при конфликте поведение непредсказуемо.
- [ ] Из примеров модель тащит конкретику (даты, ресурс, кампанийные CTA-механики) — вычищай.

Golden rule: покажи промпт коллеге без контекста. Запутался он — запутается и модель.

---

## 2. Чеклист: правишь КАРТИНОЧНЫЙ промпт (арт-директор, промптер)

- [ ] **Порядок = вес**: субъект → действие → сцена → композиция → свет → палитра → стиль. Главное — в первые слова.
- [ ] **30–80 слов** (Soul до 100). Длиннее — размывает сигнал; keyword-спам хуже связных предложений.
- [ ] **Hex привязан к объекту** («flat #F8DEDE pastel background»), не висит в воздухе. В Recraft цвет надёжнее через API-параметры, в Nano Banana — дублируй описательным цветом.
- [ ] **Негативов нет** у Soul/Nano Banana/FLUX: всё «нет» — позитивно («empty street», не «no cars»). Исключение — обязательный хвост «No text, no logos, no watermarks. Vertical 4:5.»
- [ ] **Стиль-блок серии — дословно** в каждом промпте карусели, меняется только субъект. Это и есть консистентность.
- [ ] **Слова-триггеры глянца запрещены**: 8k, ultra-realistic, hyperrealistic, masterpiece, beautiful, perfect, cinematic-без-конкретики, golden hour. Вместо них — конкретная камера и оптика.
- [ ] **Анти-артефакты**: рамки плёнки → убрать «film»-лексику, добавить «fills the entire frame edge to edge»; каша из букв → не упоминать надписи вообще; «white background» → конкретный пастельный hex.
- [ ] **Фирстиль Beauty Sleep**: 4:5 вертикаль; пастель без чистого чёрного; свечения вместо теней; лицо расслабленное или не в кадре, без стоковых улыбок; типографика/плашки — этап дизайна, не генерации.

Итерации: **seed lock + одно слово за раз.** Зафиксируй seed, поменяй одно слово — разница на картинке = эффект именно этого слова. Артефакт упорный — меняй формулировку-триггер, а не наращивай запреты.

---

## 3. Редакторский гейт: когда правка становится правилом

- **Разовая правка ≠ правило.** Комментарий редактора живёт в user-ходе (`<current_draft>` + `<editor_feedback>` + «измени только то, чего касается комментарий, остальное сохрани дословно»). В системный промпт он не попадает.
- **Третий раз тот же комментарий — сигнал**: промотируй его в правило системного промпта (формат «Всегда/Никогда + пример до/после») или замени эталонный пример. Это работа дистиллятора; пока он неактивен — руками, с провенансом (какой пост, чей комментарий, дата).
- **Не копи противоречивый фидбек** в контексте: актуальный черновик + актуальный комментарий, старые раунды сворачивай. При конфликте инструкций модель берёт ту, что ближе к концу, — результат превращается в лотерею.
- **Итераций критика — максимум 1–2.** Round 1 даёт основной прирост, round 3 обычно портит уже хороший текст (over-correction). Следи, не «чинит» ли критик то, что человек уже одобрил.
- **Правки человека — обучающий сигнал**: accept/reject по каждой правке критика пишется в лог; часто отклоняемый тип правки — повод ослабить или убрать правило.

---

## 4. Процедура изменения промпта (каждый раз)

1. Сформулируй, какое поведение чинишь, и найди 2–3 примера постов, где оно проявилось (это твой мини-golden-set).
2. Проверь, нет ли уже правила об этом — конфликт хуже отсутствия.
3. Измени **одну ось**: одно правило / один пример / одну формулировку.
4. Прогони те же входы до/после — сравни. Стало лучше на golden-set и не сломалось на остальном → оставляем.
5. Зафиксируй в git с комментарием «что и почему» — промпты бренда версионируются как код.
