diff --git a/docs/error-handling.md b/docs/error-handling.md
new file mode 100644
index 0000000..f6095c3
--- /dev/null
+++ b/docs/error-handling.md
@@ -0,0 +1,5 @@
+# Extraction error handling
+
+Applications using the SDK should distinguish request failures from extraction failures. A request failure means the source could not be reached or rejected the request; an extraction failure means a response was received but did not satisfy the requested shape.
+
+Callers should preserve the request identifier and provider response metadata while avoiding the storage of credentials or full private page contents in logs. Retry only transient transport failures, not validation errors caused by an invalid extraction instruction.