diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..e2008fd
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,79 @@
+# AGENTS.md — The Fat Dragon website
+
+This file tells any AI coding assistant how to work on this website. Read it before
+making changes.
+
+## What this is
+
+The live website for **The Fat Dragon** — a board-game café & arcade in Ashbourne,
+Co. Meath. It is a **plain static site**: hand-written HTML, CSS and JavaScript with
+**no build step and no dependencies**. The files in this repo are served to visitors
+*exactly as they are committed* — what you see locally is what goes live.
+
+The site is live at **https://thefatdragon.bcgen.ie**.
+
+## Repo map
+
+| Path | What it is |
+|------|------------|
+| `index.html` | Home page |
+| `arcade.html`, `board-games.html`, `events.html`, `find-us.html` | Top-level pages |
+| `book-now/` | Booking pages (`index.html`, `arcade.html`, `dnd.html`, `table-games.html`) |
+| `css/style.css` | All styling (single stylesheet) |
+| `js/main.js` | All page JavaScript (nav toggle, etc.) |
+| `assets/` | Images (`.webp` photos, logo) |
+| `.forgejo/` | **Deploy automation — do not touch** (see "Guardrails") |
+
+Links between pages are **absolute** (e.g. `/css/style.css`, `/book-now/`). That is why
+you must preview through a local web server, not by opening the `.html` file directly.
+
+## The workflow (follow this every time)
+
+### 1. Make changes on a branch
+Never edit `main` directly. Start from an up-to-date `main` and create a branch:
+
+```bash
+git checkout main && git pull
+git checkout -b describe-your-change      # e.g. update-opening-hours
+```
+
+### 2. Preview locally before shipping
+From the repo root, start a local server and open it in a browser:
+
+```bash
+python3 -m http.server 8000
+# then open http://localhost:8000
+```
+(No Python? `npx serve` or any static file server works — just serve the repo root.)
+
+Visually check every page you touched. **Do not ship a change you have not previewed.**
+
+### 3. Open a pull request into `main`
+When it looks right, commit, push the branch, and open a PR targeting `main`:
+
+```bash
+git add -A
+git commit -m "Update opening hours on Find Us page"
+git push -u origin describe-your-change
+```
+Then open the pull request (UI or API) with `main` as the base. Use PRs even though
+direct pushes are allowed — they keep a clean, reviewable history of every change.
+
+### 4. Merge to publish
+Merging the PR into `main` triggers automatic deployment. The live site at
+**https://thefatdragon.bcgen.ie** updates within about a minute. There is nothing
+else to run or deploy.
+
+## Guardrails
+
+- **Keep it dependency-free static HTML/CSS/JS.** No frameworks, bundlers, or build
+  tools — anything added to the repo is served raw.
+- **Never edit `.forgejo/`** or anything related to deployment/hosting. That is managed
+  separately; changing it can break publishing.
+- Keep new images in `assets/`, use `.webp` where possible, and keep them reasonably
+  small so pages load fast.
+- After editing, check that internal links and images still resolve (you'll catch this
+  in the local preview).
+- Match the existing style: the look uses the Playfair Display / Orbitron / Inter fonts
+  and the classes already defined in `css/style.css` — reuse them rather than inventing
+  new patterns.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..b5911b3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,2 @@
+See [AGENTS.md](./AGENTS.md) for how to work on this website (repo layout, local
+preview, and the branch → PR → merge-to-publish workflow).
diff --git a/README.md b/README.md
index de1127d..4a3b3f6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,14 @@
 # website
 
-The Fat Dragon website — static HTML
\ No newline at end of file
+The Fat Dragon website — a static HTML/CSS/JS site, served exactly as committed.
+
+Live at **https://thefatdragon.bcgen.ie**.
+
+## 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).