From 688e31e21c018d2d2fa45b70e02d18c4588e61f8 Mon Sep 17 00:00:00 2001
From: Paranoa-dev <phantomcall217@gmail.com>
Date: Mon, 1 Jun 2026 16:23:28 +0000
Subject: [PATCH] feat: add CODEOWNERS for reviewer routing (#650)

---
 .github/CODEOWNERS    | 27 +++++++++++++++++++++++++++
 pr-description-650.md | 25 +++++++++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 .github/CODEOWNERS
 create mode 100644 pr-description-650.md

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 0000000..5ae71fa
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1,27 @@
+# CODEOWNERS — Reviewer routing for Checkmate-Escrow
+# Syntax: <pattern> <@owner-or-team>
+# GitHub automatically requests reviews from these owners when a PR touches the matched paths.
+# Replace placeholder handles with real GitHub usernames or team slugs (e.g. @StellarCheckMate/contracts).
+
+# Global fallback — catches anything not matched below
+*                               @StellarCheckMate/maintainers
+
+# Escrow smart contract
+/contracts/escrow/              @StellarCheckMate/contracts
+
+# Oracle smart contract
+/contracts/oracle/              @StellarCheckMate/contracts
+
+# Documentation
+/docs/                          @StellarCheckMate/docs
+
+# CI/CD and GitHub configuration
+/.github/                       @StellarCheckMate/maintainers
+
+# Scripts
+/scripts/                       @StellarCheckMate/maintainers
+
+# Root config and workspace files
+/Cargo.toml                     @StellarCheckMate/contracts
+/Cargo.lock                     @StellarCheckMate/contracts
+/environments.toml              @StellarCheckMate/maintainers
diff --git a/pr-description-650.md b/pr-description-650.md
new file mode 100644
index 0000000..b28a84f
--- /dev/null
+++ b/pr-description-650.md
@@ -0,0 +1,25 @@
+# Add CODEOWNERS for reviewer routing
+
+## Summary
+
+Adds `.github/CODEOWNERS` to route PR reviews automatically based on the changed paths.
+
+## Changes
+
+- **`.github/CODEOWNERS`** — new file mapping ownership areas:
+  - `contracts/escrow/` → `@StellarCheckMate/contracts`
+  - `contracts/oracle/` → `@StellarCheckMate/contracts`
+  - `docs/` → `@StellarCheckMate/docs`
+  - `scripts/` and `.github/` → `@StellarCheckMate/maintainers`
+  - Root config files (`Cargo.toml`, `environments.toml`) → appropriate teams
+  - Global fallback `*` → `@StellarCheckMate/maintainers`
+
+## Why
+
+With separate escrow, oracle, and docs areas, GitHub's CODEOWNERS file ensures the right reviewers are automatically requested on every PR, speeding up outside contributions without requiring manual triage.
+
+## Testing
+
+No code changes — reviewer routing is enforced by GitHub on PR open. Replace placeholder team slugs with real GitHub usernames or teams before merging.
+
+closes #650