# Teams

Teams are experimental and currently available only through the CLI. A team is a local definition that creates a house with a reusable set of bots and pinned threads.

## Install a team

Bundled teams live under `packages/teams/`. Install one by passing its `team.json`:

```sh
arbe team install packages/teams/mull/team.json --param title="Auth rewrite"
```

This creates the house, threads, and bots, then prints their IDs, URLs, and one-time bot API keys. Install-time parameters fill placeholders in the house name; for example, `"Mull: {{title}}"` becomes `"Mull: Auth rewrite"`. Pass `--json` for machine-readable output.

Installation is one-way and has no rollback. If it fails partway through, it leaves a partial house that you must clean up manually.

## Define a team

Keep a team in one folder with a `team.json`. Long prompts can live in adjacent Markdown files and be included with `{ "$ref": "./prompts/name.md" }`.

```json
{
  "schema_version": 1,
  "slug": "standup",
  "title": "Standup",
  "version": "0.1.0",
  "house": { "name_template": "Standup: {{team}}" },
  "params": [{ "key": "team", "label": "Which team?", "required": true }],
  "threads": [{ "name": "daily", "tags": ["standup"] }],
  "agents": [
    {
      "kind": "bot",
      "name": "facilitator",
      "trigger_mode": "mention",
      "system_prompt": { "$ref": "./prompts/facilitator.md" }
    }
  ]
}
```

- `params` supplies values when the team is installed. Version 1 substitutes them only into `house.name_template`.
- `threads` creates named, pinned threads. Tags are optional; the installer also adds the team slug.
- `agents` creates bots. Each needs a prompt and a trigger mode: `mention`, `ambient`, or `always`. The model is optional.

## Bundled teams

- `mull` — a staged path from clarification through research, design, and planning.
- `pingpong` — a small bot-to-bot dispatch test.
- `kanteen` — a fictional restaurant spread across three threads and mixed trigger modes.

## Current limits

Teams install from local paths only. There is no registry, remote install, uninstall, reinstall, or rollback. Teams can create bots but not human members.

Code: `@arbe/teams`, `@arbe/core/install-team`, `@arbe/core/schemas/team`.<br>
See [agents](agents.md) and the [CLI](../../cli.md).