Presets de workers y asistente de creación

Lanza un worker de IA de nivel producción para tu proyecto en 30 segundos. 12 presets pulidos con defaults inteligentes + asistente de 3 pasos con advertencias + vista previa en vivo.

TL;DR

Abre el Workspace → haz clic en + Add en la pill bar
Elige una tarjeta de preset (p. ej. "Market Analyst") — normalmente la opción más cercana
Ajusta si hace falta → Create
Worker listo con un role-prompt limpio + skills relevantes auto-adjuntados

Si ningún preset encaja — la tarjeta From scratch crea un worker en blanco. Los usuarios avanzados pueden usar Show advanced form → para control total.

Qué es un preset

Un preset = plantilla de worker preconfigurada con defaults afinados:

Etiqueta + icono (se pueden cambiar)
Modelo (Sonnet / Opus / Haiku) — default sensato por rol
Tools (Read, Write, Bash, etc.) — conjunto mínimo para el rol
Max turns — razonable según la complejidad de la tarea
System prompt — experiencia específica del rol (TAM/SAM/SOM para el analyst, arco narrativo para el pitch-coach, etc.)
Context skills — skills relevantes auto-adjuntados (por ejemplo market-analysis para el Market Analyst)

Los 12 presets son plantillas genéricas: sin referencias de marca, sin nombres de personajes, sin alusiones a nuestra infraestructura interna. Lanzas un analyst — obtienes un Market Analyst para tu producto, no para Arc OS.

Los 12 presets canónicos

Ingeniería / Core (6)

Preset	Cobertura
Consultant 💬	Investigación de solo lectura, asesoría, sugerencias de arquitectura
Developer 💻	Acceso completo al repo, entrega código, ejecuta tests
UI/UX Designer 🎨	Layouts, design tokens, accesibilidad, mockups
Knowledge Archivist 📚	Curador de la wiki, organización de docs, base de conocimiento
Sentinel 🛡️	Auditorías de seguridad, multi-tenancy, gestión de secretos
Product Owner 🤖	Roadmap, alcance, decisiones centradas en el usuario, trade-offs

Operaciones de startup (6 — añadidos en Phase 66)

Preset	Cobertura
Market Analyst 📊	TAM/SAM/SOM, SWOT, las Cinco Fuerzas de Porter, PEST
Growth Strategist 🚀	Embudo AARRR, ICP, canales, pruebas A/B, LTV/CAC
Fractional CFO 💰	Unit economics, runway, previsiones a 3 escenarios, pricing
Pitch Coach 🎤	One-liner, arco narrativo, regla de las 15 diapositivas, preparación de Q&A
Legal Advisor ⚖️	Elección de entidad, acuerdos de fundadores, PI, GDPR/CCPA
Customer Researcher 🔍	Mom Test, enfoque por hipótesis, retención por cohortes

El asistente de 3 pasos

Paso 1 — Identidad

Cuadrícula de 12 tarjetas de preset + la tarjeta "From scratch". Eliges una → pasas al Paso 2 con todo prerrellenado. El preset elegido se indica con los colores de los tokens específicos del rol (analyst = índigo, growth = clay, cfo = verde salvia…).

El campo Label es editable — cámbialo por algo específico de tu producto (p. ej. "Acme Market Analyst").

Paso 2 — Capacidades

3 grupos de ajustes:

Modelo:

Sonnet — equilibrado, default recomendado (la mayoría de casos)
Opus — lento + caro, el mejor razonamiento (auditorías de seguridad, refactors complejos)
Haiku — rápido + barato, tareas simples (formateo, clasificación)

Tools (botones de activación):

Read / Glob / Grep — inspección de archivos (solo lectura)
Write / Edit — modificación de archivos (herramientas de escritura)
Bash — comandos de shell (ejecución)
WebSearch / WebFetch — investigación externa

El botón All activa todas las tools a la vez (para un rol dev/exec sin restricciones).

