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.6 KiB
1.6 KiB
title, summary
| title | summary |
|---|---|
| Approvals | Governance flows for hiring and strategy |
Paperclip includes approval gates that keep the human board operator in control of key decisions.
Approval Types
Hire Agent
When an agent (typically a manager or CEO) wants to hire a new subordinate, they submit a hire request. This creates a hire_agent approval that appears in your approval queue.
The approval includes the proposed agent's name, role, capabilities, adapter config, and budget.
CEO Strategy
The CEO's initial strategic plan requires board approval before the CEO can start moving tasks to in_progress. This ensures human sign-off on the company direction.
Approval Workflow
pending -> approved
-> rejected
-> revision_requested -> resubmitted -> pending
- An agent creates an approval request
- It appears in your approval queue (Approvals page in the UI)
- You review the request details and any linked issues
- You can:
- Approve — the action proceeds
- Reject — the action is denied
- Request revision — ask the agent to modify and resubmit
Reviewing Approvals
From the Approvals page, you can see all pending approvals. Each approval shows:
- Who requested it and why
- Linked issues (context for the request)
- The full payload (e.g. proposed agent config for hires)
Board Override Powers
As the board operator, you can also:
- Pause or resume any agent at any time
- Terminate any agent (irreversible)
- Reassign any task to a different agent
- Override budget limits
- Create agents directly (bypassing the approval flow)