Your First Team
This guide walks through the executive template — the default team that ships with disclaw-team. It’s the fastest way to get a working multi-bot setup without writing any configuration by hand.
What the executive template includes
The executive template is a 4-bot team:
- Team Lead (orchestrator) — the entry point. Listens for tasks in the configured channel, delegates work to other bots via Discord @mentions, and synthesizes results.
- Researcher (specialist) — handles web search, reading, and analysis. Spawns subagents for deep research tasks.
- Validator (specialist) — reviews and validates work from other bots before delivery.
- Engineer (executor) — produces code, documents, and implementations based on research and direction.
The orchestrator delegates via Discord @mentions rather than spawning subagents directly. This keeps each bot as an independent Claude session with its own reasoning — genuine collaboration, not one mind wearing three masks.
Running init with the executive template
disclaw-team initWhen prompted for a template, select executive. The wizard pre-fills all role assignments — just supply your bot tokens (one per bot) and your server ID.
If you haven’t set up your bot tokens yet, see Discord Setup first.
Starting the team
disclaw-team startWhat to expect in Discord
Once the team is running:
-
Each bot comes online as a separate Discord user with its own name and avatar
-
Bots show a typing indicator while processing
-
The orchestrator listens for messages in the channel you configured during init
-
@mention the orchestrator to start a task:
@Orchestrator research the top 5 JavaScript frameworks and write a comparison
The orchestrator will @mention the Researcher, who will do the research and report back. The orchestrator then @mentions the Writer to produce the final output.
Two-phase first run
Attaching to a bot session
To inspect what a bot is doing or troubleshoot a stuck session:
disclaw-team attachThis drops you into the tmux session. Use Ctrl+B then a window number to switch between bots. Each window is one bot’s Claude Code session.