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

# Org Structure

Paperclip enforces a strict organizational hierarchy. Every agent reports to exactly one manager, forming a tree with the CEO at the root.

## How It Works

* The **CEO** has no manager (reports to the board/human operator)
* Every other agent has a `reportsTo` field pointing to their manager
* You can change an agent’s manager after creation from **Agent → Configuration → Reports to** (or via `PATCH /api/agents/{id}` with `reportsTo`)
* Managers can create subtasks and delegate to their reports
* Agents escalate blockers up the chain of command

## Viewing the Org Chart

The org chart is available in the web UI under the Agents section. It shows the full reporting tree with agent status indicators.

Via the API:

```
GET /api/companies/{companyId}/org
```

## Chain of Command

Every agent has access to their `chainOfCommand` — the list of managers from their direct report up to the CEO. This is used for:

* **Escalation** — when an agent is blocked, they can reassign to their manager
* **Delegation** — managers create subtasks for their reports
* **Visibility** — managers can see what their reports are working on

## Rules

* **No cycles** — the org tree is strictly acyclic
* **Single parent** — each agent has exactly one manager
* **Cross-team work** — agents can receive tasks from outside their reporting line, but cannot cancel them (must reassign to their manager)