Presets de Workers e Wizard de Criação

Crie um worker de IA de nível de produção para o seu projeto em 30 segundos. 12 presets refinados com defaults inteligentes + wizard de 3 passos com avisos + preview ao vivo.

TL;DR

Abra o Workspace → clique em + Add na pill bar
Escolha um card de preset (ex.: "Market Analyst") — geralmente o mais próximo do que você precisa
Ajuste se necessário → Create
Worker pronto com role-prompt limpo + skills relevantes anexadas automaticamente

Se nenhum preset servir — o tile From scratch cria um worker em branco. Usuários avançados podem usar Show advanced form → para controle total.

O que é um preset

Um preset = template de worker pré-configurado com defaults ajustados:

Label + ícone (podem ser alterados)
Modelo (Sonnet / Opus / Haiku) — default sensato por papel
Tools (Read, Write, Bash etc.) — conjunto mínimo para o papel
Max turns — razoável conforme a complexidade da tarefa
System prompt — expertise específica do papel (TAM/SAM/SOM para analyst, story arc para pitch-coach etc.)
Skills de contexto — skills relevantes anexadas automaticamente (por exemplo market-analysis para o Market Analyst)

Todos os 12 presets são templates genéricos: sem referências de marca, sem nomes de personagens, sem menções à nossa infraestrutura interna. Ao criar um analyst, você recebe um Market Analyst para o seu produto, não para o Arc OS.

Os 12 presets canônicos

Engenharia / Core (6)

Preset	Cobertura
Consultant 💬	Pesquisa somente leitura, consultoria, sugestões de arquitetura
Developer 💻	Acesso total ao repositório, entrega código, executa testes
UI/UX Designer 🎨	Layouts, design tokens, acessibilidade, mockups
Knowledge Archivist 📚	Curadoria da wiki, organização de docs, base de conhecimento
Sentinel 🛡️	Auditorias de segurança, multi-tenancy, gestão de segredos
Product Owner 🤖	Roadmap, escopo, decisões centradas no usuário, trade-offs

Operações de startup (6 — adicionados na Phase 66)

Preset	Cobertura
Market Analyst 📊	TAM/SAM/SOM, SWOT, Cinco Forças de Porter, PEST
Growth Strategist 🚀	Funil AARRR, ICP, canais, testes A/B, LTV/CAC
Fractional CFO 💰	Unit economics, runway, projeções em 3 cenários, precificação
Pitch Coach 🎤	One-liner, story arc, regra dos 15 slides, preparação de Q&A
Legal Advisor ⚖️	Escolha de entidade, acordos entre fundadores, PI, GDPR/CCPA
Customer Researcher 🔍	Mom Test, abordagem orientada a hipóteses, retenção por coorte

O wizard de 3 passos

Passo 1 — Identidade

Grade com 12 cards de presets + tile "From scratch". Escolha um → você avança para o Passo 2 com tudo pré-preenchido. O preset escolhido é indicado com cores de tokens específicas do papel (analyst = índigo, growth = clay, cfo = verde-sálvia…).

O campo Label é editável — mude para algo específico do seu produto (ex.: "Acme Market Analyst").

Passo 2 — Capacidades

3 grupos de configurações:

Modelo:

Sonnet — equilibrado, default recomendado (maioria dos casos)
Opus — lento + caro, melhor raciocínio (auditorias de segurança, refatorações complexas)
Haiku — rápido + barato, tarefas simples (formatação, classificação)

Tools (botões de alternância):

Read / Glob / Grep — inspeção de arquivos (somente leitura)
Write / Edit — modificação de arquivos (ferramentas de escrita)
Bash — comandos shell (execução)
WebSearch / WebFetch — pesquisa externa

O botão All ativa todas as tools de uma vez (para um papel dev/exec sem restrições).

Max turns — quantos ciclos de tool-use por resposta. Defaults sensatos por papel (chat=10, terminal=20).

Avisos

O wizard detecta automaticamente combinações suspeitas:

⚠️ "Read-only role with write tool" — por exemplo, preset consultant + Write marcado. Provavelmente uma configuração incorreta.
⚠️ "Worker has tools but cannot Read" — sem a tool Read, a maioria dos prompts vai falhar.

Você pode ignorar (forçar a escolha) — o aviso é informativo, não bloqueia.

Passo 3 — Instruções

Campo de texto com o system prompt (pré-preenchido pelo preset, editável). Mais um seletor de Skills — multi-seleção a partir das skills_global do seu projeto (40+ genéricas + específicas do projeto).

O bloco de preview ao vivo mostra o que o worker realmente verá na primeira mensagem:

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

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

Clique em Create worker → o preset é salvo no workers_registry e o worker aparece na pill bar do WorkerSelector.

O que acontece nos bastidores

Quando o worker é criado e você conversa com ele:

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

O baseline (regras de workflow + qualidade) é injetado automaticamente — seu preset foca apenas na expertise do papel, sem duplicar "P0>P1>P2", "Cite sources", "DoD includes docs" etc.

Aprofundamento na arquitetura

Personalizando um preset

"Quero o pitch-coach, mas com foco próprio em B2B"

Passo 1 → escolha Pitch Coach
Passo 3 → edite o system prompt → adicione "Focus exclusively on B2B SaaS pitches (enterprise sales cycle)" após as diretrizes principais existentes
Adicione skills se houver conhecimento específico do projeto

O worker personalizado é salvo no workers_registry.json do SEU projeto — independente do preset canônico. Atualizações futuras do preset não sobrescreverão sua personalização.

"Quero um worker NÃO coberto por nenhum preset"

Clique no tile From scratch (Passo 1):

Label/ícone vazios
Sonnet como default
Tools Read+Glob+Grep como default
System prompt vazio

Preencha os Passos 2 + 3 manualmente. Os mesmos avisos do wizard se aplicam.

"Quero o antigo formulário monolítico"

Clique em Show advanced form → no cabeçalho do wizard. Abre o formulário legado com todos os campos de uma vez. Útil quando:

Você está criando presets em massa via entrada estilo JSON
Configurando prompt_style: 'gsd' (não exposto no wizard)
Definindo o array focus_dirs (ainda não disponível no wizard)

Editando workers existentes

Pill bar do WorkerSelector → clique no ícone ⚙️ do worker → abre o modal WorkerStudio com o formulário (não o wizard — o modo de edição sempre usa o formulário completo). Todos os campos são editáveis; as alterações são salvas em Save.

Workers nativos (builtin: true no registry) NÃO podem ser excluídos — apenas a configuração pode ser sobrescrita.

Acesso via API

Para criação programática de workers:

# 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

Referência completa da API

FAQ

P: Posso publicar meu preset personalizado como template global?

R: Não por enquanto. Presets personalizados vivem no workers_registry.json do seu projeto. Roadmap: marketplace de presets (#228 parte 2 — issue separada).

P: Os presets de worker podem se atualizar automaticamente?

R: Não — uma vez salva, sua configuração é independente. Isso é intencional (sem mudanças de comportamento surpresa). Se quiser o preset mais recente — exclua e recrie.

P: Quantos workers posso ter em um projeto?

R: Depende do plano: Free=5, Starter=25, Starter Cloud=150. Billing e Planos.

P: O ícone do worker — emoji ou imagem personalizada?

R: Ambos. Emoji por padrão. Via Show advanced form → faça upload de PNG/GIF/WebP — a imagem é armazenada como asset do projeto e renderizada na pill bar.