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

# Workspace Bundle

> Bundled multi-agent orchestration harness for OpenCode — one install, complete control

## Overview

A curated collection of 16 components that work together as a complete AI development harness. Installing `kdco/workspace` gives you specialist agents, planning tools, code review workflows, notifications, and worktree isolation.

## Quick Start

```bash theme={null}
# Install via profile for complete, isolated configuration
ocx profile add ws --source kit/ws --from https://ocx-kit.kdco.dev --global
ocx oc -p ws
```

Or install directly into a project:

```bash theme={null}
ocx add kdco/workspace --from https://registry.kdco.dev
```

See the [KDCO Workspace Guide](/docs/guides/kdco-workspace) for full installation and customization.

## Architecture

```
┌──────────────────────────────────────────────────────────────────┐
│                          ORCHESTRATORS                           │
│            ┌──────┐                    ┌───────┐                 │
│            │ plan │                    │ build │                 │
│            └──┬───┘                    └───┬───┘                 │
└───────────────┼────────────────────────────┼─────────────────────┘
                │                            │
        ┌───────┴───────┐            ┌───────┴───────┐
        ▼       ▼       ▼            ▼       ▼       ▼
┌──────────────────────────────────────────────────────────────────┐
│                           SPECIALISTS                            │
│  ┌─────────┐ ┌────────────┐ ┌───────┐ ┌────────┐ ┌──────────┐    │
│  │ explore │ │ researcher │ │ coder │ │ scribe │ │ reviewer │    │
│  └─────────┘ └────────────┘ └───────┘ └────────┘ └──────────┘    │
└──────────────────────────────────────────────────────────────────┘
```

| Role          | Agents                                                 |
| ------------- | ------------------------------------------------------ |
| Orchestrators | `plan`, `build`                                        |
| Specialists   | `explore`, `researcher`, `coder`, `scribe`, `reviewer` |

## Components

| Category | Component                                            | Description                                                                                                                         |
| -------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Plugin   | workspace-plugin                                     | Plan management, agent rule injection                                                                                               |
| Plugin   | [background-agents](/docs/integrations/background-agents) | Capability-based background lifecycle (`delegate` for read-only sub-agents, `task` for write-capable) with durable markdown outputs |
| Plugin   | [notify](/docs/integrations/notify)                       | OS notifications on completion                                                                                                      |
| Plugin   | [worktree](/docs/integrations/worktree)                   | Git worktree isolation                                                                                                              |
| Plugin   | @tarquinen/opencode-dcp                              | Differential context protocol                                                                                                       |
| Plugin   | @franlol/opencode-md-table-formatter                 | Markdown table formatting                                                                                                           |
| Skill    | plan-protocol                                        | Implementation planning guidelines                                                                                                  |
| Skill    | code-review                                          | Review methodology + severity classification                                                                                        |
| Skill    | code-philosophy                                      | Internal logic philosophy (5 Laws)                                                                                                  |
| Skill    | frontend-philosophy                                  | Visual/UI philosophy (5 Pillars)                                                                                                    |
| Agent    | researcher                                           | External research (MCP tools, read-only)                                                                                            |
| Agent    | coder                                                | Implementation (full file + bash)                                                                                                   |
| Agent    | scribe                                               | Documentation (write, no bash)                                                                                                      |
| Agent    | reviewer                                             | Code review (read-only + git)                                                                                                       |
| Command  | review                                               | `/review` slash command                                                                                                             |
| MCP      | context7, exa, gh\_grep                              | Library docs, web search, GitHub code search                                                                                        |

## Permissions

The bundle configures security boundaries:

| Scope      | Setting                                                |
| ---------- | ------------------------------------------------------ |
| Global     | `webfetch: deny` — no direct web fetching              |
| plan       | Read-only orchestrator, delegates via `task` tool      |
| build      | Read-only orchestrator, delegates via `task` tool      |
| explore    | Read-only specialist, filesystem + git inspection only |
| researcher | Read-only, MCP tools only (Context7, Exa, GitHub Grep) |
| coder      | Full file + bash access                                |
| scribe     | File write only, no bash                               |
| reviewer   | Read-only + git inspection                             |

## See Also

* [KDCO Workspace Guide](/docs/guides/kdco-workspace) — Step-by-step installation and customization.
* [Background Agents](/docs/integrations/background-agents) — Async delegation details.
* [Notify Plugin](/docs/integrations/notify) — Notification configuration.
* [Worktree Plugin](/docs/integrations/worktree) — Worktree configuration.
* [Profiles Overview](/docs/profiles/overview) — Profile concepts.