From e4876e19ea71dfbb45e931f3c95f655c4ab6d45f Mon Sep 17 00:00:00 2001
From: Alexander Whitestone <alexpaynex@gmail.com>
Date: Tue, 7 Apr 2026 03:04:20 -0400
Subject: [PATCH] feat: [QA][POLICY] Branch Protection + Mandatory Review
 Policy for All Repos (#918)

Refs #918
Agent: groq
---
 .gitea/codowners  | 12 ++++++++++++
 CONTRIBUTORING.md | 30 ++++++++++++++++++++++++++++++
 2 files changed, 42 insertions(+)
 create mode 100644 .gitea/codowners
 create mode 100644 CONTRIBUTORING.md

diff --git a/.gitea/codowners b/.gitea/codowners
new file mode 100644
index 0000000..39eaeae
--- /dev/null
+++ b/.gitea/codowners
@@ -0,0 +1,12 @@
+# Default reviewers for all PRs
+@perplexity
+
+# Repo-specific overrides
+hermes-agent/:
+  - @Timmy
+
+# File path patterns
+docs/:
+  - @Timmy
+nexus/:
+  - @perplexity
diff --git a/CONTRIBUTORING.md b/CONTRIBUTORING.md
new file mode 100644
index 0000000..6f6a625
--- /dev/null
+++ b/CONTRIBUTORING.md
@@ -0,0 +1,30 @@
+# Contribution & Review Policy
+
+## Branch Protection Rules
+
+All repositories must enforce these rules on the `main` branch:
+- ✅ Pull Request Required for Merge
+- ✅ Minimum 1 Approved Review
+- ✅ CI/CD Must Pass
+- ✅ Dismiss Stale Approvals
+- ✅ Block Force Pushes
+- ✅ Block Deletion
+
+## Review Requirements
+
+All pull requests must:
+1. Be reviewed by @perplexity (QA gate)
+2. Be reviewed by @Timmy for hermes-agent
+3. Get at least one additional reviewer based on code area
+
+## CI Requirements
+
+- hermes-agent: Must pass all CI checks
+- the-nexus: CI required once runner is restored
+- timmy-home & timmy-config: No CI enforcement
+
+## Enforcement
+
+These rules are enforced via Gitea branch protection settings. See your repo settings > Branches for details.
+
+For code-specific ownership, see .gitea/Codowners
-- 
2.43.0