Record Milestone 0 performance baseline

benchmarks/README.md

@@ -0,0 +1,29 @@
+# Benchmarks
+
+Milestone 0 records measurements before changing compiler, storage, rendering, or response
+contracts.
+
+Run the maintained smoke benchmark:
+
+```bash
+make benchmark-smoke
+```
+
+Run the 1,000-node generic baseline:
+
+```bash
+make benchmark
+```
+
+The benchmark creates canonical sources, derived state, changesets, rendered output, and caches
+only in a disposable temporary directory. It does not read another project, self-host DocForge, or
+mutate repository content.
+
+`milestone0-2026-07-29.json` is the clean-tree baseline captured from commit
+`fd4759096e90edb13a745621aae4872f23079357`. It uses compact sorted JSON for response sizes and
+`time.perf_counter_ns()` for durations. The file is data, not a performance threshold. Later work
+must explain fixture or environment changes before comparing results.
+
+The generic fixture exposes whole-source scaling. It does not replace the incremental adapter
+equivalence tests and does not claim to measure a portable graph renderer, because Milestone 0 has
+no portable graph-planning or graph-rendering contract.