Lumen docsv1.0.2
← Site Download

Models & roles

Every crew member is a real model from a real provider, plus a role. The model decides how well the work gets done; the role decides what work it gets and who it talks to.

A model plus a role

When you add a crew member, you pick two things: the model (for example Gemini) and the role (for example Research). The role sets the member's mission, default permissions and its default connections to the rest of the crew.

Built-in roles

RoleWhat it doesUsual connections
ManagerPlans, assigns, reviews, asks you for approvalsDelegates to everyone, receives every report
EngineerWrites and changes codeTakes tasks from the manager, hands PRs to QA
QAWrites and runs tests, reproduces bugsTakes PRs from engineers, reports to the manager
ResearchReads docs, history, incidents and the webFeeds context to the manager
LocalizationTranslates copy and release notesTakes text from the manager, hands it to support
SupportAnswers users and collects feedbackFeeds user feedback back to the manager

You can also create custom roles with your own mission text. See Crews & the manager.

Which model for which role

Any model can take any role. These are the defaults we suggest after running many crews:

ModelStrong atSuggested role
ClaudePlanning, careful review, long instructionsManager
DeepSeekWriting code quickly and cheaplyEngineer
GPTBroad knowledge, tests, tool useQA
GeminiVery long context, documents, videoResearch
QwenMany languagesLocalization
MistralFast, concise answersSupport
Note

Model strengths change with every release. Treat this table as a starting point and swap models freely; the crew's connections stay the same.

Switching a model

Open a crew member and pick another model from the list. Its role, memory and connections stay; only the brain changes. This is handy for comparing two models on the same job.