diff --git a/README.md b/README.md
index de5505c..5022bfc 100644
--- a/README.md
+++ b/README.md
@@ -70,6 +70,12 @@ taskmanagerapi/
    uvicorn main:app --reload
    ```
 
+## Troubleshooting
+
+If you encounter a "PydanticUserError: A non-annotated attribute was detected" error:
+- This is resolved by moving DB_DIR outside the Settings class in app/core/config.py
+- A validation script (start.py) is included to verify the app loads correctly
+
 ## API Documentation
 
 FastAPI automatically generates interactive API documentation at: