Add Cursor Cloud agent setup notes

AGENTS.md

@@ -50,12 +50,12 @@ dotnet test Trackdub.slnx -m:1
 dotnet test tests/Trackdub.<Area>.Tests --no-restore -m:1
 
 # Single test
-dotnet test tests/Trackdub.Application.Tests --filter "FullyQualifiedName~<TestName>"
+dotnet test tests/Trackdub.Application.Tests --filter "FullyQualifiedName~<TestName>" -m:1
 
 # CI build (Release, warnings as errors)
-dotnet restore Trackdub.slnx
+dotnet restore Trackdub.slnx -m:1
 dotnet build Trackdub.slnx --configuration Release --no-restore -m:1 -warnaserror
-dotnet test Trackdub.slnx --configuration Release --no-build
+dotnet test Trackdub.slnx --configuration Release --no-build -m:1
 
 # Run headless CLI
 dotnet run --project src/Trackdub.Cli -- --help
@@ -130,7 +130,20 @@ Full procedure: [docs/operations/linear-workflow.md](docs/operations/linear-work
 
 See [docs/repository-policy.md](docs/repository-policy.md) for organization and governance details.
 
+## Cursor Cloud specific instructions
+
+No long-running services. The product entrypoint is the headless CLI (`src/Trackdub.Cli`). Standard build/test/run commands are in [AGENTS.md Commands](#commands) and README.
+
+### Cloud agent gotchas
+
+- Always pass `-m:1` to `dotnet restore`, `dotnet build`, and `dotnet test` (matches CI and avoids restore/build races).
+- NuGet restore needs network access to both `nuget.org` and the Azure Artifacts `dotnet-libraries` feed (see `NuGet.config`) for `Microsoft.ML.Tokenizers` 3.x.
+- `dotnet format Trackdub.slnx --verify-no-changes` is the lint/format gate (CI `format` job).
+- FFmpeg/ffprobe are required for media stages; playback natives (libmpv/LibVLC) are optional for CLI pipeline runs. Readiness: `dotnet run --project src/Trackdub.Cli -- doctor`.
+- Full `dub` / ASR / TTS / translation need ONNX models downloaded into the model cache (`dotnet run --project src/Trackdub.Cli -- models bundle-needed`, then `dotnet run --project src/Trackdub.Cli -- models download <id>`). Tests that need models skip cleanly when missing.
+- Prefer `dotnet run --project src/Trackdub.Cli -- <args>` over a global tool install. Use `--no-build` after a fresh Debug build.
+- Default data/cache roots land under `~/.local/share/Trackdub` (override with `TRACKDUB_DATA_ROOT` / `TRACKDUB_CACHE_ROOT` if needed).
 
 ## Documentation
 
-See [docs/index.md](docs/index.md) for the categorized documentation index (ADRs, architecture, specs, audits, operations, and more).
+See [docs/index.md](docs/index.md) for the categorized documentation index (ADRs, architecture, specs, audits, operations, and more).