[groq] [QA][POLICY] Branch Protection + Mandatory Review Policy for All Repos (#918) (#995)

README.md

@@ -218,6 +218,36 @@ The browser-facing Nexus must be rebuilt deliberately through the migration back
 *One 3D repo. One migration path. No more ghost worlds.*
 # The Nexus Project
 
+## Branch Protection & Mandatory Review Policy
+
+All repositories must enforce these rules on the `main` branch:
+
+| Rule | Status | Rationale |
+|------|--------|-----------|
+| Require PR for merge | ✅ Enabled | Prevent direct pushes |
+| Required approvals | ✅ 1+ | Minimum review threshold |
+| Dismiss stale approvals | ✅ Enabled | Re-review after new commits |
+| Require CI to pass | ✅ Conditional | Only where CI exists |
+| Block force push | ✅ Enabled | Protect commit history |
+| Block branch deletion | ✅ Enabled | Prevent accidental deletion |
+
+### Default Reviewer Assignment
+
+All repositories must:
+- 🧠 Default reviewer: `@perplexity` (QA gate)
+- 🔐 Required reviewer: `@Timmy` for `hermes-agent/` only
+
+### Acceptance Criteria
+
+- [x] Enable branch protection on `hermes-agent` main  
+- [x] Enable branch protection on `the-nexus` main  
+- [x] Enable branch protection on `timmy-home` main  
+- [x] Enable branch protection on `timmy-config` main  
+- [x] Set `@perplexity` as default reviewer org-wide  
+- [x] Document policy in org README  
+
+> This policy replaces all previous ad-hoc workflows. Any exceptions require written approval from @Timmy and @perplexity.
+
 ## Branch Protection Policy
 
 We enforce the following rules on all main branches: