fix: align linked-issue PR guidance

Keep commitperclip guidance in contributor-facing PR docs and bot copy instead of root AGENTS.md or bundled product skills.

Align the accepted examples with the current linked-issue checker, including Resolves and the inline-description field threshold.

Co-Authored-By: Paperclip <noreply@paperclip.ing>

.github/PULL_REQUEST_TEMPLATE.md

@@ -19,8 +19,10 @@
 <!--
   Required. Pick ONE of the following two paths:
 
-  (A) Issue exists — tag each linked issue with `Fixes: #123`, `Closes #123`,
-      or `Refs #123`. Include duplicates and closely related issues too.
+  (A) Issue exists — tag each linked issue with `Fixes #123`, `Closes #123`,
+      `Resolves #123`, or `Refs #123`. A bare `#123` also counts, but use an
+      explicit keyword when it describes the relationship. Include duplicates
+      and closely related issues too.
 
   Only reference PUBLIC GitHub issues/PRs here. Do NOT paste internal,
   instance-local Paperclip references — ticket ids like PAPA-123 / PAP-224,
@@ -28,8 +30,9 @@
   contributors cannot open them. See CONTRIBUTING.md → "No Internal Issue
   References".
 
-  (B) No issue exists — describe the underlying problem here, following the
-      relevant issue template so reviewers get the same fields:
+  (B) No issue exists — describe the underlying problem here with at least
+      three headings or labels from the relevant issue template so reviewers
+      get the same fields:
         • Bug:     .github/ISSUE_TEMPLATE/bug_report.yml
         • Feature: .github/ISSUE_TEMPLATE/feature_request.yml
         • Adapter: .github/ISSUE_TEMPLATE/adapter_request.yml
@@ -86,7 +89,7 @@
 - [ ] I have specified the model used (with version and capability details)
 - [ ] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work
 - [ ] I have searched GitHub for duplicate or related PRs and linked them above
-- [ ] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template
+- [ ] I have either (a) linked existing issues with `Fixes #` / `Closes #` / `Resolves #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template
 - [ ] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs)
 - [ ] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details
 - [ ] I have run tests locally and they pass

.github/scripts/check-pr-linked-issue.mjs

@@ -106,7 +106,7 @@ export function checkLinkedIssue(body, prTitle = '') {
     passed,
     failures: passed ? [] : [
       'No linked issue or inline issue description found — either tag an existing issue ' +
-      'with `Fixes #NNN` / `Closes #NNN` / `Refs #NNN`, or describe the underlying issue ' +
+      'with `Fixes #NNN` / `Closes #NNN` / `Resolves #NNN` / `Refs #NNN`, or describe the underlying issue ' +
       'inline in the PR body following one of our issue templates ' +
       '(https://github.com/paperclipai/paperclip/tree/master/.github/ISSUE_TEMPLATE). ' +
       'See CONTRIBUTING.md → "Link Issues or Describe Them In-PR".',

.github/scripts/tests/check-pr-linked-issue.test.mjs

@@ -52,6 +52,7 @@ test('fails with no issue reference when no skip prefix', () => {
   const result = checkLinkedIssue('Added a cool feature, no issue linked', 'feat: something');
   assert.equal(result.passed, false);
   assert.ok(result.failures[0].includes('Fixes #NNN'));
+  assert.ok(result.failures[0].includes('Resolves #NNN'));
 });
 
 test('fails with cross-repo issue reference', () => {