Пресети воркерів і майстер створення

Створи production-рівня AI-воркера для свого проєкту за 30 секунд. 12 відшліфованих пресетів із розумними дефолтами + 3-кроковий майстер із попередженнями + живий preview.

TL;DR

Відкрий робочий простір → натисни + Add у pill-панелі
Обери картку пресету (наприклад "Market Analyst") — зазвичай найближчий збіг
За потреби підправ → Create
Воркер готовий із чистим role-промтом + релевантними скілами, приєднаними автоматично

Якщо жоден пресет не підходить — плитка From scratch створює порожнього воркера. Просунуті користувачі можуть скористатися Show advanced form → для повного контролю.

Що таке пресет

Пресет = попередньо налаштований шаблон воркера з підібраними дефолтами:

Label + іконка (можна змінити)
Модель (Sonnet / Opus / Haiku) — розумний дефолт для ролі
Інструменти (Read, Write, Bash тощо) — мінімальний набір для ролі
Max turns — розумна кількість на складність задачі
System prompt — експертиза, специфічна для ролі (TAM/SAM/SOM для аналітика, сюжетна арка для pitch-coach тощо)
Context skills — релевантні скіли приєднуються автоматично (наприклад market-analysis для Market Analyst)

Усі 12 пресетів — це універсальні шаблони: без посилань на бренди, без імен персонажів, без посилань на нашу внутрішню інфраструктуру. Створи аналітика — отримаєш Market Analyst для твого продукту, а не для Arc OS.

12 канонічних пресетів

Engineering / Core (6)

Пресет	Покриття
Consultant 💬	Read-only дослідження, консультування, архітектурні пропозиції
Developer 💻	Повний доступ до репозиторію, постачає код, запускає тести
UI/UX Designer 🎨	Макети, дизайн-токени, доступність, мокапи
Knowledge Archivist 📚	Куратор вікі, організація документації, база знань
Sentinel 🛡️	Аудити безпеки, multi-tenancy, керування секретами
Product Owner 🤖	Роадмап, скоупінг, рішення user-first, trade-off'и

Startup-операції (6 — додано в Phase 66)

Пресет	Покриття
Market Analyst 📊	TAM/SAM/SOM, SWOT, Porter's Five Forces, PEST
Growth Strategist 🚀	AARRR-воронка, ICP, канали, A/B-тестування, LTV/CAC
Fractional CFO 💰	Unit economics, runway, прогнози на 3 сценарії, ціноутворення
Pitch Coach 🎤	One-liner, сюжетна арка, правило 15-слайдового deck, підготовка до Q&A
Legal Advisor ⚖️	Вибір юрособи, угоди засновників, IP, GDPR/CCPA
Customer Researcher 🔍	Mom Test, hypothesis-driven, cohort retention

3-кроковий майстер

Крок 1 — Identity

Сітка з 12 карток пресетів + плитка "From scratch". Обери одну → переходиш до Кроку 2 з усім попередньо заповненим. Обраний пресет підсвічується role-специфічними кольоровими токенами (analyst = indigo, growth = clay, cfo = sage green…).

Поле Label редаговане — зміни його на щось специфічне для твого продукту (наприклад "Acme Market Analyst").

Крок 2 — Capabilities

3 групи налаштувань:

Модель:

Sonnet — збалансована, рекомендований дефолт (більшість випадків)
Opus — повільна + дорога, найкращий reasoning (аудити безпеки, складні рефактори)
Haiku — швидка + дешева, прості задачі (форматування, класифікація)

Інструменти (кнопки-перемикачі):

Read / Glob / Grep — інспекція файлів (read-only)
Write / Edit — модифікація файлів (інструменти запису)
Bash — shell-команди (виконання)
WebSearch / WebFetch — зовнішнє дослідження

Перемикач All вмикає всі інструменти одразу (для необмеженої ролі dev/exec).

Max turns — скільки циклів використання інструментів на відповідь. Дефолти розумні для ролі (chat=10, terminal=20).

Попередження

Майстер авто-визначає підозрілі комбінації:

⚠️ "Read-only role with write tool" — наприклад пресет consultant + позначений Write. Імовірно помилка конфігурації.
⚠️ "Worker has tools but cannot Read" — без інструмента Read більшість промтів провалиться.

