From d950dee88029de2aa66d75aec7b019fe67fd3e00 Mon Sep 17 00:00:00 2001 From: Nicky Leach Date: Thu, 2 Jul 2026 18:44:10 +0000 Subject: [PATCH] docs: enforce real hire names in create-agent skill Co-Authored-By: Paperclip --- skills/paperclip-create-agent/SKILL.md | 4 ++-- .../references/draft-review-checklist.md | 1 + 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/skills/paperclip-create-agent/SKILL.md b/skills/paperclip-create-agent/SKILL.md index ee1be7e61a7..7c8aaf9610d 100644 --- a/skills/paperclip-create-agent/SKILL.md +++ b/skills/paperclip-create-agent/SKILL.md @@ -73,7 +73,7 @@ curl -sS "$PAPERCLIP_API_URL/llms/agent-icons.txt" \ ### 6. Draft the new hire config -- role / title / name +- `name` / `role` / `title` — **the `name` field MUST be a real human first + last name** (e.g. `Ada Whitfield`), never the role, function, or team. Put the function in `title` (e.g. "Chief Technology Officer") and the role enum in `role` (e.g. `cto`). Pick a name not already used by an existing teammate. - icon (required in practice; pick from `/llms/agent-icons.txt`) - reporting line (`reportsTo`) - adapter type @@ -100,7 +100,7 @@ curl -sS -X POST "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-h -H "Authorization: Bearer $PAPERCLIP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ - "name": "CTO", + "name": "Ada Whitfield", "role": "cto", "title": "Chief Technology Officer", "icon": "crown", diff --git a/skills/paperclip-create-agent/references/draft-review-checklist.md b/skills/paperclip-create-agent/references/draft-review-checklist.md index b1408513530..a05254c21fa 100644 --- a/skills/paperclip-create-agent/references/draft-review-checklist.md +++ b/skills/paperclip-create-agent/references/draft-review-checklist.md @@ -9,6 +9,7 @@ Use it for every path: exact template, adjacent template, or generic fallback. ## A. Identity and framing - [ ] `name`, `role`, and `title` are set and consistent with each other +- [ ] `name` is a real human first + last name (e.g. `Ada Whitfield`), not the role/function/team — the function lives in `title` and the enum in `role`; the chosen name is not already used by an existing teammate - [ ] `AGENTS.md` names the agent, the role, and the company in the first sentence - [ ] The first paragraph points at the Paperclip skill as the source of truth for the heartbeat procedure - [ ] The reporting line (`reportsTo`) resolves to a real in-company agent id