diff --git a/.github/workflows/netlify-deploy.yml b/.github/workflows/netlify-deploy.yml
index 580a4e2..ac0d66d 100644
--- a/.github/workflows/netlify-deploy.yml
+++ b/.github/workflows/netlify-deploy.yml
@@ -1,3 +1,7 @@
+# Production deployment workflow
+# Triggered on push to main or manual dispatch
+# Runs tests and lint before deploying to Netlify
+
 name: Production → Netlify
 on:
   push: