diff --git a/AGENTS.md b/AGENTS.md
index 43fed37..45dc0e2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -50,12 +50,12 @@ dotnet test Trackdub.slnx -m:1
dotnet test tests/Trackdub..Tests --no-restore -m:1
# Single test
-dotnet test tests/Trackdub.Application.Tests --filter "FullyQualifiedName~"
+dotnet test tests/Trackdub.Application.Tests --filter "FullyQualifiedName~" -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 `). Tests that need models skip cleanly when missing.
+- Prefer `dotnet run --project src/Trackdub.Cli -- ` 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).
\ No newline at end of file
+See [docs/index.md](docs/index.md) for the categorized documentation index (ADRs, architecture, specs, audits, operations, and more).