From 6591ce08fd2115f17e026f48caa42694fe1255b2 Mon Sep 17 00:00:00 2001
From: "will.anderson" <will.anderson@neurontechnologies.ai>
Date: Sun, 23 Aug 2026 06:07:19 -0500
Subject: [PATCH] parameter registry: scientific naming - genus.species, full
 definitions, no bare values

---
 docs/PARAMETER-REGISTRY.md  | 35 +++++++++++++++++++++++++++++++++++
 docs/architecture/README.md |  7 +++++++
 2 files changed, 42 insertions(+)
 create mode 100644 docs/PARAMETER-REGISTRY.md

diff --git a/docs/PARAMETER-REGISTRY.md b/docs/PARAMETER-REGISTRY.md
new file mode 100644
index 0000000000..647c32cecb
--- /dev/null
+++ b/docs/PARAMETER-REGISTRY.md
@@ -0,0 +1,35 @@
+# Parameter Registry — Naming Convention
+
+Scientific style: every parameter carries its genus (which system owns it)
+and its species (what it does). `genus.species` — like Homo sapiens, the
+name alone places the thing in the world.
+
+Rules:
+1. Software references ONLY the short name (`genus.species`).
+2. Every short name is registered with a full-sentence definition.
+3. No bare values anywhere in code — a number never appears without its name.
+4. Values live as registry rows (data), revisable, history logged per change.
+
+## Registered parameters
+
+### hebbian (activation learning)
+- `hebbian.warmth-per-use` — How much each use strengthens a memory toward +1.
+- `hebbian.cool-off` — Days ignored before warmth fades to half.
+
+### validity (truth-now)
+- `validity.fade` — How fast unasserted truth cools toward doubt.
+
+### groundedness (evidence)
+- `groundedness.staleness` — How old evidence gets before it stops counting fresh.
+
+### memory (time-sense)
+- `memory.recent-horizon` — What still counts as "recently," in days.
+
+### retrieval (attention during search)
+- `retrieval.opinion-volume` — How much louder judgment speaks than word-matching.
+- `retrieval.surface-line` — Lowest score worth showing to anyone.
+- `attention.spotlight` — How many things can be shown at once.
+
+### pulse (the float)
+- `pulse.float-size` — How much raw experience fits in the loop at once.
+- `pulse.forget-after` — How long raw experience lasts before evaporating.
diff --git a/docs/architecture/README.md b/docs/architecture/README.md
index ce266dcb63..5421b32d43 100644
--- a/docs/architecture/README.md
+++ b/docs/architecture/README.md
@@ -1090,3 +1090,10 @@ Never build a rung before standing on the previous one.
     not home. Zero is the tunnel: the narrow balance point you pass
     THROUGH while discerning what's real from what's not — suspended
     judgment mid-crossing — then you emerge on one side and live there.
+39. No scalar constants exist in this system. Every quantity that means
+    anything is a signed dimensional reading, contextual and fuzzy.
+    Even driver parameters — decay clocks, learning rates, thresholds —
+    are configuration DATA owned by their dimensions, revisable like
+    rules: never physical truths. A bare number floating outside a
+    dimension is an abstraction with no authority here. Right itself is
+    irrational: approximated to tolerance, never terminated.