transformer

docs/README.md

@@ -0,0 +1,12 @@
+# Documentation Index
+
+This folder tracks project decisions, experiments, and evolving ideas.
+
+- `decisions.md`: design/architecture changes and rationales
+- `experiments.md`: experiment runs and results
+- `ideas.md`: future ideas and hypotheses
+
+Conventions:
+- Append new entries instead of overwriting old ones.
+- Record exact config file and key overrides when possible.
+- Keep metrics in the order: avg_ks / avg_jsd / avg_lag1_diff.