Presety workerów i kreator tworzenia

Postaw produkcyjnego workera AI dla swojego projektu w 30 sekund. 12 dopracowanych presetów ze smart defaults + 3-krokowy kreator z ostrzeżeniami + podgląd na żywo.

TL;DR

Otwórz Workspace → kliknij + Add w pill barze
Wybierz kartę presetu (np. „Market Analyst") — zwykle najbliższe dopasowanie
Dostosuj w razie potrzeby → Create
Worker gotowy z czystym promptem roli + automatycznie podpiętymi odpowiednimi skillami

Jeśli preset nie pasuje — kafelek From scratch tworzy pustego workera. Zaawansowani użytkownicy mogą użyć Show advanced form → dla pełnej kontroli.

Czym jest preset

Preset = wstępnie skonfigurowany szablon workera z dostrojonymi defaultami:

Etykieta + ikona (można zmienić)
Model (Sonnet / Opus / Haiku) — sensowny domyślny per rola
Narzędzia (Read, Write, Bash itd.) — minimalny zestaw dla roli
Max turns — rozsądny dla złożoności zadań
System prompt — ekspertyza specyficzna dla roli (TAM/SAM/SOM dla analityka, łuk narracyjny dla pitch-coacha itd.)
Skille kontekstowe — automatycznie podpięte odpowiednie skille (np. market-analysis dla Market Analyst)

Wszystkie 12 presetów to generyczne szablony: zero odniesień do marek, zero imion postaci, zero odwołań do naszej wewnętrznej infrastruktury. Spawnujesz analityka — dostajesz Market Analysta dla Twojego produktu, nie dla Arc OS.

12 kanonicznych presetów

Engineering / Core (6)

Preset	Zakres
Consultant 💬	Research tylko do odczytu, doradztwo, sugestie architektoniczne
Developer 💻	Pełny dostęp do repo, dostarcza kod, uruchamia testy
UI/UX Designer 🎨	Layouty, tokeny designu, dostępność, makiety
Knowledge Archivist 📚	Kurator wiki, organizacja dokumentacji, baza wiedzy
Sentinel 🛡️	Audyty bezpieczeństwa, multi-tenancy, zarządzanie sekretami
Product Owner 🤖	Roadmapa, scoping, decyzje user-first, trade-offy

Operacje startupowe (6 — dodane w Phase 66)

Preset	Zakres
Market Analyst 📊	TAM/SAM/SOM, SWOT, 5 sił Portera, PEST
Growth Strategist 🚀	Lejek AARRR, ICP, kanały, testy A/B, LTV/CAC
Fractional CFO 💰	Unit economics, runway, prognozy 3-scenariuszowe, pricing
Pitch Coach 🎤	One-liner, łuk narracyjny, reguła 15 slajdów, przygotowanie do Q&A
Legal Advisor ⚖️	Wybór formy prawnej, umowy founderów, IP, GDPR/CCPA
Customer Researcher 🔍	Mom Test, podejście oparte na hipotezach, retencja kohort

3-krokowy kreator

Krok 1 — Tożsamość

Siatka 12 kart presetów + kafelek „From scratch". Wybierasz jeden → przechodzisz do Kroku 2 ze wszystkim wstępnie wypełnionym. Wybrany preset jest oznaczony kolorami tokenów specyficznych dla roli (analyst = indygo, growth = clay, cfo = szałwiowa zieleń…).

Pole Label jest edytowalne — zmień na coś specyficznego dla swojego produktu (np. „Acme Market Analyst").

Krok 2 — Możliwości

3 grupy ustawień:

Model:

Sonnet — zbalansowany, zalecany domyślny (większość przypadków)
Opus — wolny + drogi, najlepsze rozumowanie (audyty bezpieczeństwa, złożone refaktory)
Haiku — szybki + tani, proste zadania (formatowanie, klasyfikacja)

Narzędzia (przyciski przełączane):

Read / Glob / Grep — inspekcja plików (tylko odczyt)
Write / Edit — modyfikacja plików (narzędzia zapisu)
Bash — komendy powłoki (wykonywanie)
WebSearch / WebFetch — research zewnętrzny

Przełącznik All włącza wszystkie narzędzia naraz (dla nieograniczonej roli dev/exec).

Max turns — ile cykli tool-use na jedną odpowiedź. Domyślne wartości sensowne per rola (chat=10, terminal=20).

Ostrzeżenia

Kreator automatycznie wykrywa podejrzane kombinacje:

⚠️ „Read-only role with write tool" — np. preset consultant + zaznaczone Write. Prawdopodobnie błędna konfiguracja.
⚠️ „Worker has tools but cannot Read" — bez narzędzia Read większość promptów zawiedzie.

Można zignorować (wymusić wybór) — ostrzeżenie jest informacyjne, nie blokuje.

Krok 3 — Instrukcje

Pole tekstowe z system promptem (auto-wypełnione z presetu, edytowalne). Plus wybór skilli — multi-select z skills_global Twojego projektu (40+ generycznych + specyficzne dla projektu).

Blok podglądu na żywo pokazuje, co worker faktycznie zobaczy przy pierwszej wiadomości:

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

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

Kliknij Create worker → preset zapisuje się w workers_registry, worker pojawia się w pill barze WorkerSelectora.

Co dzieje się za kulisami

Gdy worker jest spawnowany i piszesz z nim na czacie:

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 (reguły workflow + jakości) jest wstrzykiwany automatycznie — Twój preset skupia się wyłącznie na ekspertyzie specyficznej dla roli, bez duplikowania „P0>P1>P2", „Cite sources", „DoD includes docs" itp.

Architektura w szczegółach

Dostosowywanie presetu

„Chcę pitch-coacha, ale z własnym fokusem na B2B"

Krok 1 → wybierz Pitch Coach
Krok 3 → edytuj system prompt → dodaj "Focus exclusively on B2B SaaS pitches (enterprise sales cycle)" po istniejących głównych dyrektywach
Dodaj skille, jeśli masz wiedzę specyficzną dla projektu

Dostosowany worker jest zapisywany w workers_registry.json TWOJEGO projektu — niezależnie od kanonicznego presetu. Przyszłe aktualizacje presetów nie nadpiszą Twojej personalizacji.

„Chcę workera, którego nie pokrywa żaden preset"

Kliknij kafelek From scratch (Krok 1):

Etykieta/ikona puste
Sonnet domyślnie
Narzędzia Read+Glob+Grep domyślnie
Pusty system prompt

Wypełnij Krok 2 + Krok 3 ręcznie. Te same ostrzeżenia kreatora obowiązują.

„Chcę stary monolityczny formularz"

Kliknij Show advanced form → w nagłówku kreatora. Otwiera legacy formularz ze wszystkimi polami naraz. Przydatne, gdy:

Masowo tworzysz presety przez input w stylu JSON
Konfigurujesz prompt_style: 'gsd' (nie jest dostępny w kreatorze)
Ustawiasz tablicę focus_dirs (jeszcze nie w kreatorze)

Edycja istniejących workerów

Pill bar WorkerSelectora → kliknij ikonę ⚙️ na workerze → otwiera się modal WorkerStudio z formularzem (nie kreator — tryb edycji zawsze używa pełnego formularza). Wszystkie pola edytowalne, zmiany zapisywane po Save.

Wbudowanych workerów (builtin: true w rejestrze) NIE można usunąć — można jedynie nadpisać konfigurację.

Dostęp przez API

Do programistycznego tworzenia workerów:

# 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

Pełna dokumentacja API

FAQ

P: Czy mogę opublikować mój custom preset jako globalny szablon?

O: Na razie nie. Custom presety żyją w workers_registry.json Twojego projektu. Roadmapa: marketplace presetów (#228 część 2 — osobne zgłoszenie).

P: Czy presety workerów mogą aktualizować się automatycznie?

O: Nie — po zapisaniu Twoja konfiguracja jest niezależna. To celowe (żadnych niespodziewanych zmian zachowania). Jeśli chcesz najnowszy preset — usuń i utwórz ponownie.

P: Ilu workerów mogę mieć w projekcie?

O: Zależy od planu: Free=5, Starter=25, Starter Cloud=150. Płatności i plany.

P: Ikona workera — emoji czy własny obrazek?

O: Oba. Emoji domyślnie. Przez Show advanced form → Upload PNG/GIF/WebP — obrazek jest zapisywany jako asset projektu i renderowany w pill barze.