From b5a85662b3aff5fe04f2422fd14aea6937c50b54 Mon Sep 17 00:00:00 2001 From: Geekur Date: Tue, 11 Aug 2026 00:42:26 +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 | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..36a2f5b --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,25 @@ +# 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 small public web service that hands out free golf-course data — search ~14,700 US courses by name or state, then get that course's scorecard, tee boxes, climate averages and nearby hotels/restaurants, as JSON. It also had two "send us data" endpoints: submit a missing course, and upload anonymized GPS "moments" from a golf app. + +## Stack + +Node/TypeScript + Cloudflare Workers + Supabase + +## Commands + +- `npm install` — install dependencies +- `npm run dev` — dev +- `npm run test` — test +- `npm run typecheck` — typecheck +- `npm run deploy` — deploy + +## 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 0fa99be7502d302b2553361ecd084fe50d3587aa Mon Sep 17 00:00:00 2001 From: Geekur Date: Tue, 11 Aug 2026 03:54:15 +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..6761007 --- /dev/null +++ b/.gstack/inbox.md @@ -0,0 +1,10 @@ +# G-Stat inbox — opengolfapi/api + +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 36a2f5b..f4cc1a4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -23,3 +23,4 @@ Node/TypeScript + Cloudflare Workers + Supabase - 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.