# 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.

Tools:
- `example/diagnose_ks.py` for per-feature KS + CDF plots.