parameter registry: scientific naming - genus.species, full definitions, no bare values

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.