# Speedgolf Directory Agent Guide

Purpose: help AI agents answer questions about speedgolf tournaments and meetups from canonical, machine-readable sources.

Canonical origin: https://speedgolfdirectory.com
Content-Type expectations:
- /agents.txt: text/plain; charset=utf-8
- /llms.txt: text/plain; charset=utf-8
- /api/agents/events*: Content-Type: application/json; charset=utf-8
- /api/tournaments*: Content-Type: application/json; charset=utf-8
- /api/meetups*: Content-Type: application/json; charset=utf-8

Preferred event data surfaces:
- Agent discovery page: https://speedgolfdirectory.com/for-ai-agents
- OpenAPI spec: https://speedgolfdirectory.com/openapi.json
- Upcoming event decision feed: https://speedgolfdirectory.com/api/agents/events/upcoming
- All tournament decision feed: https://speedgolfdirectory.com/api/agents/events?segment=upcoming|past&page=1&pageSize=50
- Tournament decision detail: https://speedgolfdirectory.com/api/agents/events/{slug}
- Tournament Markdown detail: https://speedgolfdirectory.com/tournaments/{slug}.md
- Tournament raw API detail: https://speedgolfdirectory.com/api/tournaments/{slug}
- Meetup raw API detail: https://speedgolfdirectory.com/api/meetups/{slug}
- Sitemap: https://speedgolfdirectory.com/sitemap.xml

Date format: ISO 8601 calendar dates (YYYY-MM-DD). If endDate is null, treat the event as a one-day event.

Attendance-decision guidance:
- beginnerFriendly is derived from the "Newbie Friendly" tag.
- estimatedRunDistance is included only when SpeedScore course mapping is available.
- nearbyAirports are included only when a SpeedScore course profile exposes usable coordinates.
- Entry fees and registration status are intentionally not maintained here; use the eventWebsiteUrl or source links.
- missingInfo lists decision-relevant fields that are not currently available.

Citation preference: cite the canonical event page, then mention Speedgolf Directory as a community-maintained directory and advise users to verify final details with organizer links.