diff --git a/skills/paperclip/SKILL.md b/skills/paperclip/SKILL.md index fb285095..9d32ac80 100644 --- a/skills/paperclip/SKILL.md +++ b/skills/paperclip/SKILL.md @@ -112,16 +112,17 @@ When posting issue comments, use concise markdown with: - a short status line - bullets for what changed / what is blocked -- links to related entities when available (`[Issue PAP-123](/issues/)`, `[Approval](/approvals/)`, `[Agent](/agents/)`) +- links to related entities when available -Prefer canonical UI links: +**Company-prefixed URLs (required):** All internal links MUST include the company prefix. Derive the prefix from any issue identifier you have (e.g., `PAP-315` → prefix is `PAP`). Use this prefix in all UI links: -- Issues: `/issues/` (for example `PAP-224`) -- Agents: `/agents/` (id fallback allowed) -- Projects: `/projects/` (id fallback allowed) -- Runs: `/agents//runs/` +- Issues: `//issues/` (e.g., `/PAP/issues/PAP-224`) +- Agents: `//agents/` (e.g., `/PAP/agents/claudecoder`) +- Projects: `//projects/` (id fallback allowed) +- Approvals: `//approvals/` +- Runs: `//agents//runs/` -Compatibility redirect behavior: UUID/id links such as `/issues/`, `/agents/`, `/projects/`, and `/agents//runs/` should resolve and redirect to canonical routes. +Do NOT use unprefixed paths like `/issues/PAP-123` or `/agents/cto` — always include the company prefix. Example: @@ -130,9 +131,9 @@ Example: Submitted CTO hire request and linked it for board review. -- Approval: [ca6ba09d](/approvals/ca6ba09d-b558-4a53-a552-e7ef87e54a1b) -- Pending agent: [CTO draft](/agents/cto) -- Source issue: [PC-142](/issues/PC-142) +- Approval: [ca6ba09d](/PAP/approvals/ca6ba09d-b558-4a53-a552-e7ef87e54a1b) +- Pending agent: [CTO draft](/PAP/agents/cto) +- Source issue: [PC-142](/PAP/issues/PC-142) ``` ## Planning (Required when planning requested) diff --git a/skills/paperclip/references/api-reference.md b/skills/paperclip/references/api-reference.md index 8d14d201..4dc3c414 100644 --- a/skills/paperclip/references/api-reference.md +++ b/skills/paperclip/references/api-reference.md @@ -216,11 +216,13 @@ Use markdown formatting and include links to related entities when they exist: ```md ## Update -- Approval: [APPROVAL_ID](/approvals/) -- Pending agent: [AGENT_NAME](/agents/) -- Source issue: [ISSUE_ID](/issues/) +- Approval: [APPROVAL_ID](//approvals/) +- Pending agent: [AGENT_NAME](//agents/) +- Source issue: [ISSUE_ID](//issues/) ``` +Where `` is the company prefix derived from the issue identifier (e.g., `PAP-123` → prefix is `PAP`). + **@-mentions:** Mention another agent by name using `@AgentName` to automatically wake them: ```