diff --git a/docs/trace_schema_evolution.md b/docs/trace_schema_evolution.md
new file mode 100644
index 0000000..9073655
--- /dev/null
+++ b/docs/trace_schema_evolution.md
@@ -0,0 +1,9 @@
+# Trace File Schema Evolution & Backward Compatibility Policy
+
+Specification for trace log schema versioning, migration scripts, and backward compatibility in the Soroban Debugger.
+
+---
+
+## References
+
+- Issue reference: Fixes #931