diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 000000000..012dd86a2
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,39 @@
+# docs/.gitignore - GitHub Pages Build Output Directory
+#
+# CRITICAL: This directory contains BUILD OUTPUT ONLY (except img/)
+#
+# - Build output is generated by CI (docusaurus build --out-dir ../docs)
+# - NEVER manually commit HTML/JS/CSS files from this directory
+# - Source documentation is in docusaurus/docs/ and docs-cms/
+#
+# What IS allowed (tracked in git):
+# - .nojekyll (required by GitHub Pages to bypass Jekyll processing)
+# - CNAME (custom domain configuration, if used)
+# - .gitattributes (git attributes for docs/, if needed)
+# - This .gitignore file itself
+# - img/ directory and all images (logos, icons, etc.)
+
+# Ignore HTML pages (all generated)
+*.html
+
+# Ignore generated search index and sitemap
+search-index.json
+sitemap.xml
+
+# Ignore generated directories (docusaurus output)
+/adr/
+/rfc/
+/memos/
+/user-guide/
+/search/
+/netflix/
+/prds/
+/docs/
+
+# Ignore generated JS/CSS in assets/
+/assets/css/
+/assets/js/
+
+# Allow img/ directory and all images
+!/img/
+!/img/**