diff --git a/README.md b/README.md
index 489ae2866..367110de2 100644
--- a/README.md
+++ b/README.md
@@ -85,10 +85,13 @@ ProFileTailors is a **production-grade platform** for creating, customizing, and
 ├── server/   # Backend: Spring Boot, Kotlin, PostgreSQL
 ├── shared/   # Kotlin shared libs
 ├── infra/    # Infra as code: Docker Compose, secrets, monitoring
-├── docs/     # Astro-powered docs site
+├── docs/     # Astro-powered docs site (symlink)
 ├── .agents/  # AI agent configs, skills & workflow guides
 ```
 
+> **Note:** The `docs/` directory is a symlink to `client/apps/docs/src/content/docs/`.
+> It is automatically created by running `make prepare-env`.
+
 ---
 
 ## 🧰 Tech Stack