Skip to content

CLAUDE.md

Latest commit

 

History

History
46 lines (33 loc) · 2.06 KB

CLAUDE.md

File metadata and controls

46 lines (33 loc) · 2.06 KB
Raw

CLAUDE.md

Code Style

  • Small functions — one responsibility, fits on screen
  • Small structs — group only what belongs together
  • Comment every exported function, type, and non-obvious block
  • Follow standard Go conventions (gofmt, golint)

Testing

  • Write unit tests for every function with logic
  • Table-driven tests preferred
  • Use interfaces and mocks to isolate dependencies (especially NanoRPC and DB)

General

  • Prefer clarity over cleverness
  • No premature abstractions — solve the problem in front of you
  • Keep dependencies minimal

Separation of Concerns

  • Each directory owns one concern — game logic, HTTP handling, DB, templates, and static assets must never bleed into each other's directories
  • Behaviours (game rules, RPC calls, DB queries) live in internal/; presentation (HTML, CSS, JS) lives in internal/templates/ and web/static/
  • Each game or feature gets its own subdirectory — do not mix concerns from different games in shared files unless it is genuinely shared logic
  • Pages and routes for a game belong to that game's handler and template directory, not a sibling game's

Project Structure

  • internal/games/ — shared faucet game logic (package games)
  • internal/games/farm/ — Nano Faucet Multiplayer Farm game logic (package farm)
  • internal/handler/ — HTTP handlers for all games
  • internal/db/ — PostgreSQL layer; migrations in internal/db/migrations/
  • internal/nano/ — Nano RPC, wallet derivation, block signing
  • internal/templates/faucet_game/ — HTML templates for the faucet shooter game
  • internal/templates/faucet_multiplayer_farm_templates/ — HTML templates for the Farm
  • web/static/ — shared static assets; web/static/faucet_multiplayer_farm_static/ for Farm assets

Skills

Custom AI persona prompts live in .claude/skills/<name>/SKILL.md:

  • /storyteller — expert narrative craft, world-building, Farm dialogue
  • /gamedev — expert game developer (math, physics, multiplayer, Farm systems)
  • /webdev — expert web developer (HTML/CSS/JS, Go net/http, security, performance)