From 2a49caca032db4db73d1427ee6c816130c686e70 Mon Sep 17 00:00:00 2001
From: Virgil <virgil@lethean.io>
Date: Sun, 5 Apr 2026 01:12:06 +0000
Subject: [PATCH] docs(ax): add codex conventions

Clarify reload behaviour for immutable splitter wiring.

Co-Authored-By: Virgil <virgil@lethean.io>
---
 CODEX.md      | 14 ++++++++++++++
 state_impl.go |  2 ++
 2 files changed, 16 insertions(+)
 create mode 100644 CODEX.md

diff --git a/CODEX.md b/CODEX.md
new file mode 100644
index 0000000..ba4250a
--- /dev/null
+++ b/CODEX.md
@@ -0,0 +1,14 @@
+# CODEX.md
+
+This repository uses `CLAUDE.md` as the detailed source of truth for working conventions.
+This file exists so agent workflows that expect `CODEX.md` can resolve the repo rules directly.
+
+## Core Conventions
+
+- Read `docs/RFC.md` before changing behaviour.
+- Preserve existing user changes in the worktree.
+- Prefer `rg` for search and `apply_patch` for edits.
+- Keep names predictable and comments example-driven.
+- Run `go test ./...` and `go test -race ./...` before committing when practical.
+- Commit with a conventional message and include the required co-author line when requested by repo policy.
+
diff --git a/state_impl.go b/state_impl.go
index d0069a5..57a261f 100644
--- a/state_impl.go
+++ b/state_impl.go
@@ -341,6 +341,8 @@ func (p *Proxy) Reload(config *Config) {
 		p.config = config
 	} else {
 		preservedBind := append([]BindAddr(nil), p.config.Bind...)
+		// Splitter wiring is established at start-up, so reload only swaps the
+		// knobs that live subsystems can absorb without reconnecting listeners.
 		preservedMode := p.config.Mode
 		preservedConfigPath := p.config.configPath
 		*p.config = *config