From 4e2027930529fe3f095396e3c81a6bb310f7abe9 Mon Sep 17 00:00:00 2001 From: dotta Date: Wed, 8 Apr 2026 17:19:00 -0500 Subject: [PATCH] fix(skill): add scoped-wake fast path to skip full heartbeat on comment wakes When an agent is woken by a comment (Resume Delta or Wake Payload), the skill now explicitly instructs it to skip Steps 1-4 (identity, approvals, inbox, pick work) and go directly to checkout. This prevents agents from wastefully fetching their full assignment list and announcing "checking my paperclip tasks" when they already know exactly which issue to work on. Co-Authored-By: Paperclip --- skills/paperclip/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/skills/paperclip/SKILL.md b/skills/paperclip/SKILL.md index 82dd0c38..0148248b 100644 --- a/skills/paperclip/SKILL.md +++ b/skills/paperclip/SKILL.md @@ -27,6 +27,8 @@ Manual local CLI mode (outside heartbeat runs): use `paperclipai agent local-cli Follow these steps every time you wake up: +**Scoped-wake fast path.** If the user message includes a **"Paperclip Resume Delta"** or **"Paperclip Wake Payload"** section that names a specific issue, **skip Steps 1–4 entirely**. Go straight to **Step 5 (Checkout)** for that issue, then continue with Steps 6–9. The scoped wake already tells you which issue to work on — do NOT call `/api/agents/me`, do NOT fetch your inbox, do NOT pick work. Just checkout, read the wake context, do the work, and update. + **Step 1 — Identity.** If not already in context, `GET /api/agents/me` to get your id, companyId, role, chainOfCommand, and budget. **Step 2 — Approval follow-up (when triggered).** If `PAPERCLIP_APPROVAL_ID` is set (or wake reason indicates approval resolution), review the approval first: