01
Primary agents own the session; subagents handle focused work.
Build and Plan are the primary working modes. General, Explore, and Scout can be invoked as subagents when a task benefits from a narrower investigation.
| Agent | Best for |
|---|---|
| Build | Editing, running tools, and completing implementation |
| Plan | Understanding a project and designing a change before edits |
| Explore | Fast codebase search and dependency tracing |
| General / Scout | Delegated research and focused multi-step tasks |
02
Switch deliberately and invoke specialists inline.
- Use Tab to switch the primary agent in the terminal UI.
- Mention a subagent with @ when you want it to investigate a bounded part of the request.
- Describe the outcome and constraints; BrokenCode supplies the current project context.
03
Project agents can carry repeatable instructions.
Define agents in brokencode.json or as Markdown files under .brokencode/agents. User-wide definitions live under ~/.config/brokencode/agents.
.brokencode/agents/reviewer.md
---
description: Reviews changes for correctness and regressions
mode: subagent
---
Inspect the requested change, run focused checks, and report actionable findings.