diff --git a/README.md b/README.md
index 58b78bd..aa9a683 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,12 @@ make test-plugin
 | `exec` | Filter string + optional UCAN | Action result |
 | `query` | DID (optional) | DID document |
 
+## Database Schema
+
+The database schema is defined in `db/schema.sql`.
+
+![[.github/db-schema.png]]
+
 ## Project Structure
 
 ```