papercliplisted
Install: claude install-skill heymegabyte/agent-skills
# Paperclip (`swarml.ink`) Operating & Governance Skill
Canonical operating instructions for interacting with the **Paperclip AI Control Plane** (`https://swarml.ink`, loopback `http://127.0.0.1:3100` on `ubuntu.megabyte.space`, Company ID `72408921-0094-4ffb-b4f4-f24db9026191`).
---
## 1. Use Sub-Tasks (`parent_id` / `parentId`) Whenever Appropriate
Whenever an issue represents an epic, multi-package initiative, cross-repository triad sync (`agent-skills` + `install.doctor` + `theme.tools`), or multi-stage workflow:
1. **Create Child Sub-Tasks (`parentId` / `parent_id`)**:
- Decompose the parent issue into focused child sub-tasks via `POST /api/companies/{companyId}/issues` with `"parentId": "{parentIssueId}"` (or `parent_id` in PostgreSQL).
- Assign each child sub-task to the best-fit specialist agent from the 29-agent paramilitary roster (`Full-Stack-Engineer`, `Backend-Engineer`, `Database-Engineer`, `DevSecOps`, `UI-Designer`, `QA-Verification`, `AppSec`, `A11y-Auditor`, `SEO-Auditor`, `Release-Manager`, etc.).
2. **Automatic Parent Wakeup**:
- When all direct child sub-tasks reach a terminal state (`done` / `cancelled`), Paperclip automatically fires `PAPERCLIP_WAKE_REASON=issue_children_completed` to wake the parent issue's assignee for final integration and closure.
---
## 2. Leverage "Parent", "Blocking", and "Blocked by" Relations Whenever Appropriate
Structure is expressed with **Parent** (`parent_id`), while execution ordering is enforced with **B