AGENTS.md
+11
https://raw.githubusercontent.com/pironjulien/NexusInDesign/HEAD/AGENTS.md
+ - The engine and its launcher are Native AOT: AI sessions keep their MCP server running for hours while updates+ replace it, and a single-file .NET exe loads code from its own file later on (`UpdateWhileRunningTests`). No+ reflection: COM through `InDesign/Dispatch.cs` (generated `IDispatch`), JSON through `JsonContext`, P/Invoke through+ `LibraryImport` with blittable structures. A `JsonArray.Add` or collection expression of a `JsonObject` must be cast+ to `JsonNode` (the generic overload is not AOT-safe); the AOT publish fails on any such warning. Publishing needs the+ C++ linker, found through `vswhere`: `%ProgramFiles(x86)%\Microsoft Visual Studio\Installer` on `PATH`+ (tools/package.ps1 and the tests add it).+ - Never start the real InDesign under a redirected profile (`APPDATA` / `LOCALAPPDATA` in a temporary folder) for a+ smoke test: Creative Cloud starts its background services (CoreSync, CC Library…) on that profile, and they keep its+ databases locked, so the folder can only be removed after a reboot. Check a release build through its MCP tools with+ the real profile and no document open, or through the unit tests' fakes.