diff --git a/README.md b/README.md index a690e2a..254d426 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,31 @@ # ◈ The Nexus — Timmy's Sovereign Home -The Nexus is Timmy's canonical 3D/home-world repo. +## Branch Protection & Review Policy + +The following rules apply to all repositories in this organization: + +### Branch Protection Rules (Enabled on `main` branch) +- ✅ Require Pull Request for merge +- ✅ Require 1 approval +- ✅ Dismiss stale approvals on new commits +- ✅ Require CI to pass (where CI is configured) +- ✅ Block force pushes +- ✅ Block branch deletion + +### Default Reviewer +- @perplexity is automatically requested on all PRs +- @Timmy is required reviewer for hermes-agent + +### Enforcement Status +- ✅ hermes-agent: All protections enabled +- ✅ the-nexus: PR + 1 approval enforced +- ✅ timmy-home: PR + 1 approval enforced +- ✅ timmy-config: PR + 1 approval enforced + +> These protections are configured in Gitea's branch protection settings. CI enforcement is pending runner restoration (#915). + +## Current Truth +The Nexus is Timmy's canonical 3D repo. It is meant to become two things at once: - a local-first training ground for Timmy