1 files changed, 13 insertions, 0 deletions
diff --git a/README.md b/README.md
index 5240329..65c5920 100644
--- a/README.md
+++ b/README.md
@@ -248,6 +248,19 @@ The test disables automatic physical input/GPU attachment and cleans up its
 server. Set `YASL_XORG_MODULE_PATH` to a comma-separated module search path if
 the test drivers are outside Xorg's default directories.
 
+## Benchmarks
+
+YASL includes a dedicated performance microbenchmark target (`yasl-benchmark`) evaluating CPU efficiency, memory footprint, cache line pressure, and data structure operations across core hot paths (surface lookups, input queue expansions, ring buffer throughput, timer arm/disarm cycles, and multi-output refresh rate scans):
+
+```sh
+# Run via meson test runner
+meson test -C build --benchmark --verbose
+
+# Or invoke the executable directly
+ninja -C build tests/yasl-benchmark
+./build/tests/yasl-benchmark
+```
+
 ## Quick Example
 
 ```c