1 files changed, 28 insertions, 0 deletions
diff --git a/scripts/README.md b/scripts/README.md
index 1fe2ad9..3124261 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -25,3 +25,31 @@ D=\texttt{rows}\times\texttt{cols}.
 
 Outputs are written under `outputs/static_alignment_beta/`, which is ignored by Git.
 
+## Capacity Scaling
+
+Run:
+
+```bash
+python scripts/capacity_scaling.py --plot
+```
+
+This computes:
+
+\[
+C_l(q)
+=
+-\log\Pr(Q_l\ge q)
+\]
+
+for equal-width feedback blocks with \(D=n^2\), then sums over the number of feedback-aligned layers:
+
+\[
+C_{\mathrm{all}}=\sum_l C_l(q_l).
+\]
+
+The default run compares two regimes:
+
+- `fixed`: \(q=0.01\), where \(C_{\mathrm{all}}\) grows like \(\Theta(Ln^2)\).
+- `chance`: \(q=1/D\), where \(C_{\mathrm{all}}\) grows mostly with \(L\).
+
+Outputs are written under `outputs/capacity_scaling/`.