09d2ef1a37
- Restored docs/ directory that was accidentally deleted by `git add -A` in the v0.2.3 release script - Replaced generic "P" favicon with actual paperclip icon using brand primary color (#2563EB) - Added light/dark logo SVGs for Mintlify navbar (paperclip icon + wordmark) - Updated docs.json with logo configuration for dark/light mode - Fixed release.sh to stage only release-related files instead of `git add -A` to prevent sweeping unrelated changes into release commits Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.3 KiB
1.3 KiB
title, summary
| title | summary |
|---|---|
| Org Structure | Reporting hierarchy and chain of command |
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
reportsTofield pointing to their manager - 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)