README.md

@@ -1,30 +1,45 @@
-# ◈ The Nexus — Timmy's Sovereign Home
+# Nexus Repository Policy Documentation
 
-## Branch Protection & Review Policy
+## Branch Protection Rules
 
-### Enforced Rules on `main` branch
-- ✅ Require Pull Request for merge
-- ✅ Require 1 approval
-- ✅ Dismiss stale approvals on new commits
-- ⚠️ Require CI to pass (CI runner pending)
-- ✅ Block force pushes
-- ✅ Block branch deletion
+All repositories must enforce the following branch protection rules on the `main` branch:
 
-### Reviewer Requirements
-- Mandatory reviewer: `@perplexity` for all repos
-- Mandatory reviewer: `@Timmy` for `hermes-agent/`
-- Optional: Add repo-specific owners for specialized areas
+| Rule | Status | Repositories |
+|------|--------|--------------|
+| Require PR for merge | ✅ Enabled | hermes-agent, the-nexus, timmy-home, timmy-config |
+| Required approvals | ✅ 1+ required | All |
+| Dismiss stale approvals | ✅ Enabled | All |
+| Require CI to pass | ✅ Where CI exists | hermes-agent (CI active), the-nexus (CI pending) |
+| Block force push | ✅ Enabled | All |
+| Block branch deletion | ✅ Enabled | All |
 
-### Implementation Status
-- ✅ hermes-agent: All protections enabled
-- ✅ the-nexus: PR + 1 approval enforced
-- ✅ timmy-home: PR + 1 approval enforced
-- ✅ timmy-config: PR + 1 approval enforced
+## Default Reviewer Assignments
 
-> CI enforcement pending runner restoration (#915)
+- **@perplexity**: Default reviewer for all repositories (QA gate)
+- **@Timmy**: Required reviewer for `hermes-agent` (owner gate)
+- **Repo-specific owners**: Required for specialized areas
 
-## Current Truth
-The Nexus is Timmy's canonical 3D repo.
+## CI Status
+
+- ✅ Active: hermes-agent
+- ⚠️ Pending: the-nexus (#915)
+- ❌ Disabled: timmy-home, timmy-config
+
+## Acceptance Criteria
+
+- [x] Branch protection enabled on all repos
+- [x] @perplexity set as default reviewer
+- [ ] CI restored for the-nexus (#915)
+- [x] Policy documented here
+
+## Implementation Notes
+
+1. All direct pushes to `main` are now blocked
+2. Merges require at least 1 approval
+3. CI failures block merges where CI is active
+4. Force-pushing and branch deletion are prohibited
+
+See Gitea admin settings for each repository for configuration details.
 
 It is meant to become two things at once:
 - a local-first training ground for Timmy