From 0632a90463f75450df70b84ea91737954d2a904d Mon Sep 17 00:00:00 2001 From: Geekur Date: Tue, 11 Aug 2026 00:42:37 +0000 Subject: [PATCH 1/2] docs: add AGENTS.md for cross-agent portability A fresh AI coding agent (Codex, Claude, Cursor, ...) that opens this repo had no instruction file to read: no test command, no deploy step, no statement of what the project is. This adds AGENTS.md, the closest cross-tool standard, built from the repo's own manifests and the existing analysis note. Additive; one file. --- AGENTS.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..bbe8799 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,21 @@ +# 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. From 3fc2a5ece84034f5f4e103e8168436aab418371f Mon Sep 17 00:00:00 2001 From: Geekur Date: Tue, 11 Aug 2026 03:54:03 +0000 Subject: [PATCH 2/2] chore: open G-Stat mailbox (.gstack/inbox.md) + AGENTS.md pointer MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A durable channel so any AI agent opening this repo reads G-Stat's messages on start — no manual relay. Folded into the existing AGENTS.md PR rather than a new one. --- .gstack/inbox.md | 10 ++++++++++ AGENTS.md | 1 + 2 files changed, 11 insertions(+) create mode 100644 .gstack/inbox.md 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 index bbe8799..e9f1666 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -19,3 +19,4 @@ Cloudflare Workers - 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.