@AGENTS.md

# Barg-e Vasat (Hokm) — start here

**Read `HANDOFF.md` first** — it is the single source of truth for this project:
what it is, how to run (dev + Docker stack), the architecture, the
client↔server gamification sync rule, feature status, CI/CD + mirror cert
workaround, and the TODO list.

Quick facts:
- Next.js 16 static-export app at root; .NET 10 SignalR backend in `server/`.
- Git remote `origin` = Gitea (`soroushdes/HokmPlay`, branch `main`); push triggers CI/CD.
- i18n: add every string to BOTH `fa` and `en` in `src/lib/i18n.tsx`.
- Gamification lives in `src/lib/online/gamification.ts` (client) AND
  `server/src/Hokm.Server/Profiles/Gamification.cs` (server) — keep them in sync;
  the server is authoritative in live mode.
- Verify before committing: `npx tsc --noEmit` · `npx tsx scripts/sim.ts` ·
  `dotnet build server/Hokm.slnx -c Release` · `npm run build`.