# 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.
