.

AGENTS.md

@@ -0,0 +1,30 @@
+# Agent Instructions
+
+## Build and Task Commands
+
+Prefer using `just` commands over raw dotnet/build commands:
+
+| Task | Command |
+|------|---------|
+| Build project | `just build` |
+| Run tests | `just test` |
+| Generate card database | `just gen-db` |
+| Publish app | `just publish` |
+| Run full dev workflow | `just dev` |
+
+## Project Structure
+
+- `src/Scry.App` - MAUI mobile app
+- `src/Scry.Core` - Core library (recognition, hashing, database)
+- `test/Scry.Tests` - Unit tests
+- `tools/DbGenerator` - Card hash database generator
+
+## Database Generator
+
+The `just gen-db` command:
+- Builds the DbGenerator tool
+- Runs it against `src/Scry.App/Resources/Raw/card_hashes.db`
+- Supports incremental updates (only downloads missing cards)
+- Prefers LEA/LEB (Alpha/Beta) sets for reference_alpha test cards
+
+Use `--force` flag to rebuild from scratch if needed.