diff --git a/AGENTS.md b/AGENTS.md
index 02af070b0..12974b900 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -16,7 +16,7 @@ oh-my-opencode/
 │   ├── agents/               # 11 agents (Sisyphus, Hephaestus, Oracle, Librarian, Explore, Atlas, Prometheus, Metis, Momus, Multimodal-Looker, Sisyphus-Junior)
 │   ├── hooks/                # 52 lifecycle hooks across dedicated modules and standalone files
 │   ├── tools/                # 26 tools across 16 directories (includes Hashline edit with LINE#ID content hashing)
-│   ├── features/             # 19 feature modules (background-agent, skill-loader, tmux, MCP-OAuth, skill-mcp-manager, etc.)
+│   ├── features/             # 20 feature modules (background-agent, skill-loader, tmux, MCP-OAuth, skill-mcp-manager, team-mode, etc.)
 │   ├── shared/               # 170+ utility files (barrel-exported, logger → /tmp/oh-my-opencode.log)
 │   ├── config/               # Zod v4 schema system (32 files)
 │   ├── cli/                  # CLI: install, run, doctor, mcp-oauth (Commander.js)
@@ -74,6 +74,7 @@ pluginModule.server(input, options)
 | Debug provider errors | `src/hooks/runtime-fallback/` | Reactive error recovery (distinct from model-fallback) |
 | External notifications | `src/openclaw/` | Bidirectional Discord/Telegram/webhook integration |
 | Skill-embedded MCP | `src/features/skill-mcp-manager/` | Tier 3 MCPs (stdio + HTTP, per-session) |
+| Team mode | `src/features/team-mode/` | Parallel multi-agent coordination (OFF by default) |
 
 ## MULTI-LEVEL CONFIG
 
diff --git a/docs/guide/overview.md b/docs/guide/overview.md
index cf1bb783c..51be64726 100644
--- a/docs/guide/overview.md
+++ b/docs/guide/overview.md
@@ -275,6 +275,7 @@ Claude Code doesn't have this. It takes your prompt and runs. Oh My OpenAgent th
 - **[Installation Guide](./installation.md)** — Complete setup instructions, provider authentication, and troubleshooting
 - **[Orchestration Guide](./orchestration.md)** — Deep dive into agent collaboration, planning with Prometheus, and execution with Atlas
 - **[Agent-Model Matching Guide](./agent-model-matching.md)** — Which models work best for each agent and how to customize
+- **[Team Mode Guide](./team-mode.md)** — Parallel multi-agent coordination (OFF by default); 12 `team_*` tools, shared mailbox, shared task list, optional tmux layout
 - **[Configuration Reference](../reference/configuration.md)** — Full config options with examples
 - **[Features Reference](../reference/features.md)** — Complete feature documentation
 - **[Manifesto](../manifesto.md)** — Philosophy behind the project
diff --git a/docs/reference/features.md b/docs/reference/features.md
index ab5f3925c..6b60bf93c 100644
--- a/docs/reference/features.md
+++ b/docs/reference/features.md
@@ -94,6 +94,12 @@ When running inside tmux:
 
 Customize agent models, prompts, and permissions in `oh-my-opencode.jsonc`.
 
+### Team Mode (experimental, OFF by default)
+
+Parallel multi-agent coordination modeled after Claude Code's experimental Agent Teams. Enable via `team_mode.enabled: true`. Exposes 12 `team_*` tools for spawning a lead + up to 8 members, a shared deferred-ack mailbox, a shared task list with file-locked claims, optional per-member git worktrees, and an optional tmux layout that streams each member's session output into dedicated panes.
+
+See the **[Team Mode Guide](../guide/team-mode.md)** for configuration, team spec format, lifecycle, bounds, and storage layout.
+
 ## Category System
 
 A Category is an agent configuration preset optimized for specific domains. Instead of delegating everything to a single AI agent, it is far more efficient to invoke specialists tailored to the nature of the task.