Онбординг команди: ToV у розробці фіч

Мета: правила чистого написання застосовуються одразу — на етапі макетів і MVP нових фіч, і при редизайні старих. Не «причісуємо копію після деплою», а пишемо чисто з першого рядка.

Джерело правди: ABITLY_BRAND_BOOK.md. Чекер: /brand-review. Генератор: /brand-voice. Always-on правила вже в memory Claude.

📦 Працюєш у зовнішньому тулі (Cursor, Lovable, v0, Claude Design, Figma Make, ChatGPT)? Скілів там немає — встав туди ABITLY_TOV_RULES.md, і інструмент пише нашим тоном сам. Куди саме вставляти — TOV-PORTABLE-README.md. Як користуватись скілами в Claude Code — TOV-SKILLS-GUIDE.md.

Принцип: ToV входить на 3 точки workflow

НОВА ФІЧА:        Ідея → Макет/MVP ──┐
                                      ├─→ [ToV застосовується ТУТ] → messages/*.ts → /brand-review → мердж
РЕДИЗАЙН СТАРОЇ:  Стара копія → /brand-review (аудит) → фікс → редизайн ─┘

ToV — не окремий крок наприкінці, а вбудований у три моменти:

Генерація копії (макет/MVP) — пишемо через /brand-voice або вручну за чек-картою, не «як вийде».
Перед мерджем — /brand-review на копії фічі (або на src/messages/**/uk.ts).
Старт редизайну — спершу /brand-review старої копії → бачимо борг → виправляємо разом із дизайном.

Хто що робить (по ролях)

PM / Лера

Тримає ABITLY_BRAND_BOOK.md як джерело правди; апрувить зміни правил.
У Release Card заповнює поле Copy/ToV статус (Не перевірено / Перевірено / Approved).
Чутлива чи масштабна копія (pop-up, банери, нові розділи) — фінальний апрув за нею.

Дизайнер (Вика / Ліза, Pencil)

Копію в макеті бере з /brand-voice, а не пише «рибу» латиницею чи з емодзі.
Чек перед передачею в dev: заголовки без крапок, без емодзі, CTA-дієслово, терміни за §8.
Якщо макет — редизайн: спершу дивиться звіт /brand-review по старій копії.

Dev / vibe-coder (Влад, Claude Design)

Копія в messages/{feature}/uk.ts — через /brand-review перед мерджем (правило в CLAUDE.md).
Claude Design генерує копію вже чисто: правила в memory спрацьовують at-source.
Не лишає в проді плейсхолдери («вапролд»), англіцизми (Pricing/Logout/trial), ALL-CAPS.

Чек-карта (роздрукувати / запінити) — 10 правил

Звертання — завжди «ти» (виняток лише дослівні цитати наказів).
Без емодзі (дефолт). Продукт/сайт/email — взагалі без них.
Заголовки без крапок у кінці.
CTA = дієслово + вигода («Дізнайся свої шанси», не «Розрахувати»).
Дієслова, не іменники; активний стан, не пасивний.
Речення 15-25 слів, читається на одному диханні. Абзац ≤5 рядків.
Без русизмів (невозможно→неможливо) і англіцизмів (юзер→користувач, unlimited→без обмежень, фіча→можливість) — словник §6.
Без AI-slop (двореченнєві штампи, «ведемо за руку», «ідеальний»).
Терміни єдині (§8): абітурієнт (підготовка/вибір) ≠ вступник (подав заяву); КП = конкурсна пропозиція.
Пояснюй абревіатури при першій появі (ТОТ, ВПО, ЗВО).

Тест перед збереженням: прочитай вголос. Звучить як жива людина, а не чат-бот? Хоч одне «ні» — переписати.

Рол-аут (як запустити в команді)

Крок	Що	Хто	Коли
1	30-хв кік-оф: пройтись по Brand Book + показати `/brand-voice` і `/brand-review` живцем (демо на admission-tot)	Лера + автор	тиждень 1
2	Запінити чек-карту (10 правил) у робочому чаті / Notion	Лера	тиждень 1
3	Поле «Copy/ToV статус» у кожній новій Release Card (вже в шаблоні)	PM	одразу
4	`/brand-review` як крок DoD копії перед мерджем (вже в CLAUDE.md)	Dev	одразу
5	При першому редизайні — прогнати `/brand-review` по старому `messages/*.ts`, скласти борг-лист	Dev/PM	за фактом
6	Раз на спринт — швидкий ToV-чек 1-2 живих сторінок, оновлювати §6 словник новими кейсами	Лера	щоспринту

Ритуали (щоб не забувалось)

Definition of Done фічі включає «копія пройшла /brand-review».
Новий член команди — перший день читає ABITLY_BRAND_BOOK.md + цю сторінку.
Словник §6 — живий: кожен новий спійманий англіцизм/русизм/slop одразу додаємо (через PM).
Редизайн = можливість почистити: не редизайнимо стару фічу, не вичистивши її копію.

Швидкі команди

Треба	Команда
Згенерувати копію голосом Abitly	`/brand-voice <ідея або чернетка>`
Перевірити готову копію / файл	`/brand-review <текст або шлях до messages/*.ts>`
Глибокий аудит набору сторінок	`/brand-review` по черзі або багатоагентний прогон

Деталі правил — ABITLY_BRAND_BOOK.md. Дослідницька база — marketing/brand/research/.