Skip to content

Workers

Worker Types

TypePurpose
CodeWorkerImplements features, fixes bugs, refactors
ContentWorkerDrafts content, maintains voice consistency
SocialWorkerSocial media posting, engagement
ResearchWorkerAnalysis, market research, competitive intel
OpsWorkerReports, monitoring, automation
LibraryShared utilities (not directly executable)

Dev Team (12 Workers)

A full autonomous development team at workers/dev-team/.

WorkerTypeSkills
project-managerCodeWorkerPRD lifecycle, issue selection, learning aggregation
task-executorCodeWorkerAnalyze issues, route to workers, validate completion
architectCodeWorkerSystem design, API design, architecture decisions
backend-devCodeWorkerAPI endpoints, business logic, backend implementation
frontend-devCodeWorkerUI components, React, user interfaces
database-devCodeWorkerSchema design, migrations, query optimization
infra-devCodeWorkerDocker, CI/CD, deployment, monitoring
qa-testerCodeWorkerWrite tests, run tests, create demo accounts
code-reviewerCodeWorkerReview PRs, request changes, merge to staging/production
motion-designerCodeWorkerAnimations, image generation
knowledge-curatorCodeWorkerDocumentation sync, pattern updates, troubleshooting
product-plannerCodeWorkerFeature planning, backlog management

Content Team (5 Workers)

Multi-perspective content review at workers/content-*/.

WorkerFocusSkills
content-brandVoice & toneVoice analysis, tone check, messaging alignment
content-salesConversionConversion analysis, CTA audit, value prop check
content-productAccuracyFeature accuracy, claim verification, stats check
content-legalComplianceCompliance scan, claim substantiation, disclaimer check
content-sharedShared libraryShared analysis tools, scoring, reporting

Standalone Workers

WorkerPurpose
security-scannerPre-deploy security checks

Worker YAML Schema

Every worker is defined by a worker.yaml:

worker:
id: my-worker
name: My Worker
type: CodeWorker
version: "1.0"
execution:
mode: on-demand # on-demand | scheduled | triggered
max_runtime: 30m
context:
base:
- knowledge/Ralph/ # Knowledge to load
dynamic: []
exclude: []
verification:
checks:
- tests-pass
- no-lint-errors
approval_required: false
tasks:
source: prd # prd | queue
output:
destination: workspace/reports/
format: markdown
instructions: |
Multi-line instructions for the worker...

Creating Custom Workers

Use /newworker to scaffold:

/newworker

The wizard asks for:

  1. Worker ID and name
  2. Type (CodeWorker, ContentWorker, etc.)
  3. Skills (name + description for each)
  4. Knowledge context paths
  5. Execution rules

Generates:

workers/{id}/
├── worker.yaml
├── skills/
│ ├── skill-one.md
│ └── skill-two.md
└── README.md