what this is

README.md

@@ -5,11 +5,29 @@ HTML/CSS/JS, served exactly as committed.
 
 Live at **https://familyfed.bcgen.ie**.
 
+## Project structure
+
+This site is maintained as static HTML, but many paths still mirror the original
+WordPress export. Top-level folders such as `about-us/`, `events/`, `services/`,
+and `2013-sunday-service-archive/` are public URLs, so do not move or rename them
+without also planning redirects.
+
+- `index.html` — home page
+- `*/index.html` — public pages and archives
+- `blog/` — mirrored blog archive pages
+- `wp-content/` — theme files, plugin assets, fonts, images, and uploads used by
+  the exported pages
+- `wp-includes/` and `cdn-cgi/` — legacy static support files referenced by pages
+- `wp/` — legacy uploaded media path kept for compatibility
+- `docs/` — maintainer notes and structure guides
+- `.forgejo/` — deploy automation, do not edit during content work
+
 ## Editing & deploy
 
 Plain static files, no build step. Edit on a branch, **preview locally**
 (`python3 -m http.server 8000` → http://localhost:8000), open a PR into `main`, and
 merge — merging `main` auto-deploys to the live site within ~1 minute.
 
-See **[AGENTS.md](./AGENTS.md)** for the full workflow and repo layout (also read by
-AI coding assistants).
+See **[AGENTS.md](./AGENTS.md)** for the full workflow and
+**[docs/SITE-STRUCTURE.md](./docs/SITE-STRUCTURE.md)** for a maintainer-oriented
+map of what lives where.