diff --git a/README.md b/README.md
index 40e9c89..9a46dcc 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,15 @@ graph LR
 ```
 <!-- topology:end -->
 
+## API
+
+### `run_tests(ctx)`
+**Syntax:** `M.run_tests(ctx)` -> void
+
+**Description:** Test-runner entrypoint. Executes 25 assertions against
+`lib-core.command`. Called automatically by the engine's
+`--test-libs=` orchestrator. Exits via `engine.exit(engine.test.failures())`.
+
 ## Coverage Statement
 
 Per Fault-Injection-Audit-Convention (2026-05-16):