diff --git a/.forgejo/workflows/validate-docs.yml b/.forgejo/workflows/validate-docs.yml
new file mode 100644
index 0000000..70a0107
--- /dev/null
+++ b/.forgejo/workflows/validate-docs.yml
@@ -0,0 +1,28 @@
+name: Validate Docs
+
+on:
+  push:
+    branches:
+      - '**'
+      - '!main'
+
+jobs:
+  validate-docs:
+    runs-on: docker
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build MkDocs site
+        run: |
+          docker run --rm \
+            -v "$PWD:/docs" \
+            squidfunk/mkdocs-material:9 \
+            build
+
+      - name: Validate expected output
+        run: |
+          test -f site/index.html
+          test -d site/architecture
+          echo "MkDocs validation passed"
\ No newline at end of file