docs: add project context examples

Author: tranhoangpich

README.md

@@ -97,6 +97,14 @@ Run the CLI tool against your `.ipa` or `.app` path:
 voc --app path/to/YourApp.ipa
 ```
 
+Include a project file for deeper analysis:
+
+```bash
+voc --app path/to/YourApp.ipa --project path/to/YourProject.xcodeproj
+# or
+voc --app path/to/YourApp.ipa --project path/to/YourWorkspace.xcworkspace
+```
+
 Bootstrap an `AGENTS.md` file for AI agent workflows:
 
 ```bash

apps/backend/README.md

@@ -20,6 +20,17 @@ curl -X POST http://127.0.0.1:7070/api/v1/scan \
   -F "profile=full"
 ```
 
+Include project context (zip a `.xcodeproj` or `.xcworkspace`):
+
+```bash
+zip -r YourProject.zip YourProject.xcodeproj
+
+curl -X POST http://127.0.0.1:7070/api/v1/scan \
+  -F "bundle=@/path/to/YourApp.ipa" \
+  -F "project=@/path/to/YourProject.zip" \
+  -F "profile=full"
+```
+
 ## API
 
 `POST /api/v1/scan`