super-auto-pets-board-game/CLAUDE.md

Super Auto Pets: The Board Game

Go backend (pure rules engine in internal/game, WebSocket rooms in internal/server, computer opponent in internal/ai) + React frontend in web/. See README.md for the full layout and rules summary.

• mise run test — Go tests · mise run check — go vet + frontend tsc

Keep the AI in sync with game behavior

Whenever game behavior changes — rules, cards, effects, phases, log entries, or views — make sure the computer opponent accounts for it. The AI plays from the same information a human sees, so changes ripple into it in specific ways:

• Battle rules: internal/ai evaluates moves by running the real resolver (game.SimulateBattle), so battle changes are picked up automatically — but re-check the hand-written heuristics that summarize battle wisdom: leadScore, keepValue, deckValue (eval.go) and the food-placement strategies / synergy pet list (arrange.go).
• New or changed cards/effects: shop-time deck effects are mirrored in applyTemplateShopEffects (shop.go); a new shop-time trigger or action must be added there or the bot will misvalue it.
• New public actions or log changes: the bot tracks the opponent via structured tags on public log entries (LogBuy, LogSell, LogTrade, LogTradePick, spawn counts — see log.go). New public actions need tags plus handling in Observe (memory.go). Tags must only ever duplicate facts the entry's text already states publicly.
• View changes: the AI decides from game.View only — never hand it the Game. If a field is added to the view, confirm it doesn't leak hidden information (deck order, trade options, shop decks), because the AI (and any client) would legitimately see it.
• Phase/flow changes: the server's bot driver (internal/server/bots.go) must know when a bot owes an action (ai.Pending) and have a legal fallback (botFallback) for any new phase or forced decision.

After any such change, run go test ./internal/ai/ — it plays complete bot-vs-bot games and fails on any illegal or missing bot action.