From 0c5fb340885cdbc4cb737e9670a86c83ca22bc3e Mon Sep 17 00:00:00 2001
From: EmersonBraun <emersonfbraun@gmail.com>
Date: Sat, 3 Oct 2026 09:58:46 -0300
Subject: [PATCH] docs: align PR template with org DoD

---
 .doc-bridge/capabilities.json    |  2 +-
 .doc-bridge/index.json           | 22 +++++++++++-----------
 .github/PULL_REQUEST_TEMPLATE.md | 23 ++++++++++++++++++++++-
 3 files changed, 34 insertions(+), 13 deletions(-)

diff --git a/.doc-bridge/capabilities.json b/.doc-bridge/capabilities.json
index ed3045d..1bbaf8e 100644
--- a/.doc-bridge/capabilities.json
+++ b/.doc-bridge/capabilities.json
@@ -7,7 +7,7 @@
     "name": "AgentsKit Code Review",
     "root": "."
   },
-  "contentHash": "f474b0aef326aaa3e8e78c64ddc686b6a3917854b5dd96bfebfa683aae8d138b",
+  "contentHash": "cae34cd0c2523af9d610d82e720f9bf0af84533d8f6c70c68bf0e288e545326b",
   "artifacts": {
     "index": ".doc-bridge/index.json",
     "llmsTxt": "llms.txt"
diff --git a/.doc-bridge/index.json b/.doc-bridge/index.json
index d3e5575..c5dbc56 100644
--- a/.doc-bridge/index.json
+++ b/.doc-bridge/index.json
@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "contentHash": "f474b0aef326aaa3e8e78c64ddc686b6a3917854b5dd96bfebfa683aae8d138b",
+  "contentHash": "cae34cd0c2523af9d610d82e720f9bf0af84533d8f6c70c68bf0e288e545326b",
   "contentHashAlgo": "sha256-normalized-v1",
-  "generatedAt": "2026-10-03T01:38:03.468Z",
+  "generatedAt": "2026-10-03T12:56:04.914Z",
   "project": {
     "name": "AgentsKit Code Review",
     "root": "."
@@ -116,7 +116,7 @@
         "document",
         "unclassified"
       ],
-      "contentHash": "1e145a83ca6b2a3e7fbd79dc96552235f7f28d21eb8f076123ff01d34dd5df2c"
+      "contentHash": "28edc0d585b4dcff1a8b66e6cd0582e6ecc348af0e69944f8c30a3fb54334f65"
     },
     {
       "id": "document:AGENTS.md",
@@ -3086,7 +3086,7 @@
     }
   },
   "inputs": {
-    "hash": "a610b9557b557af52ad2f8cdb393284bfb802595e8bccbee4cb476b729cd7482",
+    "hash": "ca6bee4e926ed8d47b0b17faecf9aec176e61bea99e3fe2847409ef8dcdb3c5d",
     "fileCount": 192,
     "projectionVersion": 2
   },
@@ -3109,9 +3109,9 @@
   "projection": {
     "type": "retrieval-index",
     "schemaVersion": 1,
-    "contentHash": "033331b284505f580ec5942053c6aca8814dbf45cce54cd83235e4f739f08198",
+    "contentHash": "981693842628d21b4f1d8a4c356f79a5cffb7cc4b9fb3251d5c09e8f1debe88a",
     "contentHashAlgo": "sha256-normalized-v1",
-    "snapshotHash": "737d40210fef3c60f01f7190f71c2fdde66d1b9c2127c2a2ec75f805795ab89c",
+    "snapshotHash": "efcdfb109c4447083d50547959d2d8e6ee6122c783d7196eed350286c6dea4c2",
     "overlayHash": "f99666ff9119084dd25c2974ae64eb6935ec2aa785ff5ad478fb9d541f7a5e94",
     "configurationHash": "ced84278fbcb351ab6b18cbfbc1a8e974f7ec31dc52eba9e9fc6d9d842657143",
     "lexiconVersion": 1,
@@ -3143,8 +3143,8 @@
       ],
       "averageFieldLength": {
         "aliases": 2.884816753926702,
-        "body": 48.80628272251309,
-        "headings": 3.680628272251309,
+        "body": 49.29319371727749,
+        "headings": 3.6910994764397906,
         "path": 5.638743455497382,
         "summary": 3.712041884816754,
         "symbols": 13.492146596858639,
@@ -3613,11 +3613,11 @@
         ],
         "fields": {
           "title": "PULL_REQUEST_TEMPLATE.md",
-          "headings": "What changed Why Verification",
+          "headings": "What changed Why How Reuse Validation Definition of Done",
           "path": ".github/PULL_REQUEST_TEMPLATE.md",
           "symbols": "",
           "summary": "npm run check",
-          "body": "What changed <!-- Describe the user-visible behavior. -- Why <!-- Link the issue or explain the problem. -- Verification - [ ] npm run check - [ ] Public CLI or Action changes are documented - [ ] No secrets or private model output are included",
+          "body": "What changed <!-- Describe the user-visible behavior. -- Why <!-- Link the issue or explain the problem. -- How <!-- Summarize the implementation and relevant design choices. -- Reuse <!-- What existing package, module, library, or service did you consider or reuse? If none fit, why? -- Validation - [ ] npm run check - Acceptance criteria and their contract or edge-case tests: - The repository's documented lint, test, build, typecheck, and other required gates pass on this commit: - [ ] Public CLI or Action changes are documented - [ ] No secrets or private model output are included - [ ] Generated artifacts were regenerated with the official tools, when applicable Definition of Done - [ ] One package, or one isolated cross-cutting gate change, per PR. - [ ] Each acceptance criterion has a contract or edge-case test. - [ ] The repository's documented gates pass on this commit. - [ ] Measure size when a bundle or export changes; add or update JSDoc when a public API changes. - [ ] Required changeset and documentation updates are included. - [ ] No tests were disabled to pass checks. - [ ] Generated artifacts were regenerated with the official tools, when applicable.",
           "aliases": "document unclassified"
         },
         "graph": {
@@ -3628,7 +3628,7 @@
           "inbound": [],
           "outbound": []
         },
-        "contentHash": "1e145a83ca6b2a3e7fbd79dc96552235f7f28d21eb8f076123ff01d34dd5df2c",
+        "contentHash": "28edc0d585b4dcff1a8b66e6cd0582e6ecc348af0e69944f8c30a3fb54334f65",
         "provenance": "observed",
         "confidence": "observed"
       },
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 8952c32..5da5251 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -6,8 +6,29 @@
 
 <!-- Link the issue or explain the problem. -->
 
-## Verification
+## How
+
+<!-- Summarize the implementation and relevant design choices. -->
+
+## Reuse
+
+<!-- What existing package, module, library, or service did you consider or reuse? If none fit, why? -->
+
+## Validation
 
 - [ ] `npm run check`
+- Acceptance criteria and their contract or edge-case tests:
+- The repository's documented lint, test, build, typecheck, and other required gates pass on this commit:
 - [ ] Public CLI or Action changes are documented
 - [ ] No secrets or private model output are included
+- [ ] Generated artifacts were regenerated with the official tools, when applicable
+
+## Definition of Done
+
+- [ ] One package, or one isolated cross-cutting gate change, per PR.
+- [ ] Each acceptance criterion has a contract or edge-case test.
+- [ ] The repository's documented gates pass on this commit.
+- [ ] Measure size when a bundle or export changes; add or update JSDoc when a public API changes.
+- [ ] Required changeset and documentation updates are included.
+- [ ] No tests were disabled to pass checks.
+- [ ] Generated artifacts were regenerated with the official tools, when applicable.