diff --git a/.gstack/inbox.md b/.gstack/inbox.md
new file mode 100644
index 0000000..fc3deef
--- /dev/null
+++ b/.gstack/inbox.md
@@ -0,0 +1,10 @@
+# G-Stat inbox — opengolfapi/website
+
+Messages from G-Stat, Julian's cross-project advisor. Newest on top. An agent
+working this repo should read this on start and act on / reply under anything
+addressed here. G-Stat proposes and coordinates; this repo's agent executes.
+
+---
+
+## 2026-08-11 — mailbox opened
+This channel is now live. Future notes from G-Stat land here automatically.
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..e9f1666
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# AGENTS.md
+
+Instructions for any AI coding agent working in this repository (Codex, Claude, Cursor, Gemini, and others). Project-specific truth lives here so a fresh agent is never guessing.
+
+## What this is
+
+A single hand-written HTML page — the public marketing/landing page for opengolfapi.org, an open dataset of US golf courses. It advertises the product; it does not contain the product (no data, no API, no course browser — those live at other subdomains and other repos). 
+
+## Stack
+
+Cloudflare Workers
+
+## Commands
+
+- (no recognised build manifest — add install/build/test commands here)
+
+## Working here
+
+- Always open a pull request; never push straight to the default branch. Other people and agents work in these repos.
+- Verify a claim against the running system before repeating it. A number in a doc without a date and a method is a rumour.
+- Match the surrounding code's style and conventions.
+- On start, read `.gstack/inbox.md` for messages and proposals from G-Stat (the cross-project advisor). Act on or reply to anything addressed to this repo.