The default team
The first run gives you a team of four, so you can start work before writing a team package. Each agent has one job, a ceiling on what it may do, and one thing it cannot do.
| Agent | Its job | Mode | It cannot |
|---|---|---|---|
| Lucitra | Your point of contact. Does what you ask, and hands work to the right teammate | accept-edits | Merge a pull request |
| Planning Lead | Turns a goal into tasks small enough for one agent each | plan | Write any code itself |
| Builder | Builds one task in its own worktree and opens a pull request | accept-edits | Merge it |
| Reviewer | Reads the pull request and posts findings with a recommendation | plan | Approve it |
No agent on any team can merge. A person merges.
When a task finishes
On the default team, a finished task pushes its branch and opens its pull request on its own. To
have every push wait for you, run a team package whose policy lists push
under gated:; the default team has no policy file to hold that setting.
Change an agent
lucitra agents # the team, and what each agent is set to do
lucitra models # which model each agent runs, on which runtime
lucitra configure reviewer runtime codex # one setting on one agent
lucitra reset reviewer runtime # back to the default
Lucitra is the only agent you can rename. The others keep their names, so "the Reviewer approved this" means the same thing on every install.
Modes
| Mode | The agent may | It stops for |
|---|---|---|
plan | Read and analyze, and produce a plan | Everything. It never writes |
manual | Read | Every write and every command |
accept-edits | Read, write and commit inside its own worktree | Commands outside its allowlist, and anything beyond the repository |
auto | Work without asking; its tool policy still applies | Anything outside the repository |
bypass | Work with its tool policy off | Nothing. Merge is still out of reach |
A mode is a ceiling: a task can narrow an agent's mode, never widen it. Pushing at the end of a task is not a mode's decision. It follows the team's policy, as above. See Runtimes for how each runtime enforces the ceiling.