Ти можеш їх проігнорувати (force pick) — попередження інформаційне, не блокувальне.

Крок 3 — Instructions

Текстове поле з system prompt (пресет авто-заповнений, редагований). Плюс Skills picker — мультивибір зі skills_global твого проєкту (40+ універсальних + специфічні для проєкту).

Блок живого preview показує, що воркер насправді побачить на першому повідомленні:

# 📊 Market Analyst
Model: claude-sonnet-4-5
Tools: Read, Glob, Grep, WebSearch, WebFetch
Skills: market-analysis

--- System Prompt ---
You are the Market Analyst of this project...

Натисни Create worker → пресет зберігається в workers_registry, і воркер з'являється в pill-панелі WorkerSelector.

Що відбувається за лаштунками

Коли воркер створений і ти з ним спілкуєшся:

PROMPT TO CLAUDE = 
  SYSTEM_PROTOCOL (15 baseline rules — same for all workers)
  + worker.system_prompt (preset-specific role)
  + CLAUDE.md (your project context)
  + Context-router skills (auto-matched by your message triggers)
  + USER MESSAGE

Baseline (правила workflow + якості) інжектується автоматично — твій пресет фокусується лише на експертизі, специфічній для ролі, без дублювання "P0>P1>P2", "Cite sources", "DoD includes docs" тощо.

Поглиблений огляд архітектури

Кастомізація пресету

"Я хочу pitch-coach, але з власним B2B-фокусом"

Крок 1 → обери Pitch Coach
Крок 3 → відредагуй system prompt → додай "Focus exclusively on B2B SaaS pitches (enterprise sales cycle)" після наявних core-директив
Додай скіли, якщо маєш знання, специфічні для проєкту

Кастомізований воркер зберігається у workers_registry.json ТВОГО проєкту — незалежно від канонічного пресету. Майбутні оновлення пресету не перезапишуть твою кастомізацію.

"Я хочу воркера, НЕ покритого жодним пресетом"

Натисни плитку From scratch (Крок 1):

Label/іконка порожні
Дефолт Sonnet
Дефолтні інструменти Read+Glob+Grep
Порожній system prompt

Заповни Крок 2 + Крок 3 вручну. Діють ті самі попередження майстра.

"Я хочу стару монолітну форму"

Натисни Show advanced form → у заголовку майстра. Відкриває застарілу форму з усіма полями одразу. Корисно, коли:

Масово створюєш пресети через JSON-подібний ввід
Налаштовуєш prompt_style: 'gsd' (не виведено в майстрі)
Задаєш масив focus_dirs (ще не в майстрі)

Редагування наявних воркерів

Pill-панель WorkerSelector → натисни іконку ⚙️ на воркері → відкриває модалку WorkerStudio з формою (не майстер — режим редагування завжди використовує повну форму). Усі поля редаговані, зміни зберігаються на Save.

Вбудовані воркери (builtin: true у реєстрі) НЕ можна видалити — можна лише перевизначити їхній конфіг.

Доступ через API

Для програмного створення воркерів:

# List presets
curl -H "Authorization: Bearer $TOKEN" \
     https://your-domain/api/crm/workers/presets

# Create worker in a project
curl -X POST -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"label":"My Worker","icon":"🤖","model":"claude-sonnet-4-5","tools":["Read"],"system_prompt":"..."}' \
     https://your-domain/api/crm/projects/myproject/workers

Повний довідник API

FAQ

Q: Чи можу я опублікувати свій кастомний пресет як глобальний шаблон?

A: Поки що ні. Кастомні пресети живуть у workers_registry.json твого проєкту. Роадмап: marketplace пресетів (#228 part 2 — окрема задача).

Q: Чи можуть пресети воркерів оновлюватися автоматично?

A: Ні — після збереження твій конфіг незалежний. Це навмисно (жодних несподіваних змін поведінки). Якщо хочеш найновіший пресет — видали + створи заново.

Q: Скільки воркерів я можу мати в проєкті?

A: Залежить від плану: Free=5, Starter=25, Starter Cloud=150. Білінг і плани.

Q: Іконка воркера — emoji чи власне зображення?

A: І те, і те. Emoji за замовчуванням. Через Show advanced form → Upload PNG/GIF/WebP — зображення зберігається як asset проєкту й рендериться в pill-панелі.