# CLAUDE.md — godosa-engine

Shared engine library for Avalonia + Silk.NET games. Terse everywhere.
Private notes (tasks, specs, catalog) are kept outside this repo; never add them here (see `.gitignore`).

## Rules
- Lib knows no game: no game types, game names, env var names or settings classes. The game passes values in
  or implements a small interface (`IAudioMix`, key-target `Func`, env var name via `Configure`).
- `Godosa.Core` = pure .NET, tested. `Godosa.Desktop` / `Godosa.Audio` / `Godosa.Gamepad` = Avalonia+GL, OpenAL, SDL glue.
- `public` for anything a game uses. Warnings are errors. Package versions only in
  `Directory.Packages.props`, equal to the games' (Avalonia 12.1.2, all Silk.NET 2.23.0).
- New tests mutation-checked: `scripts/mutate.sh` = KILLED.
- Breaking API is allowed: the games adapt when they take the update.

## Build / test (≈ 10 s)
`dotnet build Godosa.slnx` (0 warnings) · `dotnet test Godosa.slnx` · `python3 -m unittest discover -s scripts -p 'test_*.py'`.
From a game: its solution includes the lib projects, so its `dotnet test` runs the lib tests too.

## Git
- Branch `master`. Games use this repo as the submodule `lib/godosa-engine`.
- Work in a git worktree on a branch (`.worktrees/<topic>`), not in the main tree; ff-merge to `master` when green.

## Where
`src/Godosa.*` · `scripts/` · `docs/notes/`.