summaryrefslogtreecommitdiff
path: root/scripts/README.md
diff options
context:
space:
mode:
authorYurenHao0426 <Blackhao0426@gmail.com>2026-06-09 21:35:51 -0500
committerYurenHao0426 <Blackhao0426@gmail.com>2026-06-09 21:35:51 -0500
commitf860ba2ffb409dc1b7dfab9534ed05cb25692269 (patch)
treed30029bb8bb754a7c3c5f44fd13869e4e4178b84 /scripts/README.md
parent84fa70be406248e660488ddc4c56ca5ea0034189 (diff)
Organize repo and add AAAI-27 writing plan
Root README orients the repo; notes/README reindexed by status (writing pipeline / authoritative note per result / six historical phases with superseded markers); scripts/README gains a status table. Note 40 = reproduction manifest (claim -> command -> outputs -> note; everything unlisted is not citable). Note 41 = the binding paper plan: AAAI-27 constraints (7pp + refs, appendix not guaranteed read), narrative, section/page budget, frozen theorem and figure numbering, related-work list with per-cite rationale, writing rules, weekly schedule to the 07-20/07-27 deadlines, and risk register. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Diffstat (limited to 'scripts/README.md')
-rw-r--r--scripts/README.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/scripts/README.md b/scripts/README.md
index af529a3..51dcbe3 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -1,5 +1,43 @@
# Scripts
+Status index (paper-grade commands live in `notes/40_reproduction_manifest.md`;
+the recipes further down this file cover the static-geometry scripts).
+
+**Core experiment scripts (paper-grade):**
+
+| script | what it validates | note |
+|---|---|---|
+| `capacity_empirical_validation.py` | Beta law, tails, multilayer product | 02 |
+| `multilayer_capacity_distribution.py` | surprisal Exp(1) / Gamma(L,1) | 02 |
+| `minimax_initialization.py`, `initialization_distribution_matching.py` | minimax 1/D + coverage per scheme | 02 |
+| `functional_capacity_overlap.py` | hard rank loss + kd/P overlap | 02 |
+| `downstream_capacity_sweep.py` | BP/FA sweep engine (dense ramp run, teacher run) + shared MLP/grad infra | 22, 39 |
+| `closed_form_soft_ramp.py` | closed-form gap law vs dense ramp (matched data/init + init band) | 34, 37 |
+| `actual_fa_initial_operator_moments.py` | T3: E_B[e0] = hidden speed share | 29 |
+| `actual_fa_initial_erosion_distribution.py` | P3: exact Gaussian e0 (real-backward sampler) | 32, 37 |
+| `compressed_operator_predictor.py` + `plot_compressed_operator_results.py` | early-velocity estimator, 256-traj set | 15 |
+| `summarize_operator_stress_grid.py` + `plot_operator_overlap_grid.py` | estimator stress grid | 16, 17 |
+| `finite_time_kernel_diagnostic.py` | oracle time-varying K(t) vs fixed K(0) | 13 |
+| `real_data_validation.py` | MNIST: T3 + estimator (has `--self-test`) | 38 |
+| `plot_teacher_test_gap.py` | teacher train-vs-test gap figure | 39 |
+
+**Diagnostics / negative results (kept for the record):**
+`fa_tangent_kernel_capacity.py` (kernel capacity probe, note 07),
+`early_kernel_predictors.py` (scalar predictors fail, note 14),
+`fa_tangent_hierarchy_derivative_probe.py` (derivative extrapolation blows
+up, note 31), `soft_erosion_theory_vs_empirical.py` (hard-k overpredicts,
+note 25), `static_alignment_beta.py` + `capacity_scaling.py` (small static
+demos subsumed by the large validation).
+
+**Historical (bridge/ensemble era, superseded):**
+`trajectory_mlp_fa.py`, `trajectory_ensemble.py`,
+`trajectory_gap_distribution.py` (notes 02/08),
+`plot_phase_transition*.py`, `plot_dense_phase_transition.py`,
+`plot_capacity_transition_overlay.py` (kink-era visualizations, notes 19-22),
+`plot_tangent_hierarchy_first_order_try.py` (note 31).
+
+---
+
## Static Alignment Beta Law
Run: