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

Запусти production-grade AI-воркера для свого проєкту за 30 секунд. 12 відполірованих пресетів зі smart defaults + 3-кроковий майстер із попередженнями та live-прев'ю.

TL;DR

Відкрий Workspace → натисни + Add у pill bar
Вибери картку пресета (наприклад "Market Analyst") — зазвичай найближчий збіг
Підлаштуй за потреби → Create
Воркер готовий з чистим рольовим промптом + автоматично під'єднаними relevant skills

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

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

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

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

Усі 12 пресетів — generic-шаблони: жодних brand references, жодних імен персонажів, жодних посилань на нашу внутрішню інфраструктуру. Запускаєш analyst — отримуєш Market Analyst для твого продукту, не для Arc OS.

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

Engineering / Core (6)

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

Startup operations (6 — додано у Phase 66)

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

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

Крок 1 — Identity

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

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

Крок 2 — Capabilities

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

Модель:

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

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

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

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

Max turns — скільки tool-use циклів за одну відповідь. Defaults розумні для кожної ролі (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 — multi-select з skills_global твого проєкту (40+ generic + проєктно-специфічні).

Live-прев'ю блок показує, що воркер реально побачить на першому повідомленні:

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

--- System Prompt ---
Ти — Market Analyst цього проекту...

Натисни Create worker → пресет зберігається у workers_registry, воркер з'являється у pill bar 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" тощо.

Architecture deep-dive

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

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

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

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

"Хочу воркера, якого НЕ покриває жоден пресет"

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

Label/іконка порожні
Sonnet за замовчуванням
Інструменти Read+Glob+Grep за замовчуванням
Порожній system prompt

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

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

Натисни Show advanced form → у хедері майстра. Відкриється legacy-форма з усіма полями одразу. Корисно коли:

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

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

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

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

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

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

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

# Create worker у проекті
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

Full API reference

FAQ

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

A: Поки що ні. Custom-пресети живуть у workers_registry.json твого проєкту. Roadmap: preset marketplace (#228 part 2 — окрема issue).

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

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

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

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

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

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