diff --git a/AGENTS.md b/AGENTS.md
index 017678c6..de929105 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -33,3 +33,6 @@ Standard commands are documented in `README.md` and `package.json` scripts. Quic
 - **Pre-existing test failures**: 6 tests in `apps/web-client` fail due to Zustand persist middleware requiring `localStorage` which is not properly mocked in the jsdom test environment. These are pre-existing and not caused by environment setup. The failing stores are `auth-store` and `chat-store`.
 - **Backend services (.NET)**: All services under `services/*-net/` require .NET 10 SDK, Neon PostgreSQL, and Redis. They are not runnable in the default cloud environment without those dependencies.
 - **web-client dev server**: Runs on port 3000 by default via `next dev`.
+- **.NET 10 SDK for Blazor apps**: Install via `~/.dotnet/dotnet-install.sh --channel 10.0 --install-dir $HOME/.dotnet`. The update script handles this automatically. Ensure `DOTNET_ROOT=$HOME/.dotnet` and `PATH` includes `$HOME/.dotnet`.
+- **Blazor TPOS app (`web-client-tpos-net`) pre-existing build errors**: Files in `Pages/Pos/Shared/Dialogs/` (`VoidRefund.razor`, `OrderEdit.razor`, `SplitBill.razor`) have `"` encoding and syntax errors that prevent `dotnet build`/`dotnet run`. The Payment workflow files in `Pages/Pos/Shared/Payment/` compile cleanly.
+- **Blazor TPOS dev server**: `dotnet run --project src/WebClientTpos.Server` from `apps/web-client-tpos-net/` serves on port 5091 (requires pre-existing Dialogs build errors to be fixed first).