diff --git a/docs/docker-compose.yml b/docs/docker-compose.yml
index 40b34fe..f764ac1 100644
--- a/docs/docker-compose.yml
+++ b/docs/docker-compose.yml
@@ -10,6 +10,11 @@
 # Prerequisite: `docker network create caddy` (one-time, shared with the
 # edge caddy-docker-proxy instance).
 
+# Explicit project name. Without this, Compose defaults to the parent
+# directory's basename — and all three docs sites live in `docs/`, so
+# they would collide and cross-recreate each other on every `up`.
+name: mcaxl-docs
+
 services:
   docs-dev:
     profiles: ["dev"]
diff --git a/pyproject.toml b/pyproject.toml
index eadb340..cc28080 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -72,6 +72,7 @@ exclude = [
   ".mcp.json",          # contains local filesystem path; dev-only artifact
   "axlsqltoolkit.zip",  # Cisco-licensed; do not redistribute
   "audits/",            # cluster-specific audit reports
+  "docs/",              # Astro docs site — node_modules, build artifacts, dev container scaffolding
   "tests/",             # tests live in source repo, not the sdist
   ".pytest_cache/",
   ".ruff_cache/",