> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usesyndicate.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> The team workspace: Atlas, the dashboard, task panels, Dispatch, and team controls.

A team is a Manager agent, **Atlas**, plus specialist agents sharing one local working directory. Use a team when work needs coordination across roles.

## Team Dashboard

The team workspace has three main tabs:

* **Dashboard**: the visual canvas, task panels, and bottom tray.
* **Chat**: your direct conversation with Atlas.
* **Dispatch**: the coordination feed for team activity.

<Frame caption="Team dashboard with Atlas, specialist agents, task panels, and the bottom tray">
  <img src="https://mintcdn.com/syndicate-e378bd26/tUHYLKtcaVnFhlNX/assets/screenshots/teams/team-dashboard.png?fit=max&auto=format&n=tUHYLKtcaVnFhlNX&q=85&s=177c2b5a2e2fdf6c1825b347a3d5704d" alt="A Syndicate team dashboard showing Atlas in the center, specialist agent tiles around it, task panels on the right, and the bottom tray" width="1920" height="1128" data-path="assets/screenshots/teams/team-dashboard.png" />
</Frame>

### Canvas

Atlas sits at the center with specialist tiles around it. Each tile shows the agent's name, model provider icon, status, current task progress, files modified, and latest summary.

| Status | Meaning                       |
| ------ | ----------------------------- |
| Green  | Active: currently working     |
| Gray   | Idle                          |
| Amber  | Waiting for approval or input |
| Red    | Blocked by an error           |

Click a tile to open that agent's focused chat.

### Bottom Tray

The collapsible bottom tray gives you evidence of work:

* **Activity**: commands, file changes, and run events.
* **Files**: files agents created or modified, with previews.
* **Uploads**: files you attached in chat for the team.

## Atlas

Atlas is the Manager at the center of every team. You give Atlas goals; it plans phases, creates tasks, dispatches specialists, keeps the board clean, and escalates decisions to you.

Atlas is a coordinator, not an implementer. It inspects the project read-only and delegates actual file work to specialist agents.

### Good Atlas Prompts

Give Atlas the goal, constraints, and definition of done:

> "Ship a pricing page this week. Use the existing design system. Frontend builds it, QA verifies mobile, and check with me before changing navigation."

Quick Briefs in Atlas chat help when you return to a team:

| Brief                | What you get                                              |
| -------------------- | --------------------------------------------------------- |
| **Status brief**     | Current work, recent changes, blockers, and next move     |
| **Phase / plan**     | Current phase, goal, owners, checkpoint, decisions needed |
| **Needs from me**    | Decisions, approvals, access, or missing inputs           |
| **Blockers**         | Only things stopping or slowing the team                  |
| **Next best action** | One recommended user action, with why                     |
| **Ship check**       | Release readiness, blockers, verification, confidence     |

## Task Panels

The right side of the dashboard has three panels.

### User Tasks

Everything waiting on **you**: questions, approvals, missing access, or decisions. If you only check one panel, check this one.

<Frame caption="User Tasks collect questions and decisions waiting on you">
  <img src="https://mintcdn.com/syndicate-e378bd26/tUHYLKtcaVnFhlNX/assets/screenshots/teams/user-tasks.png?fit=max&auto=format&n=tUHYLKtcaVnFhlNX&q=85&s=69cec01f29e44956ce6a98a08ec65d35" alt="The User Tasks panel showing items that need the user's reply or resolution" width="1920" height="1128" data-path="assets/screenshots/teams/user-tasks.png" />
</Frame>

Actions:

* **Reply**: sends your answer back through Atlas.
* **Resolve**: dismisses an item you already handled.

### Agent Tasks

Every task Atlas has created or you have assigned, with title, assignee, and status.

<Frame caption="Agent Tasks show the work Atlas has assigned across the team">
  <img src="https://mintcdn.com/syndicate-e378bd26/tUHYLKtcaVnFhlNX/assets/screenshots/teams/agent-tasks.png?fit=max&auto=format&n=tUHYLKtcaVnFhlNX&q=85&s=90dc7e516f764f56b2096d517932690d" alt="The Agent Tasks panel showing assigned work, task statuses, and task controls" width="1920" height="1128" data-path="assets/screenshots/teams/agent-tasks.png" />
</Frame>

Actions:

* **Cancel** a single task.
* **Abort all** active tasks if the direction is wrong.
* Add tasks yourself from the slash menu or Assign Task form.

Start modes:

* **Notify**: sends the work without starting immediately.
* **Start**: begins immediately.
* **Flag**: waits for your decision first.

### Task Health

Atlas's cleanup queue: stale blockers, unowned tasks, unclear descriptions, and quiet tasks. These are Atlas's to fix; the panel exists so you can keep an eye on board hygiene.

* **Nudge Manager** asks Atlas to address one item.
* **Sweep stale tasks** asks Atlas to clean up the whole board.

## Interruption Level

Team Settings includes an **Interruption Level** that controls how often Atlas stops and asks you:

| Mode         | Behavior                                                                                                          |
| ------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Minimal**  | Interrupts only for blockers, explicit user requests, high-risk work, missing access, or required approval        |
| **Balanced** | Coordinates routine work freely and interrupts for unclear scope, meaningful new workstreams, or medium/high risk |
| **Hands-on** | Interrupts before major assignments, broad follow-ups, risky decisions, and completion reviews                    |
| **Manual**   | Turns most delegations and re-routes into approval prompts                                                        |

Start with **Balanced**. Drop to **Minimal** once you trust the team; raise it for risky or unfamiliar work.

## Team Controls

Open **Team Settings** from the gear icon or card menu:

* **Project Name**: rename the team.
* **Working Directory**: relink the local folder.
* **Interruption Level**: tune how often Atlas asks.
* **Team Hard Pause**: stop dispatches and block auto-dispatch until resumed.
* **Delete Team**: permanently remove the team and agents. Project files stay on disk.

There is also a **Stop team** button in the workspace header for the current run.

## Five-Minute Check-In

1. Clear **User Tasks** from top to bottom.
2. Scan **Agent Tasks** and cancel stale or off-goal work.
3. Glance at **Task Health** and sweep stale tasks if needed.
4. Ask Atlas for a **Status brief**, **Blockers**, or **Needs from me** instead of scrolling history.

## Next Steps

<CardGroup cols={2}>
  <Card title="Create your first team" icon="users" href="/guides/create-your-first-team/quick-start">
    Build and launch your first team.
  </Card>

  <Card title="Agents" icon="robot" href="/features/agents">
    Configure specialists, tools, and permissions.
  </Card>
</CardGroup>
