Rules of the course
Prompt Golf is a game of skill: reading a spec carefully and instructing an AI precisely. These rules keep the board honest.
The game
- Why golf? In golf, the best player isn't the one who swings hardest — it's the one who needs the fewest strokes. Same here: precision beats volume. Every message and every wasted word costs tokens; the tightest line through the problem wins. Par is what a clean round should cost — finish under it and you played it well.
- Each hole gives you a broken function and an embedded AI. You can't edit the code — you can only instruct the AI in natural language.
- Your score is the total tokens spent across your messages and the AI's replies (as reported by the model provider, counted server-side). Lowest score wins. Strokes (number of messages) break nothing — tokens are the score; the hole's Par is the bar.
- A hole counts when your code passes all hidden tests. Failing cases are revealed as hints; passing hidden cases stay hidden.
Ranking
- Per hole: your best solved attempt while the hole is live, ranked by fewest tokens; earlier solve breaks ties. You must be signed in for a solve to count.
- Season: most holes solved, then fewest total tokens across them, then earliest finish. Prizes (when announced) are judged on the season board or a specific hole's board, as stated in the announcement.
- Holes open and close on a schedule. When a hole closes, its board freezes — closed holes stay playable in the archive, but archive solves are never ranked.
Fair play
- One account per person. One person per account.
- Instruct the AI — don't dictate to it. Pasting the finished solution (in code or as a line-by-line transcription) defeats the game and is not a valid solve.
- Every attempt's full transcript is stored. Top placements are reviewed before any prize is awarded.
- We may disqualify attempts or accounts for multi-accounting, solution dictation, exploit of a platform bug, or automation. Decisions after review are final.
Prizes
- Prize periods, eligibility, and what's awarded are announced per period. If nothing is announced, you're playing for the board and the bragging rights.
- Where a prize is offered, it's a competition of skill — no purchase, no entry fee.
Privacy
- Anonymous play stores your attempt (code, transcript, token counts) under a session cookie. Signing in links it to your account and public username.
- Leaderboards show your username, display name, and scores. Nothing else is public.