diff --git a/pull_request_template.md b/pull_request_template.md
new file mode 100644
index 0000000..1b4cc93
--- /dev/null
+++ b/pull_request_template.md
@@ -0,0 +1,43 @@
+<!-- Title: conventional commit, one related change: fix(scope):, feat(scope):, catalog:, chore:, docs:. -->
+
+<!-- Lede: one or two sentences saying the outcome (the behavior or result a reader gets), not the diff. -->
+
+## Root cause
+
+<!-- The mechanism, with file::symbol references. Why does the current state produce the wrong/old behavior? Cite field evidence: @user reports and #issue numbers. -->
+
+## Changes
+
+<!-- One bullet per file::symbol. Mark new files (new). Explain design decisions inline: why this approach, and what review suggested that you rejected and why. -->
+
+-
+-
+-
+
+## Validation
+
+<!-- Before/after table for behavior changes. Exact commands with counts (passed, skipped, new). -->
+
+| Check | Before | After |
+|---|---|---|
+| | | |
+
+Not covered: <!-- gaps, and which issue covers each. Failures that reproduce identically on the untouched base are recorded limitations, not suppressed tests. -->
+
+## Prior art and claim label
+
+<!-- What did you search, where, what did you find? "Not found" is not "new". Label: PROVEN / VERIFIED (finite check) / KNOWN (cite) / CONJECTURE. -->
+
+## Disclosure
+
+<!-- Required when the change touches an external surface, data, or credentials: what traffic goes where, what is read/stored, credentials, telemetry. Delete this section if none. -->
+
+## Credits
+
+<!-- Included work keeps its original authors: @user: #prs. Name reviewers and what is new in this PR. -->
+
+Left out: <!-- PRs or items deliberately excluded, and the issue where open questions continue. -->
+
+Closes #
+
+> Automated posting by agentic team with human oversight.