Max turns — cuántos ciclos de tool-use por respuesta. Defaults sensatos por rol (chat=10, terminal=20).

Advertencias

El asistente detecta automáticamente combinaciones sospechosas:

⚠️ "Read-only role with write tool" — por ejemplo el preset consultant + Write marcado. Probable error de configuración.
⚠️ "Worker has tools but cannot Read" — sin la tool Read, la mayoría de los prompts fallarán.

Puedes ignorarlas (selección forzada) — la advertencia es informativa, no bloqueante.

Paso 3 — Instrucciones

Campo de texto con el system prompt (auto-rellenado por el preset, editable). Más el selector de Skills — multi-selección de los skills_global de tu proyecto (40+ genéricos + específicos del proyecto).

El bloque de vista previa en vivo muestra lo que el worker verá realmente en el primer mensaje:

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

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

Haz clic en Create worker → el preset se guarda en workers_registry y el worker aparece en la pill bar del WorkerSelector.

Qué pasa entre bastidores

Cuando el worker está lanzado y chateas con él:

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

El baseline (reglas de workflow + calidad) se inyecta automáticamente — tu preset se centra solo en la experiencia específica del rol, sin duplicar "P0>P1>P2", "Cite sources", "DoD includes docs", etc.

Análisis de arquitectura en profundidad

Personalizar un preset

"Quiero el pitch-coach pero con mi propio enfoque en B2B"

Paso 1 → elige Pitch Coach
Paso 3 → edita el system prompt → añade "Focus exclusively on B2B SaaS pitches (enterprise sales cycle)" después de las directivas principales existentes
Añade skills si tienes conocimiento específico del proyecto

El worker personalizado se guarda en el workers_registry.json de TU proyecto — independiente del preset canónico. Las futuras actualizaciones del preset no sobrescribirán tu personalización.

"Quiero un worker que NO cubre ningún preset"

Haz clic en la tarjeta From scratch (Paso 1):

Label/icono vacíos
Sonnet por defecto
Tools Read+Glob+Grep por defecto
System prompt vacío

Rellena el Paso 2 + Paso 3 manualmente. Aplican las mismas advertencias del asistente.

"Quiero el antiguo formulario monolítico"

Haz clic en Show advanced form → en la cabecera del asistente. Abre el formulario legacy con todos los campos a la vez. Útil cuando:

Creas presets en bloque mediante entrada tipo JSON
Configuras prompt_style: 'gsd' (no expuesto en el asistente)
Estableces el array focus_dirs (aún no disponible en el asistente)

Editar workers existentes

Pill bar del WorkerSelector → haz clic en el icono ⚙️ del worker → abre el modal WorkerStudio con el formulario (no el asistente — el modo edición siempre usa el formulario completo). Todos los campos editables, los cambios se guardan con Save.

Los workers integrados (builtin: true en el registry) NO se pueden eliminar — solo sobrescribir su configuración.

Acceso por API

Para la creación 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

Referencia API completa

FAQ

P: ¿Puedo publicar mi preset personalizado como plantilla global?

R: De momento no. Los presets personalizados viven en el workers_registry.json de tu proyecto. Roadmap: marketplace de presets (#228 parte 2 — issue aparte).

P: ¿Pueden los presets de worker actualizarse automáticamente?

R: No — una vez guardada, tu configuración es independiente. Es intencional (sin cambios de comportamiento por sorpresa). Si quieres el preset más reciente — elimínalo y vuelve a crearlo.

P: ¿Cuántos workers puedo tener en un proyecto?

R: Depende del plan: Free=5, Starter=25, Starter Cloud=150. Facturación y planes.

P: El icono del worker — ¿emoji o imagen personalizada?

R: Ambos. Emoji por defecto. Mediante Show advanced form → sube un PNG/GIF/WebP — la imagen se guarda como asset del proyecto y se renderiza en la pill bar.