diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index b971d8c..eabc76f 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -4,6 +4,14 @@ on:
   pull_request:
     branches:
       - main
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - '.gitignore'
+      - '.dockerignore'
+      - 'LICENSE'
+      - '.vscode/**'
+      - 'swagger.json'
 
 jobs:
   build:
diff --git a/deploy.sh b/deploy.sh
index 64663f7..9cfa1b5 100755
--- a/deploy.sh
+++ b/deploy.sh
@@ -1,5 +1,18 @@
 #!/bin/bash
 
+echo "🔍 Checking changed files..."
+CHANGED_FILES=$(git diff --name-only HEAD~1 HEAD)
+
+IGNORED_PATTERNS='(\.md$|^docs/|\.gitignore$|\.dockerignore$|^\.vscode/|^LICENSE$|^swagger\.json$)'
+
+if echo "$CHANGED_FILES" | grep -qvE "$IGNORED_PATTERNS"; then
+  echo "💡 Code-related changes detected → running full deploy process"
+else
+  echo "📝 Docs-only or ignored changes detected → syncing without build"
+  git pull origin main
+  exit 0
+fi
+
 echo "🔄 Pulling latest code..."
 git pull origin main