From ea74183e4fee9fea30edb011f2524fa38e7a26b9 Mon Sep 17 00:00:00 2001
From: Jwalin Shah <jwalinshah13@gmail.com>
Date: Tue, 5 May 2026 11:13:39 -0700
Subject: [PATCH] docs: add AI PR metadata template for validation and behavior
 parity (#1244)

Co-authored-by: Steven Enamakel <31011319+senamakel@users.noreply.github.com>
Co-authored-by: WOZCODE <contact@withwoz.com>
Co-authored-by: sanil-23 <sanil@vezures.xyz>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Cyrus Gray <144336577+graycyrus@users.noreply.github.com>
Co-authored-by: CodeGhost21 <164498022+CodeGhost21@users.noreply.github.com>
Co-authored-by: oxoxDev <164490987+oxoxDev@users.noreply.github.com>
Co-authored-by: Mega Mind <146339422+M3gA-Mind@users.noreply.github.com>
Co-authored-by: Gaurang Patel <ptelgm.yt@gmail.com>
Co-authored-by: unn-Known1 <unn-known1@users.noreply.github.com>
Co-authored-by: Steven Enamakel <enamakel@tinyhumans.ai>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Steven Enamakel <senamakel@users.noreply.github.com>
Co-authored-by: Steven Enamakel's Droid <enamakel.agent@tinyhumans.ai>
Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: senamakel-droid <281415773+senamakel-droid@users.noreply.github.com>
Co-authored-by: YellowSnnowmann <167776381+YellowSnnowmann@users.noreply.github.com>
Co-authored-by: Neil <neil@maha.xyz>
Co-authored-by: Neel Mistry <neelmistry@Neels-MacBook-Pro.local>
Co-authored-by: obchain <167975049+obchain@users.noreply.github.com>
Co-authored-by: Jwalin Shah <jshah1331@gmail.com>
---
 .github/PULL_REQUEST_TEMPLATE.md | 39 ++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index f2c1c4c86..9e47658da 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -43,3 +43,42 @@ A bare "#123" reference is just a link — it does NOT close the issue.
 
 - Closes:
 - Follow-up PR(s)/TODOs:
+
+---
+
+## AI Authored PR Metadata (required for Codex/Linear PRs)
+
+> Keep this section for AI-authored PRs. For human-only PRs, mark each field `N/A`.
+
+### Linear Issue
+- Key:
+- URL:
+
+### Commit & Branch
+- Branch:
+- Commit SHA:
+
+### Validation Run
+- [ ] `pnpm --filter openhuman-app format:check`
+- [ ] `pnpm typecheck`
+- [ ] Focused tests:
+- [ ] Rust fmt/check (if changed):
+- [ ] Tauri fmt/check (if changed):
+
+### Validation Blocked
+- `command:`
+- `error:`
+- `impact:`
+
+### Behavior Changes
+- Intended behavior change:
+- User-visible effect:
+
+### Parity Contract
+- Legacy behavior preserved:
+- Guard/fallback/dispatch parity checks:
+
+### Duplicate / Superseded PR Handling
+- Duplicate PR(s):
+- Canonical PR:
+- Resolution (closed/superseded/updated):