[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-dotnet-msbuild-antipatterns":3,"mdc--3jr6nd-key":31,"related-org-dotnet-msbuild-antipatterns":3374,"related-repo-dotnet-msbuild-antipatterns":3539},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":19,"repoUrl":20,"updatedAt":21,"license":22,"forks":23,"topics":24,"repo":26,"sourceUrl":29,"mdContent":30},"msbuild-antipatterns","audit and clean up MSBuild files","Detect and fix MSBuild anti-patterns in project and build files. USE WHEN asked to review, audit, lint, clean up, or code-review a .csproj\u002F.vbproj\u002F.fsproj\u002F.props\u002F.targets\u002F.proj (or Directory.Build.props\u002F.targets) file, when asked 'is this project file correct?' or 'what's wrong with my build file?', or when hunting subtle build bugs caused by how a project is authored. Each anti-pattern has a symptom and a concrete BAD→GOOD fix. DO NOT USE FOR: non-MSBuild build systems (npm, Maven, CMake), or migrating a project to SDK-style (use msbuild-modernization).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"dotnet",".NET (Microsoft)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fdotnet.png",[12,16],{"name":13,"slug":14,"type":15},"Engineering","engineering","tag",{"name":17,"slug":18,"type":15},"Code Analysis","code-analysis",4576,"https:\u002F\u002Fgithub.com\u002Fdotnet\u002Fskills","2026-07-19T05:38:16.32349","MIT",332,[25],"agent-skills",{"repoUrl":20,"stars":19,"forks":23,"topics":27,"description":28},[25],"Repository for skills to assist AI coding agents with .NET and C#","https:\u002F\u002Fgithub.com\u002Fdotnet\u002Fskills\u002Ftree\u002FHEAD\u002Fplugins\u002Fdotnet-msbuild\u002Fskills\u002Fmsbuild-antipatterns","---\nname: msbuild-antipatterns\ndescription: \"Detect and fix MSBuild anti-patterns in project and build files. USE WHEN asked to review, audit, lint, clean up, or code-review a .csproj\u002F.vbproj\u002F.fsproj\u002F.props\u002F.targets\u002F.proj (or Directory.Build.props\u002F.targets) file, when asked 'is this project file correct?' or 'what's wrong with my build file?', or when hunting subtle build bugs caused by how a project is authored. Each anti-pattern has a symptom and a concrete BAD→GOOD fix. DO NOT USE FOR: non-MSBuild build systems (npm, Maven, CMake), or migrating a project to SDK-style (use msbuild-modernization).\"\nlicense: MIT\n---\n\n# MSBuild Anti-Pattern Catalog\n\nA numbered catalog of common MSBuild anti-patterns. Each entry follows the format:\n\n- **Smell**: What to look for\n- **Why it's bad**: Impact on builds, maintainability, or correctness\n- **Fix**: Concrete transformation\n\nUse this catalog when scanning project files for improvements.\n\n---\n\n## AP-01: `\u003CExec>` for Operations That Have Built-in Tasks\n\n**Smell**: `\u003CExec Command=\"mkdir ...\" \u002F>`, `\u003CExec Command=\"copy ...\" \u002F>`, `\u003CExec Command=\"del ...\" \u002F>`\n\n**Why it's bad**: Built-in tasks are cross-platform, support incremental build, emit structured logging, and handle errors consistently. `\u003CExec>` is opaque to MSBuild.\n\n```xml\n\u003C!-- BAD -->\n\u003CTarget Name=\"PrepareOutput\">\n  \u003CExec Command=\"mkdir $(OutputPath)logs\" \u002F>\n  \u003CExec Command=\"copy config.json $(OutputPath)\" \u002F>\n  \u003CExec Command=\"del $(IntermediateOutputPath)*.tmp\" \u002F>\n\u003C\u002FTarget>\n\n\u003C!-- GOOD -->\n\u003CTarget Name=\"PrepareOutput\">\n  \u003CMakeDir Directories=\"$(OutputPath)logs\" \u002F>\n  \u003CCopy SourceFiles=\"config.json\" DestinationFolder=\"$(OutputPath)\" \u002F>\n  \u003CDelete Files=\"@(TempFiles)\" \u002F>\n\u003C\u002FTarget>\n```\n\n**Built-in task alternatives:**\n\n| Shell Command | MSBuild Task |\n|--------------|--------------|\n| `mkdir` | `\u003CMakeDir>` |\n| `copy` \u002F `cp` | `\u003CCopy>` |\n| `del` \u002F `rm` | `\u003CDelete>` |\n| `move` \u002F `mv` | `\u003CMove>` |\n| `echo text > file` | `\u003CWriteLinesToFile>` |\n| `touch` | `\u003CTouch>` |\n| `xcopy \u002Fs` | `\u003CCopy>` with item globs |\n\n---\n\n## AP-02: Unquoted Condition Expressions\n\n**Smell**: `Condition=\"$(Foo) == Bar\"` — either side of a comparison is unquoted.\n\n**Why it's bad**: If the property is empty or contains spaces\u002Fspecial characters, the condition evaluates incorrectly or throws a parse error. MSBuild requires single-quoted strings for reliable comparisons.\n\n```xml\n\u003C!-- BAD -->\n\u003CPropertyGroup Condition=\"$(Configuration) == Release\">\n  \u003COptimize>true\u003C\u002FOptimize>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD -->\n\u003CPropertyGroup Condition=\"'$(Configuration)' == 'Release'\">\n  \u003COptimize>true\u003C\u002FOptimize>\n\u003C\u002FPropertyGroup>\n```\n\n**Rule**: Always quote **both** sides of `==` and `!=` comparisons with single quotes.\n\n---\n\n## AP-03: Hardcoded Absolute Paths\n\n**Smell**: Paths like `C:\\tools\\`, `D:\\packages\\`, `\u002Fusr\u002Flocal\u002Fbin\u002F` in project files.\n\n**Why it's bad**: Breaks on other machines, CI environments, and other operating systems. Not relocatable.\n\n```xml\n\u003C!-- BAD -->\n\u003CPropertyGroup>\n  \u003CToolPath>C:\\tools\\mytool\\mytool.exe\u003C\u002FToolPath>\n\u003C\u002FPropertyGroup>\n\u003CImport Project=\"C:\\repos\\shared\\common.props\" \u002F>\n\n\u003C!-- GOOD -->\n\u003CPropertyGroup>\n  \u003CToolPath>$(MSBuildThisFileDirectory)tools\\mytool\\mytool.exe\u003C\u002FToolPath>\n\u003C\u002FPropertyGroup>\n\u003CImport Project=\"$(RepoRoot)eng\\common.props\" \u002F>\n```\n\n**Preferred path properties:**\n\n| Property | Meaning |\n|----------|---------|\n| `$(MSBuildThisFileDirectory)` | Directory of the current .props\u002F.targets file |\n| `$(MSBuildProjectDirectory)` | Directory of the .csproj |\n| `$([MSBuild]::GetDirectoryNameOfFileAbove(...))` | Walk up to find a marker file |\n| `$([MSBuild]::NormalizePath(...))` | Combine and normalize path segments |\n\n---\n\n## AP-04: Restating SDK Defaults\n\n**Smell**: Properties set to values that the .NET SDK already provides by default.\n\n**Why it's bad**: Adds noise, hides intentional overrides, and makes it harder to identify what's actually customized. When defaults change in newer SDKs, the redundant properties may silently pin old behavior.\n\n```xml\n\u003C!-- BAD: All of these are already the default -->\n\u003CPropertyGroup>\n  \u003COutputType>Library\u003C\u002FOutputType>\n  \u003CEnableDefaultItems>true\u003C\u002FEnableDefaultItems>\n  \u003CEnableDefaultCompileItems>true\u003C\u002FEnableDefaultCompileItems>\n  \u003CRootNamespace>MyLib\u003C\u002FRootNamespace>       \u003C!-- matches project name -->\n  \u003CAssemblyName>MyLib\u003C\u002FAssemblyName>         \u003C!-- matches project name -->\n  \u003CAppendTargetFrameworkToOutputPath>true\u003C\u002FAppendTargetFrameworkToOutputPath>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD: Only non-default values -->\n\u003CPropertyGroup>\n  \u003CTargetFramework>net8.0\u003C\u002FTargetFramework>\n\u003C\u002FPropertyGroup>\n```\n\n---\n\n## AP-05: Manual File Listing in SDK-Style Projects\n\n**Smell**: `\u003CCompile Include=\"File1.cs\" \u002F>`, `\u003CCompile Include=\"File2.cs\" \u002F>` in SDK-style projects.\n\n**Why it's bad**: SDK-style projects automatically glob `**\u002F*.cs` (and other file types). Explicit listing is redundant, creates merge conflicts, and new files may be accidentally missed if not added to the list.\n\n```xml\n\u003C!-- BAD -->\n\u003CItemGroup>\n  \u003CCompile Include=\"Program.cs\" \u002F>\n  \u003CCompile Include=\"Services\\MyService.cs\" \u002F>\n  \u003CCompile Include=\"Models\\User.cs\" \u002F>\n\u003C\u002FItemGroup>\n\n\u003C!-- GOOD: Remove entirely — SDK includes all .cs files by default.\n     Only use Remove\u002FExclude when you need to opt out: -->\n\u003CItemGroup>\n  \u003CCompile Remove=\"LegacyCode\\**\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n**Exception**: Non-SDK-style (legacy) projects require explicit file includes. If migrating, see `msbuild-modernization` skill.\n\n**Exception (F# \u002F `.fsproj`)**: F# compilation is order-dependent — the compiler processes `\u003CCompile Include>` items sequentially and a file can only reference types\u002Fmodules declared in files listed above it. `.fsproj` files must therefore list every source file explicitly, in dependency order (utility\u002Fleaf modules at the top, the entry point such as `Program.fs` at the bottom). If a `.fsi` signature file is used, it must appear **immediately before** its companion `.fs` implementation file.\n\n---\n\n## AP-06: Using `\u003CReference>` with HintPath for NuGet Packages\n\n**Smell**: `\u003CReference Include=\"...\" HintPath=\"..\\packages\\SomePackage\\lib\\...\" \u002F>`\n\n**Why it's bad**: This is the legacy `packages.config` pattern. It doesn't support transitive dependencies, version conflict resolution, or automatic restore. The `packages\u002F` folder must be committed or restored separately.\n\n```xml\n\u003C!-- BAD -->\n\u003CItemGroup>\n  \u003CReference Include=\"Newtonsoft.Json\">\n    \u003CHintPath>..\\packages\\Newtonsoft.Json.13.0.3\\lib\\netstandard2.0\\Newtonsoft.Json.dll\u003C\u002FHintPath>\n  \u003C\u002FReference>\n\u003C\u002FItemGroup>\n\n\u003C!-- GOOD -->\n\u003CItemGroup>\n  \u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.3\" \u002F>\n\u003C\u002FItemGroup>\n```\n\n**Note**: `\u003CReference>` without HintPath is still valid for .NET Framework GAC assemblies like `WindowsBase`, `PresentationCore`, etc.\n\n---\n\n## AP-07: Missing `PrivateAssets=\"all\"` on Analyzer\u002FTool Packages\n\n**Smell**: `\u003CPackageReference Include=\"StyleCop.Analyzers\" Version=\"...\" \u002F>` without `PrivateAssets=\"all\"`.\n\n**Why it's bad**: Without `PrivateAssets=\"all\"`, analyzer and build-tool packages flow as transitive dependencies to consumers of your library. Consumers get unwanted analyzers or build-time tools they didn't ask for.\n\nSee [`references\u002Fprivate-assets.md`](references\u002Fprivate-assets.md) for BAD\u002FGOOD examples and the full list of packages that need this.\n\n---\n\n## AP-08: Copy-Pasted Properties Across Multiple .csproj Files\n\n**Smell**: The same `\u003CPropertyGroup>` block appears in 3+ project files.\n\n**Why it's bad**: Maintenance burden — a change must be made in every file. Inconsistencies creep in over time.\n\n```xml\n\u003C!-- BAD: Repeated in every .csproj -->\n\u003C!-- ProjectA.csproj, ProjectB.csproj, ProjectC.csproj all have: -->\n\u003CPropertyGroup>\n  \u003CNullable>enable\u003C\u002FNullable>\n  \u003CTreatWarningsAsErrors>true\u003C\u002FTreatWarningsAsErrors>\n  \u003CImplicitUsings>enable\u003C\u002FImplicitUsings>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD: Define once in Directory.Build.props at the repo\u002Fsrc root -->\n\u003C!-- Directory.Build.props -->\n\u003CProject>\n  \u003CPropertyGroup>\n    \u003CNullable>enable\u003C\u002FNullable>\n    \u003CTreatWarningsAsErrors>true\u003C\u002FTreatWarningsAsErrors>\n    \u003CImplicitUsings>enable\u003C\u002FImplicitUsings>\n  \u003C\u002FPropertyGroup>\n\u003C\u002FProject>\n```\n\nSee `directory-build-organization` skill for full guidance on structuring `Directory.Build.props` \u002F `Directory.Build.targets`.\n\n---\n\n## AP-09: Scattered Package Versions Without Central Package Management\n\n**Smell**: `\u003CPackageReference Include=\"X\" Version=\"1.2.3\" \u002F>` with different versions of the same package across projects.\n\n**Why it's bad**: Version drift — different projects use different versions of the same package, leading to runtime mismatches, unexpected behavior, or diamond dependency conflicts.\n\n```xml\n\u003C!-- BAD: Version specified in each project, can drift -->\n\u003C!-- ProjectA.csproj -->\n\u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.1\" \u002F>\n\u003C!-- ProjectB.csproj -->\n\u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.3\" \u002F>\n```\n\n**Fix:** Use Central Package Management. See [https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fnuget\u002Fconsume-packages\u002Fcentral-package-management](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fnuget\u002Fconsume-packages\u002Fcentral-package-management) for details.\n\n---\n\n## AP-10: Monolithic Targets (Too Much in One Target)\n\n**Smell**: A single `\u003CTarget>` with 50+ lines doing multiple unrelated things.\n\n**Why it's bad**: Can't skip individual steps via incremental build, hard to debug, hard to extend, and the target name becomes meaningless.\n\n```xml\n\u003C!-- BAD -->\n\u003CTarget Name=\"PrepareRelease\" BeforeTargets=\"Build\">\n  \u003CWriteLinesToFile File=\"version.txt\" Lines=\"$(Version)\" Overwrite=\"true\" \u002F>\n  \u003CCopy SourceFiles=\"LICENSE\" DestinationFolder=\"$(OutputPath)\" \u002F>\n  \u003CExec Command=\"signtool sign \u002Ff cert.pfx $(OutputPath)*.dll\" \u002F>\n  \u003CMakeDir Directories=\"$(OutputPath)docs\" \u002F>\n  \u003CCopy SourceFiles=\"@(DocFiles)\" DestinationFolder=\"$(OutputPath)docs\" \u002F>\n  \u003C!-- ... 30 more lines ... -->\n\u003C\u002FTarget>\n\n\u003C!-- GOOD: Single-responsibility targets -->\n\u003CTarget Name=\"WriteVersionFile\" BeforeTargets=\"CoreCompile\"\n        Inputs=\"$(MSBuildProjectFile)\" Outputs=\"$(IntermediateOutputPath)version.txt\">\n  \u003CWriteLinesToFile File=\"$(IntermediateOutputPath)version.txt\" Lines=\"$(Version)\" Overwrite=\"true\" \u002F>\n\u003C\u002FTarget>\n\n\u003CTarget Name=\"CopyLicense\" AfterTargets=\"Build\">\n  \u003CCopy SourceFiles=\"LICENSE\" DestinationFolder=\"$(OutputPath)\" SkipUnchangedFiles=\"true\" \u002F>\n\u003C\u002FTarget>\n\n\u003CTarget Name=\"SignAssemblies\" AfterTargets=\"Build\" DependsOnTargets=\"CopyLicense\"\n        Condition=\"'$(SignAssemblies)' == 'true'\">\n  \u003CExec Command=\"signtool sign \u002Ff cert.pfx %(AssemblyFiles.Identity)\" \u002F>\n\u003C\u002FTarget>\n```\n\n---\n\n## AP-11: Custom Targets Missing `Inputs` and `Outputs`\n\n**Smell**: `\u003CTarget Name=\"MyTarget\" BeforeTargets=\"Build\">` with no `Inputs` \u002F `Outputs` attributes.\n\n**Why it's bad**: The target runs on every build, even when nothing changed. This defeats incremental build and slows down no-op builds.\n\nSee [`references\u002Fincremental-build-inputs-outputs.md`](references\u002Fincremental-build-inputs-outputs.md) for BAD\u002FGOOD examples and the full pattern including FileWrites registration.\n\nSee `incremental-build` skill for deep guidance on Inputs\u002FOutputs, FileWrites, and up-to-date checks.\n\n---\n\n## AP-12: Setting Defaults in .targets Instead of .props\n\n**Smell**: `\u003CPropertyGroup>` with default values inside a `.targets` file.\n\n**Why it's bad**: `.targets` files are imported late (after project files). By the time they set defaults, other `.targets` files may have already used the empty\u002Fundefined value. `.props` files are imported early and are the correct place for defaults.\n\n```xml\n\u003C!-- BAD: custom.targets -->\n\u003CPropertyGroup>\n  \u003CMyToolVersion>2.0\u003C\u002FMyToolVersion>\n\u003C\u002FPropertyGroup>\n\u003CTarget Name=\"RunMyTool\">\n  \u003CExec Command=\"mytool --version $(MyToolVersion)\" \u002F>\n\u003C\u002FTarget>\n\n\u003C!-- GOOD: Split into .props (defaults) + .targets (logic) -->\n\u003C!-- custom.props (imported early) -->\n\u003CPropertyGroup>\n  \u003CMyToolVersion Condition=\"'$(MyToolVersion)' == ''\">2.0\u003C\u002FMyToolVersion>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- custom.targets (imported late) -->\n\u003CTarget Name=\"RunMyTool\">\n  \u003CExec Command=\"mytool --version $(MyToolVersion)\" \u002F>\n\u003C\u002FTarget>\n```\n\n**Rule**: `.props` = defaults and settings (evaluated early). `.targets` = build logic and targets (evaluated late).\n\n---\n\n## AP-13: Import Without `Exists()` Guard\n\n**Smell**: `\u003CImport Project=\"some-file.props\" \u002F>` without a `Condition=\"Exists('...')\"` check.\n\n**Why it's bad**: If the file doesn't exist (not yet created, wrong path, deleted), the build fails with a confusing error. Optional imports should always be guarded.\n\n```xml\n\u003C!-- BAD -->\n\u003CImport Project=\"$(RepoRoot)eng\\custom.props\" \u002F>\n\n\u003C!-- GOOD: Guard optional imports -->\n\u003CImport Project=\"$(RepoRoot)eng\\custom.props\" Condition=\"Exists('$(RepoRoot)eng\\custom.props')\" \u002F>\n\n\u003C!-- ALSO GOOD: Sdk attribute imports don't need guards (they're required by design) -->\n\u003CProject Sdk=\"Microsoft.NET.Sdk\">\n```\n\n**Exception — required imports**: Imports that are *required* for the build to work correctly should fail fast — don't guard those. Guard imports that are optional or environment-specific (e.g., local developer overrides, CI-specific settings).\n\n**Exception — NuGet package forwarders**: `.props`\u002F`.targets` files inside a NuGet package's per-TFM `build\u002F` or `buildTransitive\u002F` folder routinely import a sibling file under `buildTransitive\u002F\u003Ctfm>\u002F…` without an `Exists()` guard. These are a **package contract**: the target file is guaranteed to be present in the restored package, even if it doesn't appear in the source tree at that relative path. The package layout is typically produced by:\n\n- A custom `.nuspec` with per-TFM `\u003Cfile>` entries — e.g. `\u003Cfile src=\"buildTransitive\\common\\MyAdapter.props\" target=\"buildTransitive\\net8.0\\MyAdapter.props\" \u002F>` — that copy files from a single source folder (such as `buildTransitive\u002Fcommon\u002F`) into per-TFM subfolders at pack time, or\n- `\u003CNone Update=\"...\">` \u002F `\u003CContent Include=\"...\">` items in the `.csproj` with a per-TFM `\u003CPackagePath>` (e.g. `\u003CPackagePath>buildTransitive\u002Fnet8.0\u002F\u003C\u002FPackagePath>`), declared once per target TFM, or\n- SDK conventions (e.g. `IncludeBuildOutput`, `BuildOutputTargetFolder`) that place built outputs under `build\u002F\u003Ctfm>\u002F`.\n\nBefore flagging an unguarded `\u003CImport>` inside a `build\u002F` or `buildTransitive\u002F` folder, **resolve it against the packed layout** — read every `*.nuspec` in the project directory **and its immediate parent directory** (shared nuspecs are common in mono-repos; do not walk further up), and any `\u003CPackagePath>` metadata on `\u003CNone>`\u002F`\u003CContent>` items in the `.csproj`. Only flag if the target path is missing from **both** the source tree *and* the projected package layout. The `dotnet-msbuild\u002Fextension-points` skill — *Source tree vs packed layout* — documents the full cross-check procedure.\n\n**Forwarding `buildTransitive\u002F` → `build\u002F`:** forward through the sibling `build\u002F*.props` \u002F `build\u002F*.targets` file (not directly to `buildMultiTargeting\u002F`); when `build\u002F` is per-TFM (`build\u002F\u003Ctfm>\u002F`), include the TFM segment derived from the file's own folder (not `$(TargetFramework)`), or transitive consumers hit `MSB4019`. See the `extension-points` skill — *Forwarding chain* — for the rule and derivation expression.\n\n---\n\n## AP-14: Backslashes in Paths — Where It Matters\n\n**Smell**: Backslash path separators in `.props`\u002F`.targets` files meant to run cross-platform.\n\n**Where this is a real bug (🔴 Error)** — paths that MSBuild does **not** route through its path normalizer:\n\n- Raw shell strings inside `\u003CExec Command=\"...\\tools\\foo.exe ...\" \u002F>` — passed verbatim to `bash`\u002F`sh` on Unix, which treats `\\` as an escape.\n- Backslash-delimited paths inside CDATA blocks, embedded in source files written by `\u003CWriteLinesToFile>`, or constructed for non-MSBuild consumers (custom scripts, response files, environment variables).\n- Paths handed to custom tasks that call OS file APIs directly without going through MSBuild path utilities.\n\n**Where this is only a style preference (🔵 Style)** — paths that go through MSBuild's evaluator (`\u003CImport Project=\"...\">`, file-path properties consumed by built-in tasks like `\u003CCopy>`\u002F`\u003CMakeDir>`\u002F`\u003CDelete>`, item `Include=`\u002F`Exclude=` globs):\n\nMSBuild's evaluator normalizes `\\` → `\u002F` on Unix-like systems before resolving the path. See `FileUtilities.MaybeAdjustFilePath` and `ConvertToUnixSlashes` in [`microsoft\u002Fmsbuild` `src\u002FFramework\u002FFileUtilities.cs`](https:\u002F\u002Fgithub.com\u002Fdotnet\u002Fmsbuild\u002Fblob\u002Fmain\u002Fsrc\u002FFramework\u002FFileUtilities.cs). So `\u003CImport Project=\"$(MSBuildThisFileDirectory)..\\..\\build\\common.props\" \u002F>` resolves correctly on Linux\u002FmacOS today. Forward slashes are still **preferred for consistency**, but the import will not break and existing backslash-style imports should not be flagged as 🔴 **Error**.\n\n```xml\n\u003C!-- 🔴 Error: \\ in raw shell string breaks on Linux\u002FmacOS -->\n\u003CExec Command=\"$(MSBuildThisFileDirectory)tools\\release\\sign.exe $(OutputPath)\" \u002F>\n\n\u003C!-- 🔵 Style: \\ in Import is normalized on Unix, but \u002F is nicer -->\n\u003CImport Project=\"$(MSBuildThisFileDirectory)..\\..\\build\\common.props\" \u002F>\n\n\u003C!-- ✅ Recommended in new code -->\n\u003CImport Project=\"$(MSBuildThisFileDirectory)..\u002F..\u002Fbuild\u002Fcommon.props\" \u002F>\n```\n\n**Verification rule**: Before flagging a backslash path as 🔴 **Error**, ask *\"does this string flow through MSBuild's evaluator, or is it handed verbatim to a non-MSBuild consumer?\"* Only the second case is a correctness defect.\n\n**Note**: `$(MSBuildThisFileDirectory)` already ends with a platform-appropriate separator, so `$(MSBuildThisFileDirectory)tools\u002Fmytool` works on both platforms.\n\n---\n\n## AP-15: Unconditional Property Override in Multiple Scopes\n\n**Smell**: A property set unconditionally in both `Directory.Build.props` and a `.csproj` — last write wins silently.\n\n**Why it's bad**: Hard to trace which value is actually used. Makes the build fragile and confusing for anyone reading the project files.\n\n```xml\n\u003C!-- BAD: Directory.Build.props sets it, csproj silently overrides -->\n\u003C!-- Directory.Build.props -->\n\u003CPropertyGroup>\n  \u003COutputPath>bin\\custom\\\u003C\u002FOutputPath>\n\u003C\u002FPropertyGroup>\n\u003C!-- MyProject.csproj -->\n\u003CPropertyGroup>\n  \u003COutputPath>bin\\other\\\u003C\u002FOutputPath>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD: Use a condition so overrides are intentional -->\n\u003C!-- Directory.Build.props -->\n\u003CPropertyGroup>\n  \u003COutputPath Condition=\"'$(OutputPath)' == ''\">bin\\custom\\\u003C\u002FOutputPath>\n\u003C\u002FPropertyGroup>\n\u003C!-- MyProject.csproj can now intentionally override or leave the default -->\n```\n\n---\n\nFor additional anti-patterns (AP-16 through AP-23) and a quick-reference checklist, see [additional-antipatterns.md](references\u002Fadditional-antipatterns.md).\n",{"data":32,"body":33},{"name":4,"description":6,"license":22},{"type":34,"children":35},"root",[36,45,51,87,92,96,112,142,158,287,295,493,496,502,518,527,601,634,637,643,674,683,772,780,870,873,879,888,897,1012,1015,1021,1044,1061,1160,1178,1242,1245,1259,1273,1298,1386,1417,1420,1434,1457,1473,1490,1493,1499,1516,1525,1668,1694,1697,1703,1719,1728,1775,1794,1797,1803,1820,1829,2027,2030,2049,2078,2087,2102,2114,2117,2123,2146,2176,2317,2339,2342,2356,2380,2389,2457,2475,2536,2645,2749,2840,2843,2849,2871,2888,2944,2996,3071,3140,3163,3186,3189,3195,3218,3227,3353,3356,3368],{"type":37,"tag":38,"props":39,"children":41},"element","h1",{"id":40},"msbuild-anti-pattern-catalog",[42],{"type":43,"value":44},"text","MSBuild Anti-Pattern Catalog",{"type":37,"tag":46,"props":47,"children":48},"p",{},[49],{"type":43,"value":50},"A numbered catalog of common MSBuild anti-patterns. Each entry follows the format:",{"type":37,"tag":52,"props":53,"children":54},"ul",{},[55,67,77],{"type":37,"tag":56,"props":57,"children":58},"li",{},[59,65],{"type":37,"tag":60,"props":61,"children":62},"strong",{},[63],{"type":43,"value":64},"Smell",{"type":43,"value":66},": What to look for",{"type":37,"tag":56,"props":68,"children":69},{},[70,75],{"type":37,"tag":60,"props":71,"children":72},{},[73],{"type":43,"value":74},"Why it's bad",{"type":43,"value":76},": Impact on builds, maintainability, or correctness",{"type":37,"tag":56,"props":78,"children":79},{},[80,85],{"type":37,"tag":60,"props":81,"children":82},{},[83],{"type":43,"value":84},"Fix",{"type":43,"value":86},": Concrete transformation",{"type":37,"tag":46,"props":88,"children":89},{},[90],{"type":43,"value":91},"Use this catalog when scanning project files for improvements.",{"type":37,"tag":93,"props":94,"children":95},"hr",{},[],{"type":37,"tag":97,"props":98,"children":100},"h2",{"id":99},"ap-01-exec-for-operations-that-have-built-in-tasks",[101,103,110],{"type":43,"value":102},"AP-01: ",{"type":37,"tag":104,"props":105,"children":107},"code",{"className":106},[],[108],{"type":43,"value":109},"\u003CExec>",{"type":43,"value":111}," for Operations That Have Built-in Tasks",{"type":37,"tag":46,"props":113,"children":114},{},[115,119,121,127,129,135,136],{"type":37,"tag":60,"props":116,"children":117},{},[118],{"type":43,"value":64},{"type":43,"value":120},": ",{"type":37,"tag":104,"props":122,"children":124},{"className":123},[],[125],{"type":43,"value":126},"\u003CExec Command=\"mkdir ...\" \u002F>",{"type":43,"value":128},", ",{"type":37,"tag":104,"props":130,"children":132},{"className":131},[],[133],{"type":43,"value":134},"\u003CExec Command=\"copy ...\" \u002F>",{"type":43,"value":128},{"type":37,"tag":104,"props":137,"children":139},{"className":138},[],[140],{"type":43,"value":141},"\u003CExec Command=\"del ...\" \u002F>",{"type":37,"tag":46,"props":143,"children":144},{},[145,149,151,156],{"type":37,"tag":60,"props":146,"children":147},{},[148],{"type":43,"value":74},{"type":43,"value":150},": Built-in tasks are cross-platform, support incremental build, emit structured logging, and handle errors consistently. ",{"type":37,"tag":104,"props":152,"children":154},{"className":153},[],[155],{"type":43,"value":109},{"type":43,"value":157}," is opaque to MSBuild.",{"type":37,"tag":159,"props":160,"children":165},"pre",{"className":161,"code":162,"language":163,"meta":164,"style":164},"language-xml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003C!-- BAD -->\n\u003CTarget Name=\"PrepareOutput\">\n  \u003CExec Command=\"mkdir $(OutputPath)logs\" \u002F>\n  \u003CExec Command=\"copy config.json $(OutputPath)\" \u002F>\n  \u003CExec Command=\"del $(IntermediateOutputPath)*.tmp\" \u002F>\n\u003C\u002FTarget>\n\n\u003C!-- GOOD -->\n\u003CTarget Name=\"PrepareOutput\">\n  \u003CMakeDir Directories=\"$(OutputPath)logs\" \u002F>\n  \u003CCopy SourceFiles=\"config.json\" DestinationFolder=\"$(OutputPath)\" \u002F>\n  \u003CDelete Files=\"@(TempFiles)\" \u002F>\n\u003C\u002FTarget>\n","xml","",[166],{"type":37,"tag":104,"props":167,"children":168},{"__ignoreMap":164},[169,180,189,198,207,216,225,235,244,252,261,270,279],{"type":37,"tag":170,"props":171,"children":174},"span",{"class":172,"line":173},"line",1,[175],{"type":37,"tag":170,"props":176,"children":177},{},[178],{"type":43,"value":179},"\u003C!-- BAD -->\n",{"type":37,"tag":170,"props":181,"children":183},{"class":172,"line":182},2,[184],{"type":37,"tag":170,"props":185,"children":186},{},[187],{"type":43,"value":188},"\u003CTarget Name=\"PrepareOutput\">\n",{"type":37,"tag":170,"props":190,"children":192},{"class":172,"line":191},3,[193],{"type":37,"tag":170,"props":194,"children":195},{},[196],{"type":43,"value":197},"  \u003CExec Command=\"mkdir $(OutputPath)logs\" \u002F>\n",{"type":37,"tag":170,"props":199,"children":201},{"class":172,"line":200},4,[202],{"type":37,"tag":170,"props":203,"children":204},{},[205],{"type":43,"value":206},"  \u003CExec Command=\"copy config.json $(OutputPath)\" \u002F>\n",{"type":37,"tag":170,"props":208,"children":210},{"class":172,"line":209},5,[211],{"type":37,"tag":170,"props":212,"children":213},{},[214],{"type":43,"value":215},"  \u003CExec Command=\"del $(IntermediateOutputPath)*.tmp\" \u002F>\n",{"type":37,"tag":170,"props":217,"children":219},{"class":172,"line":218},6,[220],{"type":37,"tag":170,"props":221,"children":222},{},[223],{"type":43,"value":224},"\u003C\u002FTarget>\n",{"type":37,"tag":170,"props":226,"children":228},{"class":172,"line":227},7,[229],{"type":37,"tag":170,"props":230,"children":232},{"emptyLinePlaceholder":231},true,[233],{"type":43,"value":234},"\n",{"type":37,"tag":170,"props":236,"children":238},{"class":172,"line":237},8,[239],{"type":37,"tag":170,"props":240,"children":241},{},[242],{"type":43,"value":243},"\u003C!-- GOOD -->\n",{"type":37,"tag":170,"props":245,"children":247},{"class":172,"line":246},9,[248],{"type":37,"tag":170,"props":249,"children":250},{},[251],{"type":43,"value":188},{"type":37,"tag":170,"props":253,"children":255},{"class":172,"line":254},10,[256],{"type":37,"tag":170,"props":257,"children":258},{},[259],{"type":43,"value":260},"  \u003CMakeDir Directories=\"$(OutputPath)logs\" \u002F>\n",{"type":37,"tag":170,"props":262,"children":264},{"class":172,"line":263},11,[265],{"type":37,"tag":170,"props":266,"children":267},{},[268],{"type":43,"value":269},"  \u003CCopy SourceFiles=\"config.json\" DestinationFolder=\"$(OutputPath)\" \u002F>\n",{"type":37,"tag":170,"props":271,"children":273},{"class":172,"line":272},12,[274],{"type":37,"tag":170,"props":275,"children":276},{},[277],{"type":43,"value":278},"  \u003CDelete Files=\"@(TempFiles)\" \u002F>\n",{"type":37,"tag":170,"props":280,"children":282},{"class":172,"line":281},13,[283],{"type":37,"tag":170,"props":284,"children":285},{},[286],{"type":43,"value":224},{"type":37,"tag":46,"props":288,"children":289},{},[290],{"type":37,"tag":60,"props":291,"children":292},{},[293],{"type":43,"value":294},"Built-in task alternatives:",{"type":37,"tag":296,"props":297,"children":298},"table",{},[299,318],{"type":37,"tag":300,"props":301,"children":302},"thead",{},[303],{"type":37,"tag":304,"props":305,"children":306},"tr",{},[307,313],{"type":37,"tag":308,"props":309,"children":310},"th",{},[311],{"type":43,"value":312},"Shell Command",{"type":37,"tag":308,"props":314,"children":315},{},[316],{"type":43,"value":317},"MSBuild Task",{"type":37,"tag":319,"props":320,"children":321},"tbody",{},[322,344,373,401,429,450,471],{"type":37,"tag":304,"props":323,"children":324},{},[325,335],{"type":37,"tag":326,"props":327,"children":328},"td",{},[329],{"type":37,"tag":104,"props":330,"children":332},{"className":331},[],[333],{"type":43,"value":334},"mkdir",{"type":37,"tag":326,"props":336,"children":337},{},[338],{"type":37,"tag":104,"props":339,"children":341},{"className":340},[],[342],{"type":43,"value":343},"\u003CMakeDir>",{"type":37,"tag":304,"props":345,"children":346},{},[347,364],{"type":37,"tag":326,"props":348,"children":349},{},[350,356,358],{"type":37,"tag":104,"props":351,"children":353},{"className":352},[],[354],{"type":43,"value":355},"copy",{"type":43,"value":357}," \u002F ",{"type":37,"tag":104,"props":359,"children":361},{"className":360},[],[362],{"type":43,"value":363},"cp",{"type":37,"tag":326,"props":365,"children":366},{},[367],{"type":37,"tag":104,"props":368,"children":370},{"className":369},[],[371],{"type":43,"value":372},"\u003CCopy>",{"type":37,"tag":304,"props":374,"children":375},{},[376,392],{"type":37,"tag":326,"props":377,"children":378},{},[379,385,386],{"type":37,"tag":104,"props":380,"children":382},{"className":381},[],[383],{"type":43,"value":384},"del",{"type":43,"value":357},{"type":37,"tag":104,"props":387,"children":389},{"className":388},[],[390],{"type":43,"value":391},"rm",{"type":37,"tag":326,"props":393,"children":394},{},[395],{"type":37,"tag":104,"props":396,"children":398},{"className":397},[],[399],{"type":43,"value":400},"\u003CDelete>",{"type":37,"tag":304,"props":402,"children":403},{},[404,420],{"type":37,"tag":326,"props":405,"children":406},{},[407,413,414],{"type":37,"tag":104,"props":408,"children":410},{"className":409},[],[411],{"type":43,"value":412},"move",{"type":43,"value":357},{"type":37,"tag":104,"props":415,"children":417},{"className":416},[],[418],{"type":43,"value":419},"mv",{"type":37,"tag":326,"props":421,"children":422},{},[423],{"type":37,"tag":104,"props":424,"children":426},{"className":425},[],[427],{"type":43,"value":428},"\u003CMove>",{"type":37,"tag":304,"props":430,"children":431},{},[432,441],{"type":37,"tag":326,"props":433,"children":434},{},[435],{"type":37,"tag":104,"props":436,"children":438},{"className":437},[],[439],{"type":43,"value":440},"echo text > file",{"type":37,"tag":326,"props":442,"children":443},{},[444],{"type":37,"tag":104,"props":445,"children":447},{"className":446},[],[448],{"type":43,"value":449},"\u003CWriteLinesToFile>",{"type":37,"tag":304,"props":451,"children":452},{},[453,462],{"type":37,"tag":326,"props":454,"children":455},{},[456],{"type":37,"tag":104,"props":457,"children":459},{"className":458},[],[460],{"type":43,"value":461},"touch",{"type":37,"tag":326,"props":463,"children":464},{},[465],{"type":37,"tag":104,"props":466,"children":468},{"className":467},[],[469],{"type":43,"value":470},"\u003CTouch>",{"type":37,"tag":304,"props":472,"children":473},{},[474,483],{"type":37,"tag":326,"props":475,"children":476},{},[477],{"type":37,"tag":104,"props":478,"children":480},{"className":479},[],[481],{"type":43,"value":482},"xcopy \u002Fs",{"type":37,"tag":326,"props":484,"children":485},{},[486,491],{"type":37,"tag":104,"props":487,"children":489},{"className":488},[],[490],{"type":43,"value":372},{"type":43,"value":492}," with item globs",{"type":37,"tag":93,"props":494,"children":495},{},[],{"type":37,"tag":97,"props":497,"children":499},{"id":498},"ap-02-unquoted-condition-expressions",[500],{"type":43,"value":501},"AP-02: Unquoted Condition Expressions",{"type":37,"tag":46,"props":503,"children":504},{},[505,509,510,516],{"type":37,"tag":60,"props":506,"children":507},{},[508],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":511,"children":513},{"className":512},[],[514],{"type":43,"value":515},"Condition=\"$(Foo) == Bar\"",{"type":43,"value":517}," — either side of a comparison is unquoted.",{"type":37,"tag":46,"props":519,"children":520},{},[521,525],{"type":37,"tag":60,"props":522,"children":523},{},[524],{"type":43,"value":74},{"type":43,"value":526},": If the property is empty or contains spaces\u002Fspecial characters, the condition evaluates incorrectly or throws a parse error. MSBuild requires single-quoted strings for reliable comparisons.",{"type":37,"tag":159,"props":528,"children":530},{"className":161,"code":529,"language":163,"meta":164,"style":164},"\u003C!-- BAD -->\n\u003CPropertyGroup Condition=\"$(Configuration) == Release\">\n  \u003COptimize>true\u003C\u002FOptimize>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD -->\n\u003CPropertyGroup Condition=\"'$(Configuration)' == 'Release'\">\n  \u003COptimize>true\u003C\u002FOptimize>\n\u003C\u002FPropertyGroup>\n",[531],{"type":37,"tag":104,"props":532,"children":533},{"__ignoreMap":164},[534,541,549,557,565,572,579,587,594],{"type":37,"tag":170,"props":535,"children":536},{"class":172,"line":173},[537],{"type":37,"tag":170,"props":538,"children":539},{},[540],{"type":43,"value":179},{"type":37,"tag":170,"props":542,"children":543},{"class":172,"line":182},[544],{"type":37,"tag":170,"props":545,"children":546},{},[547],{"type":43,"value":548},"\u003CPropertyGroup Condition=\"$(Configuration) == Release\">\n",{"type":37,"tag":170,"props":550,"children":551},{"class":172,"line":191},[552],{"type":37,"tag":170,"props":553,"children":554},{},[555],{"type":43,"value":556},"  \u003COptimize>true\u003C\u002FOptimize>\n",{"type":37,"tag":170,"props":558,"children":559},{"class":172,"line":200},[560],{"type":37,"tag":170,"props":561,"children":562},{},[563],{"type":43,"value":564},"\u003C\u002FPropertyGroup>\n",{"type":37,"tag":170,"props":566,"children":567},{"class":172,"line":209},[568],{"type":37,"tag":170,"props":569,"children":570},{"emptyLinePlaceholder":231},[571],{"type":43,"value":234},{"type":37,"tag":170,"props":573,"children":574},{"class":172,"line":218},[575],{"type":37,"tag":170,"props":576,"children":577},{},[578],{"type":43,"value":243},{"type":37,"tag":170,"props":580,"children":581},{"class":172,"line":227},[582],{"type":37,"tag":170,"props":583,"children":584},{},[585],{"type":43,"value":586},"\u003CPropertyGroup Condition=\"'$(Configuration)' == 'Release'\">\n",{"type":37,"tag":170,"props":588,"children":589},{"class":172,"line":237},[590],{"type":37,"tag":170,"props":591,"children":592},{},[593],{"type":43,"value":556},{"type":37,"tag":170,"props":595,"children":596},{"class":172,"line":246},[597],{"type":37,"tag":170,"props":598,"children":599},{},[600],{"type":43,"value":564},{"type":37,"tag":46,"props":602,"children":603},{},[604,609,611,616,618,624,626,632],{"type":37,"tag":60,"props":605,"children":606},{},[607],{"type":43,"value":608},"Rule",{"type":43,"value":610},": Always quote ",{"type":37,"tag":60,"props":612,"children":613},{},[614],{"type":43,"value":615},"both",{"type":43,"value":617}," sides of ",{"type":37,"tag":104,"props":619,"children":621},{"className":620},[],[622],{"type":43,"value":623},"==",{"type":43,"value":625}," and ",{"type":37,"tag":104,"props":627,"children":629},{"className":628},[],[630],{"type":43,"value":631},"!=",{"type":43,"value":633}," comparisons with single quotes.",{"type":37,"tag":93,"props":635,"children":636},{},[],{"type":37,"tag":97,"props":638,"children":640},{"id":639},"ap-03-hardcoded-absolute-paths",[641],{"type":43,"value":642},"AP-03: Hardcoded Absolute Paths",{"type":37,"tag":46,"props":644,"children":645},{},[646,650,652,658,659,665,666,672],{"type":37,"tag":60,"props":647,"children":648},{},[649],{"type":43,"value":64},{"type":43,"value":651},": Paths like ",{"type":37,"tag":104,"props":653,"children":655},{"className":654},[],[656],{"type":43,"value":657},"C:\\tools\\",{"type":43,"value":128},{"type":37,"tag":104,"props":660,"children":662},{"className":661},[],[663],{"type":43,"value":664},"D:\\packages\\",{"type":43,"value":128},{"type":37,"tag":104,"props":667,"children":669},{"className":668},[],[670],{"type":43,"value":671},"\u002Fusr\u002Flocal\u002Fbin\u002F",{"type":43,"value":673}," in project files.",{"type":37,"tag":46,"props":675,"children":676},{},[677,681],{"type":37,"tag":60,"props":678,"children":679},{},[680],{"type":43,"value":74},{"type":43,"value":682},": Breaks on other machines, CI environments, and other operating systems. Not relocatable.",{"type":37,"tag":159,"props":684,"children":686},{"className":161,"code":685,"language":163,"meta":164,"style":164},"\u003C!-- BAD -->\n\u003CPropertyGroup>\n  \u003CToolPath>C:\\tools\\mytool\\mytool.exe\u003C\u002FToolPath>\n\u003C\u002FPropertyGroup>\n\u003CImport Project=\"C:\\repos\\shared\\common.props\" \u002F>\n\n\u003C!-- GOOD -->\n\u003CPropertyGroup>\n  \u003CToolPath>$(MSBuildThisFileDirectory)tools\\mytool\\mytool.exe\u003C\u002FToolPath>\n\u003C\u002FPropertyGroup>\n\u003CImport Project=\"$(RepoRoot)eng\\common.props\" \u002F>\n",[687],{"type":37,"tag":104,"props":688,"children":689},{"__ignoreMap":164},[690,697,705,713,720,728,735,742,749,757,764],{"type":37,"tag":170,"props":691,"children":692},{"class":172,"line":173},[693],{"type":37,"tag":170,"props":694,"children":695},{},[696],{"type":43,"value":179},{"type":37,"tag":170,"props":698,"children":699},{"class":172,"line":182},[700],{"type":37,"tag":170,"props":701,"children":702},{},[703],{"type":43,"value":704},"\u003CPropertyGroup>\n",{"type":37,"tag":170,"props":706,"children":707},{"class":172,"line":191},[708],{"type":37,"tag":170,"props":709,"children":710},{},[711],{"type":43,"value":712},"  \u003CToolPath>C:\\tools\\mytool\\mytool.exe\u003C\u002FToolPath>\n",{"type":37,"tag":170,"props":714,"children":715},{"class":172,"line":200},[716],{"type":37,"tag":170,"props":717,"children":718},{},[719],{"type":43,"value":564},{"type":37,"tag":170,"props":721,"children":722},{"class":172,"line":209},[723],{"type":37,"tag":170,"props":724,"children":725},{},[726],{"type":43,"value":727},"\u003CImport Project=\"C:\\repos\\shared\\common.props\" \u002F>\n",{"type":37,"tag":170,"props":729,"children":730},{"class":172,"line":218},[731],{"type":37,"tag":170,"props":732,"children":733},{"emptyLinePlaceholder":231},[734],{"type":43,"value":234},{"type":37,"tag":170,"props":736,"children":737},{"class":172,"line":227},[738],{"type":37,"tag":170,"props":739,"children":740},{},[741],{"type":43,"value":243},{"type":37,"tag":170,"props":743,"children":744},{"class":172,"line":237},[745],{"type":37,"tag":170,"props":746,"children":747},{},[748],{"type":43,"value":704},{"type":37,"tag":170,"props":750,"children":751},{"class":172,"line":246},[752],{"type":37,"tag":170,"props":753,"children":754},{},[755],{"type":43,"value":756},"  \u003CToolPath>$(MSBuildThisFileDirectory)tools\\mytool\\mytool.exe\u003C\u002FToolPath>\n",{"type":37,"tag":170,"props":758,"children":759},{"class":172,"line":254},[760],{"type":37,"tag":170,"props":761,"children":762},{},[763],{"type":43,"value":564},{"type":37,"tag":170,"props":765,"children":766},{"class":172,"line":263},[767],{"type":37,"tag":170,"props":768,"children":769},{},[770],{"type":43,"value":771},"\u003CImport Project=\"$(RepoRoot)eng\\common.props\" \u002F>\n",{"type":37,"tag":46,"props":773,"children":774},{},[775],{"type":37,"tag":60,"props":776,"children":777},{},[778],{"type":43,"value":779},"Preferred path properties:",{"type":37,"tag":296,"props":781,"children":782},{},[783,799],{"type":37,"tag":300,"props":784,"children":785},{},[786],{"type":37,"tag":304,"props":787,"children":788},{},[789,794],{"type":37,"tag":308,"props":790,"children":791},{},[792],{"type":43,"value":793},"Property",{"type":37,"tag":308,"props":795,"children":796},{},[797],{"type":43,"value":798},"Meaning",{"type":37,"tag":319,"props":800,"children":801},{},[802,819,836,853],{"type":37,"tag":304,"props":803,"children":804},{},[805,814],{"type":37,"tag":326,"props":806,"children":807},{},[808],{"type":37,"tag":104,"props":809,"children":811},{"className":810},[],[812],{"type":43,"value":813},"$(MSBuildThisFileDirectory)",{"type":37,"tag":326,"props":815,"children":816},{},[817],{"type":43,"value":818},"Directory of the current .props\u002F.targets file",{"type":37,"tag":304,"props":820,"children":821},{},[822,831],{"type":37,"tag":326,"props":823,"children":824},{},[825],{"type":37,"tag":104,"props":826,"children":828},{"className":827},[],[829],{"type":43,"value":830},"$(MSBuildProjectDirectory)",{"type":37,"tag":326,"props":832,"children":833},{},[834],{"type":43,"value":835},"Directory of the .csproj",{"type":37,"tag":304,"props":837,"children":838},{},[839,848],{"type":37,"tag":326,"props":840,"children":841},{},[842],{"type":37,"tag":104,"props":843,"children":845},{"className":844},[],[846],{"type":43,"value":847},"$([MSBuild]::GetDirectoryNameOfFileAbove(...))",{"type":37,"tag":326,"props":849,"children":850},{},[851],{"type":43,"value":852},"Walk up to find a marker file",{"type":37,"tag":304,"props":854,"children":855},{},[856,865],{"type":37,"tag":326,"props":857,"children":858},{},[859],{"type":37,"tag":104,"props":860,"children":862},{"className":861},[],[863],{"type":43,"value":864},"$([MSBuild]::NormalizePath(...))",{"type":37,"tag":326,"props":866,"children":867},{},[868],{"type":43,"value":869},"Combine and normalize path segments",{"type":37,"tag":93,"props":871,"children":872},{},[],{"type":37,"tag":97,"props":874,"children":876},{"id":875},"ap-04-restating-sdk-defaults",[877],{"type":43,"value":878},"AP-04: Restating SDK Defaults",{"type":37,"tag":46,"props":880,"children":881},{},[882,886],{"type":37,"tag":60,"props":883,"children":884},{},[885],{"type":43,"value":64},{"type":43,"value":887},": Properties set to values that the .NET SDK already provides by default.",{"type":37,"tag":46,"props":889,"children":890},{},[891,895],{"type":37,"tag":60,"props":892,"children":893},{},[894],{"type":43,"value":74},{"type":43,"value":896},": Adds noise, hides intentional overrides, and makes it harder to identify what's actually customized. When defaults change in newer SDKs, the redundant properties may silently pin old behavior.",{"type":37,"tag":159,"props":898,"children":900},{"className":161,"code":899,"language":163,"meta":164,"style":164},"\u003C!-- BAD: All of these are already the default -->\n\u003CPropertyGroup>\n  \u003COutputType>Library\u003C\u002FOutputType>\n  \u003CEnableDefaultItems>true\u003C\u002FEnableDefaultItems>\n  \u003CEnableDefaultCompileItems>true\u003C\u002FEnableDefaultCompileItems>\n  \u003CRootNamespace>MyLib\u003C\u002FRootNamespace>       \u003C!-- matches project name -->\n  \u003CAssemblyName>MyLib\u003C\u002FAssemblyName>         \u003C!-- matches project name -->\n  \u003CAppendTargetFrameworkToOutputPath>true\u003C\u002FAppendTargetFrameworkToOutputPath>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD: Only non-default values -->\n\u003CPropertyGroup>\n  \u003CTargetFramework>net8.0\u003C\u002FTargetFramework>\n\u003C\u002FPropertyGroup>\n",[901],{"type":37,"tag":104,"props":902,"children":903},{"__ignoreMap":164},[904,912,919,927,935,943,951,959,967,974,981,989,996,1004],{"type":37,"tag":170,"props":905,"children":906},{"class":172,"line":173},[907],{"type":37,"tag":170,"props":908,"children":909},{},[910],{"type":43,"value":911},"\u003C!-- BAD: All of these are already the default -->\n",{"type":37,"tag":170,"props":913,"children":914},{"class":172,"line":182},[915],{"type":37,"tag":170,"props":916,"children":917},{},[918],{"type":43,"value":704},{"type":37,"tag":170,"props":920,"children":921},{"class":172,"line":191},[922],{"type":37,"tag":170,"props":923,"children":924},{},[925],{"type":43,"value":926},"  \u003COutputType>Library\u003C\u002FOutputType>\n",{"type":37,"tag":170,"props":928,"children":929},{"class":172,"line":200},[930],{"type":37,"tag":170,"props":931,"children":932},{},[933],{"type":43,"value":934},"  \u003CEnableDefaultItems>true\u003C\u002FEnableDefaultItems>\n",{"type":37,"tag":170,"props":936,"children":937},{"class":172,"line":209},[938],{"type":37,"tag":170,"props":939,"children":940},{},[941],{"type":43,"value":942},"  \u003CEnableDefaultCompileItems>true\u003C\u002FEnableDefaultCompileItems>\n",{"type":37,"tag":170,"props":944,"children":945},{"class":172,"line":218},[946],{"type":37,"tag":170,"props":947,"children":948},{},[949],{"type":43,"value":950},"  \u003CRootNamespace>MyLib\u003C\u002FRootNamespace>       \u003C!-- matches project name -->\n",{"type":37,"tag":170,"props":952,"children":953},{"class":172,"line":227},[954],{"type":37,"tag":170,"props":955,"children":956},{},[957],{"type":43,"value":958},"  \u003CAssemblyName>MyLib\u003C\u002FAssemblyName>         \u003C!-- matches project name -->\n",{"type":37,"tag":170,"props":960,"children":961},{"class":172,"line":237},[962],{"type":37,"tag":170,"props":963,"children":964},{},[965],{"type":43,"value":966},"  \u003CAppendTargetFrameworkToOutputPath>true\u003C\u002FAppendTargetFrameworkToOutputPath>\n",{"type":37,"tag":170,"props":968,"children":969},{"class":172,"line":246},[970],{"type":37,"tag":170,"props":971,"children":972},{},[973],{"type":43,"value":564},{"type":37,"tag":170,"props":975,"children":976},{"class":172,"line":254},[977],{"type":37,"tag":170,"props":978,"children":979},{"emptyLinePlaceholder":231},[980],{"type":43,"value":234},{"type":37,"tag":170,"props":982,"children":983},{"class":172,"line":263},[984],{"type":37,"tag":170,"props":985,"children":986},{},[987],{"type":43,"value":988},"\u003C!-- GOOD: Only non-default values -->\n",{"type":37,"tag":170,"props":990,"children":991},{"class":172,"line":272},[992],{"type":37,"tag":170,"props":993,"children":994},{},[995],{"type":43,"value":704},{"type":37,"tag":170,"props":997,"children":998},{"class":172,"line":281},[999],{"type":37,"tag":170,"props":1000,"children":1001},{},[1002],{"type":43,"value":1003},"  \u003CTargetFramework>net8.0\u003C\u002FTargetFramework>\n",{"type":37,"tag":170,"props":1005,"children":1007},{"class":172,"line":1006},14,[1008],{"type":37,"tag":170,"props":1009,"children":1010},{},[1011],{"type":43,"value":564},{"type":37,"tag":93,"props":1013,"children":1014},{},[],{"type":37,"tag":97,"props":1016,"children":1018},{"id":1017},"ap-05-manual-file-listing-in-sdk-style-projects",[1019],{"type":43,"value":1020},"AP-05: Manual File Listing in SDK-Style Projects",{"type":37,"tag":46,"props":1022,"children":1023},{},[1024,1028,1029,1035,1036,1042],{"type":37,"tag":60,"props":1025,"children":1026},{},[1027],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":1030,"children":1032},{"className":1031},[],[1033],{"type":43,"value":1034},"\u003CCompile Include=\"File1.cs\" \u002F>",{"type":43,"value":128},{"type":37,"tag":104,"props":1037,"children":1039},{"className":1038},[],[1040],{"type":43,"value":1041},"\u003CCompile Include=\"File2.cs\" \u002F>",{"type":43,"value":1043}," in SDK-style projects.",{"type":37,"tag":46,"props":1045,"children":1046},{},[1047,1051,1053,1059],{"type":37,"tag":60,"props":1048,"children":1049},{},[1050],{"type":43,"value":74},{"type":43,"value":1052},": SDK-style projects automatically glob ",{"type":37,"tag":104,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":43,"value":1058},"**\u002F*.cs",{"type":43,"value":1060}," (and other file types). Explicit listing is redundant, creates merge conflicts, and new files may be accidentally missed if not added to the list.",{"type":37,"tag":159,"props":1062,"children":1064},{"className":161,"code":1063,"language":163,"meta":164,"style":164},"\u003C!-- BAD -->\n\u003CItemGroup>\n  \u003CCompile Include=\"Program.cs\" \u002F>\n  \u003CCompile Include=\"Services\\MyService.cs\" \u002F>\n  \u003CCompile Include=\"Models\\User.cs\" \u002F>\n\u003C\u002FItemGroup>\n\n\u003C!-- GOOD: Remove entirely — SDK includes all .cs files by default.\n     Only use Remove\u002FExclude when you need to opt out: -->\n\u003CItemGroup>\n  \u003CCompile Remove=\"LegacyCode\\**\" \u002F>\n\u003C\u002FItemGroup>\n",[1065],{"type":37,"tag":104,"props":1066,"children":1067},{"__ignoreMap":164},[1068,1075,1083,1091,1099,1107,1115,1122,1130,1138,1145,1153],{"type":37,"tag":170,"props":1069,"children":1070},{"class":172,"line":173},[1071],{"type":37,"tag":170,"props":1072,"children":1073},{},[1074],{"type":43,"value":179},{"type":37,"tag":170,"props":1076,"children":1077},{"class":172,"line":182},[1078],{"type":37,"tag":170,"props":1079,"children":1080},{},[1081],{"type":43,"value":1082},"\u003CItemGroup>\n",{"type":37,"tag":170,"props":1084,"children":1085},{"class":172,"line":191},[1086],{"type":37,"tag":170,"props":1087,"children":1088},{},[1089],{"type":43,"value":1090},"  \u003CCompile Include=\"Program.cs\" \u002F>\n",{"type":37,"tag":170,"props":1092,"children":1093},{"class":172,"line":200},[1094],{"type":37,"tag":170,"props":1095,"children":1096},{},[1097],{"type":43,"value":1098},"  \u003CCompile Include=\"Services\\MyService.cs\" \u002F>\n",{"type":37,"tag":170,"props":1100,"children":1101},{"class":172,"line":209},[1102],{"type":37,"tag":170,"props":1103,"children":1104},{},[1105],{"type":43,"value":1106},"  \u003CCompile Include=\"Models\\User.cs\" \u002F>\n",{"type":37,"tag":170,"props":1108,"children":1109},{"class":172,"line":218},[1110],{"type":37,"tag":170,"props":1111,"children":1112},{},[1113],{"type":43,"value":1114},"\u003C\u002FItemGroup>\n",{"type":37,"tag":170,"props":1116,"children":1117},{"class":172,"line":227},[1118],{"type":37,"tag":170,"props":1119,"children":1120},{"emptyLinePlaceholder":231},[1121],{"type":43,"value":234},{"type":37,"tag":170,"props":1123,"children":1124},{"class":172,"line":237},[1125],{"type":37,"tag":170,"props":1126,"children":1127},{},[1128],{"type":43,"value":1129},"\u003C!-- GOOD: Remove entirely — SDK includes all .cs files by default.\n",{"type":37,"tag":170,"props":1131,"children":1132},{"class":172,"line":246},[1133],{"type":37,"tag":170,"props":1134,"children":1135},{},[1136],{"type":43,"value":1137},"     Only use Remove\u002FExclude when you need to opt out: -->\n",{"type":37,"tag":170,"props":1139,"children":1140},{"class":172,"line":254},[1141],{"type":37,"tag":170,"props":1142,"children":1143},{},[1144],{"type":43,"value":1082},{"type":37,"tag":170,"props":1146,"children":1147},{"class":172,"line":263},[1148],{"type":37,"tag":170,"props":1149,"children":1150},{},[1151],{"type":43,"value":1152},"  \u003CCompile Remove=\"LegacyCode\\**\" \u002F>\n",{"type":37,"tag":170,"props":1154,"children":1155},{"class":172,"line":272},[1156],{"type":37,"tag":170,"props":1157,"children":1158},{},[1159],{"type":43,"value":1114},{"type":37,"tag":46,"props":1161,"children":1162},{},[1163,1168,1170,1176],{"type":37,"tag":60,"props":1164,"children":1165},{},[1166],{"type":43,"value":1167},"Exception",{"type":43,"value":1169},": Non-SDK-style (legacy) projects require explicit file includes. If migrating, see ",{"type":37,"tag":104,"props":1171,"children":1173},{"className":1172},[],[1174],{"type":43,"value":1175},"msbuild-modernization",{"type":43,"value":1177}," skill.",{"type":37,"tag":46,"props":1179,"children":1180},{},[1181,1194,1196,1202,1204,1209,1211,1217,1219,1225,1227,1232,1234,1240],{"type":37,"tag":60,"props":1182,"children":1183},{},[1184,1186,1192],{"type":43,"value":1185},"Exception (F# \u002F ",{"type":37,"tag":104,"props":1187,"children":1189},{"className":1188},[],[1190],{"type":43,"value":1191},".fsproj",{"type":43,"value":1193},")",{"type":43,"value":1195},": F# compilation is order-dependent — the compiler processes ",{"type":37,"tag":104,"props":1197,"children":1199},{"className":1198},[],[1200],{"type":43,"value":1201},"\u003CCompile Include>",{"type":43,"value":1203}," items sequentially and a file can only reference types\u002Fmodules declared in files listed above it. ",{"type":37,"tag":104,"props":1205,"children":1207},{"className":1206},[],[1208],{"type":43,"value":1191},{"type":43,"value":1210}," files must therefore list every source file explicitly, in dependency order (utility\u002Fleaf modules at the top, the entry point such as ",{"type":37,"tag":104,"props":1212,"children":1214},{"className":1213},[],[1215],{"type":43,"value":1216},"Program.fs",{"type":43,"value":1218}," at the bottom). If a ",{"type":37,"tag":104,"props":1220,"children":1222},{"className":1221},[],[1223],{"type":43,"value":1224},".fsi",{"type":43,"value":1226}," signature file is used, it must appear ",{"type":37,"tag":60,"props":1228,"children":1229},{},[1230],{"type":43,"value":1231},"immediately before",{"type":43,"value":1233}," its companion ",{"type":37,"tag":104,"props":1235,"children":1237},{"className":1236},[],[1238],{"type":43,"value":1239},".fs",{"type":43,"value":1241}," implementation file.",{"type":37,"tag":93,"props":1243,"children":1244},{},[],{"type":37,"tag":97,"props":1246,"children":1248},{"id":1247},"ap-06-using-reference-with-hintpath-for-nuget-packages",[1249,1251,1257],{"type":43,"value":1250},"AP-06: Using ",{"type":37,"tag":104,"props":1252,"children":1254},{"className":1253},[],[1255],{"type":43,"value":1256},"\u003CReference>",{"type":43,"value":1258}," with HintPath for NuGet Packages",{"type":37,"tag":46,"props":1260,"children":1261},{},[1262,1266,1267],{"type":37,"tag":60,"props":1263,"children":1264},{},[1265],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":1268,"children":1270},{"className":1269},[],[1271],{"type":43,"value":1272},"\u003CReference Include=\"...\" HintPath=\"..\\packages\\SomePackage\\lib\\...\" \u002F>",{"type":37,"tag":46,"props":1274,"children":1275},{},[1276,1280,1282,1288,1290,1296],{"type":37,"tag":60,"props":1277,"children":1278},{},[1279],{"type":43,"value":74},{"type":43,"value":1281},": This is the legacy ",{"type":37,"tag":104,"props":1283,"children":1285},{"className":1284},[],[1286],{"type":43,"value":1287},"packages.config",{"type":43,"value":1289}," pattern. It doesn't support transitive dependencies, version conflict resolution, or automatic restore. The ",{"type":37,"tag":104,"props":1291,"children":1293},{"className":1292},[],[1294],{"type":43,"value":1295},"packages\u002F",{"type":43,"value":1297}," folder must be committed or restored separately.",{"type":37,"tag":159,"props":1299,"children":1301},{"className":161,"code":1300,"language":163,"meta":164,"style":164},"\u003C!-- BAD -->\n\u003CItemGroup>\n  \u003CReference Include=\"Newtonsoft.Json\">\n    \u003CHintPath>..\\packages\\Newtonsoft.Json.13.0.3\\lib\\netstandard2.0\\Newtonsoft.Json.dll\u003C\u002FHintPath>\n  \u003C\u002FReference>\n\u003C\u002FItemGroup>\n\n\u003C!-- GOOD -->\n\u003CItemGroup>\n  \u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.3\" \u002F>\n\u003C\u002FItemGroup>\n",[1302],{"type":37,"tag":104,"props":1303,"children":1304},{"__ignoreMap":164},[1305,1312,1319,1327,1335,1343,1350,1357,1364,1371,1379],{"type":37,"tag":170,"props":1306,"children":1307},{"class":172,"line":173},[1308],{"type":37,"tag":170,"props":1309,"children":1310},{},[1311],{"type":43,"value":179},{"type":37,"tag":170,"props":1313,"children":1314},{"class":172,"line":182},[1315],{"type":37,"tag":170,"props":1316,"children":1317},{},[1318],{"type":43,"value":1082},{"type":37,"tag":170,"props":1320,"children":1321},{"class":172,"line":191},[1322],{"type":37,"tag":170,"props":1323,"children":1324},{},[1325],{"type":43,"value":1326},"  \u003CReference Include=\"Newtonsoft.Json\">\n",{"type":37,"tag":170,"props":1328,"children":1329},{"class":172,"line":200},[1330],{"type":37,"tag":170,"props":1331,"children":1332},{},[1333],{"type":43,"value":1334},"    \u003CHintPath>..\\packages\\Newtonsoft.Json.13.0.3\\lib\\netstandard2.0\\Newtonsoft.Json.dll\u003C\u002FHintPath>\n",{"type":37,"tag":170,"props":1336,"children":1337},{"class":172,"line":209},[1338],{"type":37,"tag":170,"props":1339,"children":1340},{},[1341],{"type":43,"value":1342},"  \u003C\u002FReference>\n",{"type":37,"tag":170,"props":1344,"children":1345},{"class":172,"line":218},[1346],{"type":37,"tag":170,"props":1347,"children":1348},{},[1349],{"type":43,"value":1114},{"type":37,"tag":170,"props":1351,"children":1352},{"class":172,"line":227},[1353],{"type":37,"tag":170,"props":1354,"children":1355},{"emptyLinePlaceholder":231},[1356],{"type":43,"value":234},{"type":37,"tag":170,"props":1358,"children":1359},{"class":172,"line":237},[1360],{"type":37,"tag":170,"props":1361,"children":1362},{},[1363],{"type":43,"value":243},{"type":37,"tag":170,"props":1365,"children":1366},{"class":172,"line":246},[1367],{"type":37,"tag":170,"props":1368,"children":1369},{},[1370],{"type":43,"value":1082},{"type":37,"tag":170,"props":1372,"children":1373},{"class":172,"line":254},[1374],{"type":37,"tag":170,"props":1375,"children":1376},{},[1377],{"type":43,"value":1378},"  \u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.3\" \u002F>\n",{"type":37,"tag":170,"props":1380,"children":1381},{"class":172,"line":263},[1382],{"type":37,"tag":170,"props":1383,"children":1384},{},[1385],{"type":43,"value":1114},{"type":37,"tag":46,"props":1387,"children":1388},{},[1389,1394,1395,1400,1402,1408,1409,1415],{"type":37,"tag":60,"props":1390,"children":1391},{},[1392],{"type":43,"value":1393},"Note",{"type":43,"value":120},{"type":37,"tag":104,"props":1396,"children":1398},{"className":1397},[],[1399],{"type":43,"value":1256},{"type":43,"value":1401}," without HintPath is still valid for .NET Framework GAC assemblies like ",{"type":37,"tag":104,"props":1403,"children":1405},{"className":1404},[],[1406],{"type":43,"value":1407},"WindowsBase",{"type":43,"value":128},{"type":37,"tag":104,"props":1410,"children":1412},{"className":1411},[],[1413],{"type":43,"value":1414},"PresentationCore",{"type":43,"value":1416},", etc.",{"type":37,"tag":93,"props":1418,"children":1419},{},[],{"type":37,"tag":97,"props":1421,"children":1423},{"id":1422},"ap-07-missing-privateassetsall-on-analyzertool-packages",[1424,1426,1432],{"type":43,"value":1425},"AP-07: Missing ",{"type":37,"tag":104,"props":1427,"children":1429},{"className":1428},[],[1430],{"type":43,"value":1431},"PrivateAssets=\"all\"",{"type":43,"value":1433}," on Analyzer\u002FTool Packages",{"type":37,"tag":46,"props":1435,"children":1436},{},[1437,1441,1442,1448,1450,1455],{"type":37,"tag":60,"props":1438,"children":1439},{},[1440],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":1443,"children":1445},{"className":1444},[],[1446],{"type":43,"value":1447},"\u003CPackageReference Include=\"StyleCop.Analyzers\" Version=\"...\" \u002F>",{"type":43,"value":1449}," without ",{"type":37,"tag":104,"props":1451,"children":1453},{"className":1452},[],[1454],{"type":43,"value":1431},{"type":43,"value":1456},".",{"type":37,"tag":46,"props":1458,"children":1459},{},[1460,1464,1466,1471],{"type":37,"tag":60,"props":1461,"children":1462},{},[1463],{"type":43,"value":74},{"type":43,"value":1465},": Without ",{"type":37,"tag":104,"props":1467,"children":1469},{"className":1468},[],[1470],{"type":43,"value":1431},{"type":43,"value":1472},", analyzer and build-tool packages flow as transitive dependencies to consumers of your library. Consumers get unwanted analyzers or build-time tools they didn't ask for.",{"type":37,"tag":46,"props":1474,"children":1475},{},[1476,1478,1488],{"type":43,"value":1477},"See ",{"type":37,"tag":1479,"props":1480,"children":1482},"a",{"href":1481},"references\u002Fprivate-assets.md",[1483],{"type":37,"tag":104,"props":1484,"children":1486},{"className":1485},[],[1487],{"type":43,"value":1481},{"type":43,"value":1489}," for BAD\u002FGOOD examples and the full list of packages that need this.",{"type":37,"tag":93,"props":1491,"children":1492},{},[],{"type":37,"tag":97,"props":1494,"children":1496},{"id":1495},"ap-08-copy-pasted-properties-across-multiple-csproj-files",[1497],{"type":43,"value":1498},"AP-08: Copy-Pasted Properties Across Multiple .csproj Files",{"type":37,"tag":46,"props":1500,"children":1501},{},[1502,1506,1508,1514],{"type":37,"tag":60,"props":1503,"children":1504},{},[1505],{"type":43,"value":64},{"type":43,"value":1507},": The same ",{"type":37,"tag":104,"props":1509,"children":1511},{"className":1510},[],[1512],{"type":43,"value":1513},"\u003CPropertyGroup>",{"type":43,"value":1515}," block appears in 3+ project files.",{"type":37,"tag":46,"props":1517,"children":1518},{},[1519,1523],{"type":37,"tag":60,"props":1520,"children":1521},{},[1522],{"type":43,"value":74},{"type":43,"value":1524},": Maintenance burden — a change must be made in every file. Inconsistencies creep in over time.",{"type":37,"tag":159,"props":1526,"children":1528},{"className":161,"code":1527,"language":163,"meta":164,"style":164},"\u003C!-- BAD: Repeated in every .csproj -->\n\u003C!-- ProjectA.csproj, ProjectB.csproj, ProjectC.csproj all have: -->\n\u003CPropertyGroup>\n  \u003CNullable>enable\u003C\u002FNullable>\n  \u003CTreatWarningsAsErrors>true\u003C\u002FTreatWarningsAsErrors>\n  \u003CImplicitUsings>enable\u003C\u002FImplicitUsings>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD: Define once in Directory.Build.props at the repo\u002Fsrc root -->\n\u003C!-- Directory.Build.props -->\n\u003CProject>\n  \u003CPropertyGroup>\n    \u003CNullable>enable\u003C\u002FNullable>\n    \u003CTreatWarningsAsErrors>true\u003C\u002FTreatWarningsAsErrors>\n    \u003CImplicitUsings>enable\u003C\u002FImplicitUsings>\n  \u003C\u002FPropertyGroup>\n\u003C\u002FProject>\n",[1529],{"type":37,"tag":104,"props":1530,"children":1531},{"__ignoreMap":164},[1532,1540,1548,1555,1563,1571,1579,1586,1593,1601,1609,1617,1625,1633,1641,1650,1659],{"type":37,"tag":170,"props":1533,"children":1534},{"class":172,"line":173},[1535],{"type":37,"tag":170,"props":1536,"children":1537},{},[1538],{"type":43,"value":1539},"\u003C!-- BAD: Repeated in every .csproj -->\n",{"type":37,"tag":170,"props":1541,"children":1542},{"class":172,"line":182},[1543],{"type":37,"tag":170,"props":1544,"children":1545},{},[1546],{"type":43,"value":1547},"\u003C!-- ProjectA.csproj, ProjectB.csproj, ProjectC.csproj all have: -->\n",{"type":37,"tag":170,"props":1549,"children":1550},{"class":172,"line":191},[1551],{"type":37,"tag":170,"props":1552,"children":1553},{},[1554],{"type":43,"value":704},{"type":37,"tag":170,"props":1556,"children":1557},{"class":172,"line":200},[1558],{"type":37,"tag":170,"props":1559,"children":1560},{},[1561],{"type":43,"value":1562},"  \u003CNullable>enable\u003C\u002FNullable>\n",{"type":37,"tag":170,"props":1564,"children":1565},{"class":172,"line":209},[1566],{"type":37,"tag":170,"props":1567,"children":1568},{},[1569],{"type":43,"value":1570},"  \u003CTreatWarningsAsErrors>true\u003C\u002FTreatWarningsAsErrors>\n",{"type":37,"tag":170,"props":1572,"children":1573},{"class":172,"line":218},[1574],{"type":37,"tag":170,"props":1575,"children":1576},{},[1577],{"type":43,"value":1578},"  \u003CImplicitUsings>enable\u003C\u002FImplicitUsings>\n",{"type":37,"tag":170,"props":1580,"children":1581},{"class":172,"line":227},[1582],{"type":37,"tag":170,"props":1583,"children":1584},{},[1585],{"type":43,"value":564},{"type":37,"tag":170,"props":1587,"children":1588},{"class":172,"line":237},[1589],{"type":37,"tag":170,"props":1590,"children":1591},{"emptyLinePlaceholder":231},[1592],{"type":43,"value":234},{"type":37,"tag":170,"props":1594,"children":1595},{"class":172,"line":246},[1596],{"type":37,"tag":170,"props":1597,"children":1598},{},[1599],{"type":43,"value":1600},"\u003C!-- GOOD: Define once in Directory.Build.props at the repo\u002Fsrc root -->\n",{"type":37,"tag":170,"props":1602,"children":1603},{"class":172,"line":254},[1604],{"type":37,"tag":170,"props":1605,"children":1606},{},[1607],{"type":43,"value":1608},"\u003C!-- Directory.Build.props -->\n",{"type":37,"tag":170,"props":1610,"children":1611},{"class":172,"line":263},[1612],{"type":37,"tag":170,"props":1613,"children":1614},{},[1615],{"type":43,"value":1616},"\u003CProject>\n",{"type":37,"tag":170,"props":1618,"children":1619},{"class":172,"line":272},[1620],{"type":37,"tag":170,"props":1621,"children":1622},{},[1623],{"type":43,"value":1624},"  \u003CPropertyGroup>\n",{"type":37,"tag":170,"props":1626,"children":1627},{"class":172,"line":281},[1628],{"type":37,"tag":170,"props":1629,"children":1630},{},[1631],{"type":43,"value":1632},"    \u003CNullable>enable\u003C\u002FNullable>\n",{"type":37,"tag":170,"props":1634,"children":1635},{"class":172,"line":1006},[1636],{"type":37,"tag":170,"props":1637,"children":1638},{},[1639],{"type":43,"value":1640},"    \u003CTreatWarningsAsErrors>true\u003C\u002FTreatWarningsAsErrors>\n",{"type":37,"tag":170,"props":1642,"children":1644},{"class":172,"line":1643},15,[1645],{"type":37,"tag":170,"props":1646,"children":1647},{},[1648],{"type":43,"value":1649},"    \u003CImplicitUsings>enable\u003C\u002FImplicitUsings>\n",{"type":37,"tag":170,"props":1651,"children":1653},{"class":172,"line":1652},16,[1654],{"type":37,"tag":170,"props":1655,"children":1656},{},[1657],{"type":43,"value":1658},"  \u003C\u002FPropertyGroup>\n",{"type":37,"tag":170,"props":1660,"children":1662},{"class":172,"line":1661},17,[1663],{"type":37,"tag":170,"props":1664,"children":1665},{},[1666],{"type":43,"value":1667},"\u003C\u002FProject>\n",{"type":37,"tag":46,"props":1669,"children":1670},{},[1671,1672,1678,1680,1686,1687,1693],{"type":43,"value":1477},{"type":37,"tag":104,"props":1673,"children":1675},{"className":1674},[],[1676],{"type":43,"value":1677},"directory-build-organization",{"type":43,"value":1679}," skill for full guidance on structuring ",{"type":37,"tag":104,"props":1681,"children":1683},{"className":1682},[],[1684],{"type":43,"value":1685},"Directory.Build.props",{"type":43,"value":357},{"type":37,"tag":104,"props":1688,"children":1690},{"className":1689},[],[1691],{"type":43,"value":1692},"Directory.Build.targets",{"type":43,"value":1456},{"type":37,"tag":93,"props":1695,"children":1696},{},[],{"type":37,"tag":97,"props":1698,"children":1700},{"id":1699},"ap-09-scattered-package-versions-without-central-package-management",[1701],{"type":43,"value":1702},"AP-09: Scattered Package Versions Without Central Package Management",{"type":37,"tag":46,"props":1704,"children":1705},{},[1706,1710,1711,1717],{"type":37,"tag":60,"props":1707,"children":1708},{},[1709],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":1712,"children":1714},{"className":1713},[],[1715],{"type":43,"value":1716},"\u003CPackageReference Include=\"X\" Version=\"1.2.3\" \u002F>",{"type":43,"value":1718}," with different versions of the same package across projects.",{"type":37,"tag":46,"props":1720,"children":1721},{},[1722,1726],{"type":37,"tag":60,"props":1723,"children":1724},{},[1725],{"type":43,"value":74},{"type":43,"value":1727},": Version drift — different projects use different versions of the same package, leading to runtime mismatches, unexpected behavior, or diamond dependency conflicts.",{"type":37,"tag":159,"props":1729,"children":1731},{"className":161,"code":1730,"language":163,"meta":164,"style":164},"\u003C!-- BAD: Version specified in each project, can drift -->\n\u003C!-- ProjectA.csproj -->\n\u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.1\" \u002F>\n\u003C!-- ProjectB.csproj -->\n\u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.3\" \u002F>\n",[1732],{"type":37,"tag":104,"props":1733,"children":1734},{"__ignoreMap":164},[1735,1743,1751,1759,1767],{"type":37,"tag":170,"props":1736,"children":1737},{"class":172,"line":173},[1738],{"type":37,"tag":170,"props":1739,"children":1740},{},[1741],{"type":43,"value":1742},"\u003C!-- BAD: Version specified in each project, can drift -->\n",{"type":37,"tag":170,"props":1744,"children":1745},{"class":172,"line":182},[1746],{"type":37,"tag":170,"props":1747,"children":1748},{},[1749],{"type":43,"value":1750},"\u003C!-- ProjectA.csproj -->\n",{"type":37,"tag":170,"props":1752,"children":1753},{"class":172,"line":191},[1754],{"type":37,"tag":170,"props":1755,"children":1756},{},[1757],{"type":43,"value":1758},"\u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.1\" \u002F>\n",{"type":37,"tag":170,"props":1760,"children":1761},{"class":172,"line":200},[1762],{"type":37,"tag":170,"props":1763,"children":1764},{},[1765],{"type":43,"value":1766},"\u003C!-- ProjectB.csproj -->\n",{"type":37,"tag":170,"props":1768,"children":1769},{"class":172,"line":209},[1770],{"type":37,"tag":170,"props":1771,"children":1772},{},[1773],{"type":43,"value":1774},"\u003CPackageReference Include=\"Newtonsoft.Json\" Version=\"13.0.3\" \u002F>\n",{"type":37,"tag":46,"props":1776,"children":1777},{},[1778,1783,1785,1792],{"type":37,"tag":60,"props":1779,"children":1780},{},[1781],{"type":43,"value":1782},"Fix:",{"type":43,"value":1784}," Use Central Package Management. See ",{"type":37,"tag":1479,"props":1786,"children":1790},{"href":1787,"rel":1788},"https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fnuget\u002Fconsume-packages\u002Fcentral-package-management",[1789],"nofollow",[1791],{"type":43,"value":1787},{"type":43,"value":1793}," for details.",{"type":37,"tag":93,"props":1795,"children":1796},{},[],{"type":37,"tag":97,"props":1798,"children":1800},{"id":1799},"ap-10-monolithic-targets-too-much-in-one-target",[1801],{"type":43,"value":1802},"AP-10: Monolithic Targets (Too Much in One Target)",{"type":37,"tag":46,"props":1804,"children":1805},{},[1806,1810,1812,1818],{"type":37,"tag":60,"props":1807,"children":1808},{},[1809],{"type":43,"value":64},{"type":43,"value":1811},": A single ",{"type":37,"tag":104,"props":1813,"children":1815},{"className":1814},[],[1816],{"type":43,"value":1817},"\u003CTarget>",{"type":43,"value":1819}," with 50+ lines doing multiple unrelated things.",{"type":37,"tag":46,"props":1821,"children":1822},{},[1823,1827],{"type":37,"tag":60,"props":1824,"children":1825},{},[1826],{"type":43,"value":74},{"type":43,"value":1828},": Can't skip individual steps via incremental build, hard to debug, hard to extend, and the target name becomes meaningless.",{"type":37,"tag":159,"props":1830,"children":1832},{"className":161,"code":1831,"language":163,"meta":164,"style":164},"\u003C!-- BAD -->\n\u003CTarget Name=\"PrepareRelease\" BeforeTargets=\"Build\">\n  \u003CWriteLinesToFile File=\"version.txt\" Lines=\"$(Version)\" Overwrite=\"true\" \u002F>\n  \u003CCopy SourceFiles=\"LICENSE\" DestinationFolder=\"$(OutputPath)\" \u002F>\n  \u003CExec Command=\"signtool sign \u002Ff cert.pfx $(OutputPath)*.dll\" \u002F>\n  \u003CMakeDir Directories=\"$(OutputPath)docs\" \u002F>\n  \u003CCopy SourceFiles=\"@(DocFiles)\" DestinationFolder=\"$(OutputPath)docs\" \u002F>\n  \u003C!-- ... 30 more lines ... -->\n\u003C\u002FTarget>\n\n\u003C!-- GOOD: Single-responsibility targets -->\n\u003CTarget Name=\"WriteVersionFile\" BeforeTargets=\"CoreCompile\"\n        Inputs=\"$(MSBuildProjectFile)\" Outputs=\"$(IntermediateOutputPath)version.txt\">\n  \u003CWriteLinesToFile File=\"$(IntermediateOutputPath)version.txt\" Lines=\"$(Version)\" Overwrite=\"true\" \u002F>\n\u003C\u002FTarget>\n\n\u003CTarget Name=\"CopyLicense\" AfterTargets=\"Build\">\n  \u003CCopy SourceFiles=\"LICENSE\" DestinationFolder=\"$(OutputPath)\" SkipUnchangedFiles=\"true\" \u002F>\n\u003C\u002FTarget>\n\n\u003CTarget Name=\"SignAssemblies\" AfterTargets=\"Build\" DependsOnTargets=\"CopyLicense\"\n        Condition=\"'$(SignAssemblies)' == 'true'\">\n  \u003CExec Command=\"signtool sign \u002Ff cert.pfx %(AssemblyFiles.Identity)\" \u002F>\n\u003C\u002FTarget>\n",[1833],{"type":37,"tag":104,"props":1834,"children":1835},{"__ignoreMap":164},[1836,1843,1851,1859,1867,1875,1883,1891,1899,1906,1913,1921,1929,1937,1945,1952,1959,1967,1976,1984,1992,2001,2010,2019],{"type":37,"tag":170,"props":1837,"children":1838},{"class":172,"line":173},[1839],{"type":37,"tag":170,"props":1840,"children":1841},{},[1842],{"type":43,"value":179},{"type":37,"tag":170,"props":1844,"children":1845},{"class":172,"line":182},[1846],{"type":37,"tag":170,"props":1847,"children":1848},{},[1849],{"type":43,"value":1850},"\u003CTarget Name=\"PrepareRelease\" BeforeTargets=\"Build\">\n",{"type":37,"tag":170,"props":1852,"children":1853},{"class":172,"line":191},[1854],{"type":37,"tag":170,"props":1855,"children":1856},{},[1857],{"type":43,"value":1858},"  \u003CWriteLinesToFile File=\"version.txt\" Lines=\"$(Version)\" Overwrite=\"true\" \u002F>\n",{"type":37,"tag":170,"props":1860,"children":1861},{"class":172,"line":200},[1862],{"type":37,"tag":170,"props":1863,"children":1864},{},[1865],{"type":43,"value":1866},"  \u003CCopy SourceFiles=\"LICENSE\" DestinationFolder=\"$(OutputPath)\" \u002F>\n",{"type":37,"tag":170,"props":1868,"children":1869},{"class":172,"line":209},[1870],{"type":37,"tag":170,"props":1871,"children":1872},{},[1873],{"type":43,"value":1874},"  \u003CExec Command=\"signtool sign \u002Ff cert.pfx $(OutputPath)*.dll\" \u002F>\n",{"type":37,"tag":170,"props":1876,"children":1877},{"class":172,"line":218},[1878],{"type":37,"tag":170,"props":1879,"children":1880},{},[1881],{"type":43,"value":1882},"  \u003CMakeDir Directories=\"$(OutputPath)docs\" \u002F>\n",{"type":37,"tag":170,"props":1884,"children":1885},{"class":172,"line":227},[1886],{"type":37,"tag":170,"props":1887,"children":1888},{},[1889],{"type":43,"value":1890},"  \u003CCopy SourceFiles=\"@(DocFiles)\" DestinationFolder=\"$(OutputPath)docs\" \u002F>\n",{"type":37,"tag":170,"props":1892,"children":1893},{"class":172,"line":237},[1894],{"type":37,"tag":170,"props":1895,"children":1896},{},[1897],{"type":43,"value":1898},"  \u003C!-- ... 30 more lines ... -->\n",{"type":37,"tag":170,"props":1900,"children":1901},{"class":172,"line":246},[1902],{"type":37,"tag":170,"props":1903,"children":1904},{},[1905],{"type":43,"value":224},{"type":37,"tag":170,"props":1907,"children":1908},{"class":172,"line":254},[1909],{"type":37,"tag":170,"props":1910,"children":1911},{"emptyLinePlaceholder":231},[1912],{"type":43,"value":234},{"type":37,"tag":170,"props":1914,"children":1915},{"class":172,"line":263},[1916],{"type":37,"tag":170,"props":1917,"children":1918},{},[1919],{"type":43,"value":1920},"\u003C!-- GOOD: Single-responsibility targets -->\n",{"type":37,"tag":170,"props":1922,"children":1923},{"class":172,"line":272},[1924],{"type":37,"tag":170,"props":1925,"children":1926},{},[1927],{"type":43,"value":1928},"\u003CTarget Name=\"WriteVersionFile\" BeforeTargets=\"CoreCompile\"\n",{"type":37,"tag":170,"props":1930,"children":1931},{"class":172,"line":281},[1932],{"type":37,"tag":170,"props":1933,"children":1934},{},[1935],{"type":43,"value":1936},"        Inputs=\"$(MSBuildProjectFile)\" Outputs=\"$(IntermediateOutputPath)version.txt\">\n",{"type":37,"tag":170,"props":1938,"children":1939},{"class":172,"line":1006},[1940],{"type":37,"tag":170,"props":1941,"children":1942},{},[1943],{"type":43,"value":1944},"  \u003CWriteLinesToFile File=\"$(IntermediateOutputPath)version.txt\" Lines=\"$(Version)\" Overwrite=\"true\" \u002F>\n",{"type":37,"tag":170,"props":1946,"children":1947},{"class":172,"line":1643},[1948],{"type":37,"tag":170,"props":1949,"children":1950},{},[1951],{"type":43,"value":224},{"type":37,"tag":170,"props":1953,"children":1954},{"class":172,"line":1652},[1955],{"type":37,"tag":170,"props":1956,"children":1957},{"emptyLinePlaceholder":231},[1958],{"type":43,"value":234},{"type":37,"tag":170,"props":1960,"children":1961},{"class":172,"line":1661},[1962],{"type":37,"tag":170,"props":1963,"children":1964},{},[1965],{"type":43,"value":1966},"\u003CTarget Name=\"CopyLicense\" AfterTargets=\"Build\">\n",{"type":37,"tag":170,"props":1968,"children":1970},{"class":172,"line":1969},18,[1971],{"type":37,"tag":170,"props":1972,"children":1973},{},[1974],{"type":43,"value":1975},"  \u003CCopy SourceFiles=\"LICENSE\" DestinationFolder=\"$(OutputPath)\" SkipUnchangedFiles=\"true\" \u002F>\n",{"type":37,"tag":170,"props":1977,"children":1979},{"class":172,"line":1978},19,[1980],{"type":37,"tag":170,"props":1981,"children":1982},{},[1983],{"type":43,"value":224},{"type":37,"tag":170,"props":1985,"children":1987},{"class":172,"line":1986},20,[1988],{"type":37,"tag":170,"props":1989,"children":1990},{"emptyLinePlaceholder":231},[1991],{"type":43,"value":234},{"type":37,"tag":170,"props":1993,"children":1995},{"class":172,"line":1994},21,[1996],{"type":37,"tag":170,"props":1997,"children":1998},{},[1999],{"type":43,"value":2000},"\u003CTarget Name=\"SignAssemblies\" AfterTargets=\"Build\" DependsOnTargets=\"CopyLicense\"\n",{"type":37,"tag":170,"props":2002,"children":2004},{"class":172,"line":2003},22,[2005],{"type":37,"tag":170,"props":2006,"children":2007},{},[2008],{"type":43,"value":2009},"        Condition=\"'$(SignAssemblies)' == 'true'\">\n",{"type":37,"tag":170,"props":2011,"children":2013},{"class":172,"line":2012},23,[2014],{"type":37,"tag":170,"props":2015,"children":2016},{},[2017],{"type":43,"value":2018},"  \u003CExec Command=\"signtool sign \u002Ff cert.pfx %(AssemblyFiles.Identity)\" \u002F>\n",{"type":37,"tag":170,"props":2020,"children":2022},{"class":172,"line":2021},24,[2023],{"type":37,"tag":170,"props":2024,"children":2025},{},[2026],{"type":43,"value":224},{"type":37,"tag":93,"props":2028,"children":2029},{},[],{"type":37,"tag":97,"props":2031,"children":2033},{"id":2032},"ap-11-custom-targets-missing-inputs-and-outputs",[2034,2036,2042,2043],{"type":43,"value":2035},"AP-11: Custom Targets Missing ",{"type":37,"tag":104,"props":2037,"children":2039},{"className":2038},[],[2040],{"type":43,"value":2041},"Inputs",{"type":43,"value":625},{"type":37,"tag":104,"props":2044,"children":2046},{"className":2045},[],[2047],{"type":43,"value":2048},"Outputs",{"type":37,"tag":46,"props":2050,"children":2051},{},[2052,2056,2057,2063,2065,2070,2071,2076],{"type":37,"tag":60,"props":2053,"children":2054},{},[2055],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":2058,"children":2060},{"className":2059},[],[2061],{"type":43,"value":2062},"\u003CTarget Name=\"MyTarget\" BeforeTargets=\"Build\">",{"type":43,"value":2064}," with no ",{"type":37,"tag":104,"props":2066,"children":2068},{"className":2067},[],[2069],{"type":43,"value":2041},{"type":43,"value":357},{"type":37,"tag":104,"props":2072,"children":2074},{"className":2073},[],[2075],{"type":43,"value":2048},{"type":43,"value":2077}," attributes.",{"type":37,"tag":46,"props":2079,"children":2080},{},[2081,2085],{"type":37,"tag":60,"props":2082,"children":2083},{},[2084],{"type":43,"value":74},{"type":43,"value":2086},": The target runs on every build, even when nothing changed. This defeats incremental build and slows down no-op builds.",{"type":37,"tag":46,"props":2088,"children":2089},{},[2090,2091,2100],{"type":43,"value":1477},{"type":37,"tag":1479,"props":2092,"children":2094},{"href":2093},"references\u002Fincremental-build-inputs-outputs.md",[2095],{"type":37,"tag":104,"props":2096,"children":2098},{"className":2097},[],[2099],{"type":43,"value":2093},{"type":43,"value":2101}," for BAD\u002FGOOD examples and the full pattern including FileWrites registration.",{"type":37,"tag":46,"props":2103,"children":2104},{},[2105,2106,2112],{"type":43,"value":1477},{"type":37,"tag":104,"props":2107,"children":2109},{"className":2108},[],[2110],{"type":43,"value":2111},"incremental-build",{"type":43,"value":2113}," skill for deep guidance on Inputs\u002FOutputs, FileWrites, and up-to-date checks.",{"type":37,"tag":93,"props":2115,"children":2116},{},[],{"type":37,"tag":97,"props":2118,"children":2120},{"id":2119},"ap-12-setting-defaults-in-targets-instead-of-props",[2121],{"type":43,"value":2122},"AP-12: Setting Defaults in .targets Instead of .props",{"type":37,"tag":46,"props":2124,"children":2125},{},[2126,2130,2131,2136,2138,2144],{"type":37,"tag":60,"props":2127,"children":2128},{},[2129],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":2132,"children":2134},{"className":2133},[],[2135],{"type":43,"value":1513},{"type":43,"value":2137}," with default values inside a ",{"type":37,"tag":104,"props":2139,"children":2141},{"className":2140},[],[2142],{"type":43,"value":2143},".targets",{"type":43,"value":2145}," file.",{"type":37,"tag":46,"props":2147,"children":2148},{},[2149,2153,2154,2159,2161,2166,2168,2174],{"type":37,"tag":60,"props":2150,"children":2151},{},[2152],{"type":43,"value":74},{"type":43,"value":120},{"type":37,"tag":104,"props":2155,"children":2157},{"className":2156},[],[2158],{"type":43,"value":2143},{"type":43,"value":2160}," files are imported late (after project files). By the time they set defaults, other ",{"type":37,"tag":104,"props":2162,"children":2164},{"className":2163},[],[2165],{"type":43,"value":2143},{"type":43,"value":2167}," files may have already used the empty\u002Fundefined value. ",{"type":37,"tag":104,"props":2169,"children":2171},{"className":2170},[],[2172],{"type":43,"value":2173},".props",{"type":43,"value":2175}," files are imported early and are the correct place for defaults.",{"type":37,"tag":159,"props":2177,"children":2179},{"className":161,"code":2178,"language":163,"meta":164,"style":164},"\u003C!-- BAD: custom.targets -->\n\u003CPropertyGroup>\n  \u003CMyToolVersion>2.0\u003C\u002FMyToolVersion>\n\u003C\u002FPropertyGroup>\n\u003CTarget Name=\"RunMyTool\">\n  \u003CExec Command=\"mytool --version $(MyToolVersion)\" \u002F>\n\u003C\u002FTarget>\n\n\u003C!-- GOOD: Split into .props (defaults) + .targets (logic) -->\n\u003C!-- custom.props (imported early) -->\n\u003CPropertyGroup>\n  \u003CMyToolVersion Condition=\"'$(MyToolVersion)' == ''\">2.0\u003C\u002FMyToolVersion>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- custom.targets (imported late) -->\n\u003CTarget Name=\"RunMyTool\">\n  \u003CExec Command=\"mytool --version $(MyToolVersion)\" \u002F>\n\u003C\u002FTarget>\n",[2180],{"type":37,"tag":104,"props":2181,"children":2182},{"__ignoreMap":164},[2183,2191,2198,2206,2213,2221,2229,2236,2243,2251,2259,2266,2274,2281,2288,2296,2303,2310],{"type":37,"tag":170,"props":2184,"children":2185},{"class":172,"line":173},[2186],{"type":37,"tag":170,"props":2187,"children":2188},{},[2189],{"type":43,"value":2190},"\u003C!-- BAD: custom.targets -->\n",{"type":37,"tag":170,"props":2192,"children":2193},{"class":172,"line":182},[2194],{"type":37,"tag":170,"props":2195,"children":2196},{},[2197],{"type":43,"value":704},{"type":37,"tag":170,"props":2199,"children":2200},{"class":172,"line":191},[2201],{"type":37,"tag":170,"props":2202,"children":2203},{},[2204],{"type":43,"value":2205},"  \u003CMyToolVersion>2.0\u003C\u002FMyToolVersion>\n",{"type":37,"tag":170,"props":2207,"children":2208},{"class":172,"line":200},[2209],{"type":37,"tag":170,"props":2210,"children":2211},{},[2212],{"type":43,"value":564},{"type":37,"tag":170,"props":2214,"children":2215},{"class":172,"line":209},[2216],{"type":37,"tag":170,"props":2217,"children":2218},{},[2219],{"type":43,"value":2220},"\u003CTarget Name=\"RunMyTool\">\n",{"type":37,"tag":170,"props":2222,"children":2223},{"class":172,"line":218},[2224],{"type":37,"tag":170,"props":2225,"children":2226},{},[2227],{"type":43,"value":2228},"  \u003CExec Command=\"mytool --version $(MyToolVersion)\" \u002F>\n",{"type":37,"tag":170,"props":2230,"children":2231},{"class":172,"line":227},[2232],{"type":37,"tag":170,"props":2233,"children":2234},{},[2235],{"type":43,"value":224},{"type":37,"tag":170,"props":2237,"children":2238},{"class":172,"line":237},[2239],{"type":37,"tag":170,"props":2240,"children":2241},{"emptyLinePlaceholder":231},[2242],{"type":43,"value":234},{"type":37,"tag":170,"props":2244,"children":2245},{"class":172,"line":246},[2246],{"type":37,"tag":170,"props":2247,"children":2248},{},[2249],{"type":43,"value":2250},"\u003C!-- GOOD: Split into .props (defaults) + .targets (logic) -->\n",{"type":37,"tag":170,"props":2252,"children":2253},{"class":172,"line":254},[2254],{"type":37,"tag":170,"props":2255,"children":2256},{},[2257],{"type":43,"value":2258},"\u003C!-- custom.props (imported early) -->\n",{"type":37,"tag":170,"props":2260,"children":2261},{"class":172,"line":263},[2262],{"type":37,"tag":170,"props":2263,"children":2264},{},[2265],{"type":43,"value":704},{"type":37,"tag":170,"props":2267,"children":2268},{"class":172,"line":272},[2269],{"type":37,"tag":170,"props":2270,"children":2271},{},[2272],{"type":43,"value":2273},"  \u003CMyToolVersion Condition=\"'$(MyToolVersion)' == ''\">2.0\u003C\u002FMyToolVersion>\n",{"type":37,"tag":170,"props":2275,"children":2276},{"class":172,"line":281},[2277],{"type":37,"tag":170,"props":2278,"children":2279},{},[2280],{"type":43,"value":564},{"type":37,"tag":170,"props":2282,"children":2283},{"class":172,"line":1006},[2284],{"type":37,"tag":170,"props":2285,"children":2286},{"emptyLinePlaceholder":231},[2287],{"type":43,"value":234},{"type":37,"tag":170,"props":2289,"children":2290},{"class":172,"line":1643},[2291],{"type":37,"tag":170,"props":2292,"children":2293},{},[2294],{"type":43,"value":2295},"\u003C!-- custom.targets (imported late) -->\n",{"type":37,"tag":170,"props":2297,"children":2298},{"class":172,"line":1652},[2299],{"type":37,"tag":170,"props":2300,"children":2301},{},[2302],{"type":43,"value":2220},{"type":37,"tag":170,"props":2304,"children":2305},{"class":172,"line":1661},[2306],{"type":37,"tag":170,"props":2307,"children":2308},{},[2309],{"type":43,"value":2228},{"type":37,"tag":170,"props":2311,"children":2312},{"class":172,"line":1969},[2313],{"type":37,"tag":170,"props":2314,"children":2315},{},[2316],{"type":43,"value":224},{"type":37,"tag":46,"props":2318,"children":2319},{},[2320,2324,2325,2330,2332,2337],{"type":37,"tag":60,"props":2321,"children":2322},{},[2323],{"type":43,"value":608},{"type":43,"value":120},{"type":37,"tag":104,"props":2326,"children":2328},{"className":2327},[],[2329],{"type":43,"value":2173},{"type":43,"value":2331}," = defaults and settings (evaluated early). ",{"type":37,"tag":104,"props":2333,"children":2335},{"className":2334},[],[2336],{"type":43,"value":2143},{"type":43,"value":2338}," = build logic and targets (evaluated late).",{"type":37,"tag":93,"props":2340,"children":2341},{},[],{"type":37,"tag":97,"props":2343,"children":2345},{"id":2344},"ap-13-import-without-exists-guard",[2346,2348,2354],{"type":43,"value":2347},"AP-13: Import Without ",{"type":37,"tag":104,"props":2349,"children":2351},{"className":2350},[],[2352],{"type":43,"value":2353},"Exists()",{"type":43,"value":2355}," Guard",{"type":37,"tag":46,"props":2357,"children":2358},{},[2359,2363,2364,2370,2372,2378],{"type":37,"tag":60,"props":2360,"children":2361},{},[2362],{"type":43,"value":64},{"type":43,"value":120},{"type":37,"tag":104,"props":2365,"children":2367},{"className":2366},[],[2368],{"type":43,"value":2369},"\u003CImport Project=\"some-file.props\" \u002F>",{"type":43,"value":2371}," without a ",{"type":37,"tag":104,"props":2373,"children":2375},{"className":2374},[],[2376],{"type":43,"value":2377},"Condition=\"Exists('...')\"",{"type":43,"value":2379}," check.",{"type":37,"tag":46,"props":2381,"children":2382},{},[2383,2387],{"type":37,"tag":60,"props":2384,"children":2385},{},[2386],{"type":43,"value":74},{"type":43,"value":2388},": If the file doesn't exist (not yet created, wrong path, deleted), the build fails with a confusing error. Optional imports should always be guarded.",{"type":37,"tag":159,"props":2390,"children":2392},{"className":161,"code":2391,"language":163,"meta":164,"style":164},"\u003C!-- BAD -->\n\u003CImport Project=\"$(RepoRoot)eng\\custom.props\" \u002F>\n\n\u003C!-- GOOD: Guard optional imports -->\n\u003CImport Project=\"$(RepoRoot)eng\\custom.props\" Condition=\"Exists('$(RepoRoot)eng\\custom.props')\" \u002F>\n\n\u003C!-- ALSO GOOD: Sdk attribute imports don't need guards (they're required by design) -->\n\u003CProject Sdk=\"Microsoft.NET.Sdk\">\n",[2393],{"type":37,"tag":104,"props":2394,"children":2395},{"__ignoreMap":164},[2396,2403,2411,2418,2426,2434,2441,2449],{"type":37,"tag":170,"props":2397,"children":2398},{"class":172,"line":173},[2399],{"type":37,"tag":170,"props":2400,"children":2401},{},[2402],{"type":43,"value":179},{"type":37,"tag":170,"props":2404,"children":2405},{"class":172,"line":182},[2406],{"type":37,"tag":170,"props":2407,"children":2408},{},[2409],{"type":43,"value":2410},"\u003CImport Project=\"$(RepoRoot)eng\\custom.props\" \u002F>\n",{"type":37,"tag":170,"props":2412,"children":2413},{"class":172,"line":191},[2414],{"type":37,"tag":170,"props":2415,"children":2416},{"emptyLinePlaceholder":231},[2417],{"type":43,"value":234},{"type":37,"tag":170,"props":2419,"children":2420},{"class":172,"line":200},[2421],{"type":37,"tag":170,"props":2422,"children":2423},{},[2424],{"type":43,"value":2425},"\u003C!-- GOOD: Guard optional imports -->\n",{"type":37,"tag":170,"props":2427,"children":2428},{"class":172,"line":209},[2429],{"type":37,"tag":170,"props":2430,"children":2431},{},[2432],{"type":43,"value":2433},"\u003CImport Project=\"$(RepoRoot)eng\\custom.props\" Condition=\"Exists('$(RepoRoot)eng\\custom.props')\" \u002F>\n",{"type":37,"tag":170,"props":2435,"children":2436},{"class":172,"line":218},[2437],{"type":37,"tag":170,"props":2438,"children":2439},{"emptyLinePlaceholder":231},[2440],{"type":43,"value":234},{"type":37,"tag":170,"props":2442,"children":2443},{"class":172,"line":227},[2444],{"type":37,"tag":170,"props":2445,"children":2446},{},[2447],{"type":43,"value":2448},"\u003C!-- ALSO GOOD: Sdk attribute imports don't need guards (they're required by design) -->\n",{"type":37,"tag":170,"props":2450,"children":2451},{"class":172,"line":237},[2452],{"type":37,"tag":170,"props":2453,"children":2454},{},[2455],{"type":43,"value":2456},"\u003CProject Sdk=\"Microsoft.NET.Sdk\">\n",{"type":37,"tag":46,"props":2458,"children":2459},{},[2460,2465,2467,2473],{"type":37,"tag":60,"props":2461,"children":2462},{},[2463],{"type":43,"value":2464},"Exception — required imports",{"type":43,"value":2466},": Imports that are ",{"type":37,"tag":2468,"props":2469,"children":2470},"em",{},[2471],{"type":43,"value":2472},"required",{"type":43,"value":2474}," for the build to work correctly should fail fast — don't guard those. Guard imports that are optional or environment-specific (e.g., local developer overrides, CI-specific settings).",{"type":37,"tag":46,"props":2476,"children":2477},{},[2478,2483,2484,2489,2491,2496,2498,2504,2506,2512,2514,2520,2522,2527,2529,2534],{"type":37,"tag":60,"props":2479,"children":2480},{},[2481],{"type":43,"value":2482},"Exception — NuGet package forwarders",{"type":43,"value":120},{"type":37,"tag":104,"props":2485,"children":2487},{"className":2486},[],[2488],{"type":43,"value":2173},{"type":43,"value":2490},"\u002F",{"type":37,"tag":104,"props":2492,"children":2494},{"className":2493},[],[2495],{"type":43,"value":2143},{"type":43,"value":2497}," files inside a NuGet package's per-TFM ",{"type":37,"tag":104,"props":2499,"children":2501},{"className":2500},[],[2502],{"type":43,"value":2503},"build\u002F",{"type":43,"value":2505}," or ",{"type":37,"tag":104,"props":2507,"children":2509},{"className":2508},[],[2510],{"type":43,"value":2511},"buildTransitive\u002F",{"type":43,"value":2513}," folder routinely import a sibling file under ",{"type":37,"tag":104,"props":2515,"children":2517},{"className":2516},[],[2518],{"type":43,"value":2519},"buildTransitive\u002F\u003Ctfm>\u002F…",{"type":43,"value":2521}," without an ",{"type":37,"tag":104,"props":2523,"children":2525},{"className":2524},[],[2526],{"type":43,"value":2353},{"type":43,"value":2528}," guard. These are a ",{"type":37,"tag":60,"props":2530,"children":2531},{},[2532],{"type":43,"value":2533},"package contract",{"type":43,"value":2535},": the target file is guaranteed to be present in the restored package, even if it doesn't appear in the source tree at that relative path. The package layout is typically produced by:",{"type":37,"tag":52,"props":2537,"children":2538},{},[2539,2576,2618],{"type":37,"tag":56,"props":2540,"children":2541},{},[2542,2544,2550,2552,2558,2560,2566,2568,2574],{"type":43,"value":2543},"A custom ",{"type":37,"tag":104,"props":2545,"children":2547},{"className":2546},[],[2548],{"type":43,"value":2549},".nuspec",{"type":43,"value":2551}," with per-TFM ",{"type":37,"tag":104,"props":2553,"children":2555},{"className":2554},[],[2556],{"type":43,"value":2557},"\u003Cfile>",{"type":43,"value":2559}," entries — e.g. ",{"type":37,"tag":104,"props":2561,"children":2563},{"className":2562},[],[2564],{"type":43,"value":2565},"\u003Cfile src=\"buildTransitive\\common\\MyAdapter.props\" target=\"buildTransitive\\net8.0\\MyAdapter.props\" \u002F>",{"type":43,"value":2567}," — that copy files from a single source folder (such as ",{"type":37,"tag":104,"props":2569,"children":2571},{"className":2570},[],[2572],{"type":43,"value":2573},"buildTransitive\u002Fcommon\u002F",{"type":43,"value":2575},") into per-TFM subfolders at pack time, or",{"type":37,"tag":56,"props":2577,"children":2578},{},[2579,2585,2586,2592,2594,2600,2602,2608,2610,2616],{"type":37,"tag":104,"props":2580,"children":2582},{"className":2581},[],[2583],{"type":43,"value":2584},"\u003CNone Update=\"...\">",{"type":43,"value":357},{"type":37,"tag":104,"props":2587,"children":2589},{"className":2588},[],[2590],{"type":43,"value":2591},"\u003CContent Include=\"...\">",{"type":43,"value":2593}," items in the ",{"type":37,"tag":104,"props":2595,"children":2597},{"className":2596},[],[2598],{"type":43,"value":2599},".csproj",{"type":43,"value":2601}," with a per-TFM ",{"type":37,"tag":104,"props":2603,"children":2605},{"className":2604},[],[2606],{"type":43,"value":2607},"\u003CPackagePath>",{"type":43,"value":2609}," (e.g. ",{"type":37,"tag":104,"props":2611,"children":2613},{"className":2612},[],[2614],{"type":43,"value":2615},"\u003CPackagePath>buildTransitive\u002Fnet8.0\u002F\u003C\u002FPackagePath>",{"type":43,"value":2617},"), declared once per target TFM, or",{"type":37,"tag":56,"props":2619,"children":2620},{},[2621,2623,2629,2630,2636,2638,2644],{"type":43,"value":2622},"SDK conventions (e.g. ",{"type":37,"tag":104,"props":2624,"children":2626},{"className":2625},[],[2627],{"type":43,"value":2628},"IncludeBuildOutput",{"type":43,"value":128},{"type":37,"tag":104,"props":2631,"children":2633},{"className":2632},[],[2634],{"type":43,"value":2635},"BuildOutputTargetFolder",{"type":43,"value":2637},") that place built outputs under ",{"type":37,"tag":104,"props":2639,"children":2641},{"className":2640},[],[2642],{"type":43,"value":2643},"build\u002F\u003Ctfm>\u002F",{"type":43,"value":1456},{"type":37,"tag":46,"props":2646,"children":2647},{},[2648,2650,2656,2658,2663,2664,2669,2671,2676,2678,2684,2686,2691,2693,2698,2700,2706,2707,2713,2714,2719,2721,2725,2727,2732,2734,2740,2742,2747],{"type":43,"value":2649},"Before flagging an unguarded ",{"type":37,"tag":104,"props":2651,"children":2653},{"className":2652},[],[2654],{"type":43,"value":2655},"\u003CImport>",{"type":43,"value":2657}," inside a ",{"type":37,"tag":104,"props":2659,"children":2661},{"className":2660},[],[2662],{"type":43,"value":2503},{"type":43,"value":2505},{"type":37,"tag":104,"props":2665,"children":2667},{"className":2666},[],[2668],{"type":43,"value":2511},{"type":43,"value":2670}," folder, ",{"type":37,"tag":60,"props":2672,"children":2673},{},[2674],{"type":43,"value":2675},"resolve it against the packed layout",{"type":43,"value":2677}," — read every ",{"type":37,"tag":104,"props":2679,"children":2681},{"className":2680},[],[2682],{"type":43,"value":2683},"*.nuspec",{"type":43,"value":2685}," in the project directory ",{"type":37,"tag":60,"props":2687,"children":2688},{},[2689],{"type":43,"value":2690},"and its immediate parent directory",{"type":43,"value":2692}," (shared nuspecs are common in mono-repos; do not walk further up), and any ",{"type":37,"tag":104,"props":2694,"children":2696},{"className":2695},[],[2697],{"type":43,"value":2607},{"type":43,"value":2699}," metadata on ",{"type":37,"tag":104,"props":2701,"children":2703},{"className":2702},[],[2704],{"type":43,"value":2705},"\u003CNone>",{"type":43,"value":2490},{"type":37,"tag":104,"props":2708,"children":2710},{"className":2709},[],[2711],{"type":43,"value":2712},"\u003CContent>",{"type":43,"value":2593},{"type":37,"tag":104,"props":2715,"children":2717},{"className":2716},[],[2718],{"type":43,"value":2599},{"type":43,"value":2720},". Only flag if the target path is missing from ",{"type":37,"tag":60,"props":2722,"children":2723},{},[2724],{"type":43,"value":615},{"type":43,"value":2726}," the source tree ",{"type":37,"tag":2468,"props":2728,"children":2729},{},[2730],{"type":43,"value":2731},"and",{"type":43,"value":2733}," the projected package layout. The ",{"type":37,"tag":104,"props":2735,"children":2737},{"className":2736},[],[2738],{"type":43,"value":2739},"dotnet-msbuild\u002Fextension-points",{"type":43,"value":2741}," skill — ",{"type":37,"tag":2468,"props":2743,"children":2744},{},[2745],{"type":43,"value":2746},"Source tree vs packed layout",{"type":43,"value":2748}," — documents the full cross-check procedure.",{"type":37,"tag":46,"props":2750,"children":2751},{},[2752,2771,2773,2779,2780,2786,2788,2794,2796,2801,2803,2808,2810,2816,2818,2824,2826,2832,2833,2838],{"type":37,"tag":60,"props":2753,"children":2754},{},[2755,2757,2762,2764,2769],{"type":43,"value":2756},"Forwarding ",{"type":37,"tag":104,"props":2758,"children":2760},{"className":2759},[],[2761],{"type":43,"value":2511},{"type":43,"value":2763}," → ",{"type":37,"tag":104,"props":2765,"children":2767},{"className":2766},[],[2768],{"type":43,"value":2503},{"type":43,"value":2770},":",{"type":43,"value":2772}," forward through the sibling ",{"type":37,"tag":104,"props":2774,"children":2776},{"className":2775},[],[2777],{"type":43,"value":2778},"build\u002F*.props",{"type":43,"value":357},{"type":37,"tag":104,"props":2781,"children":2783},{"className":2782},[],[2784],{"type":43,"value":2785},"build\u002F*.targets",{"type":43,"value":2787}," file (not directly to ",{"type":37,"tag":104,"props":2789,"children":2791},{"className":2790},[],[2792],{"type":43,"value":2793},"buildMultiTargeting\u002F",{"type":43,"value":2795},"); when ",{"type":37,"tag":104,"props":2797,"children":2799},{"className":2798},[],[2800],{"type":43,"value":2503},{"type":43,"value":2802}," is per-TFM (",{"type":37,"tag":104,"props":2804,"children":2806},{"className":2805},[],[2807],{"type":43,"value":2643},{"type":43,"value":2809},"), include the TFM segment derived from the file's own folder (not ",{"type":37,"tag":104,"props":2811,"children":2813},{"className":2812},[],[2814],{"type":43,"value":2815},"$(TargetFramework)",{"type":43,"value":2817},"), or transitive consumers hit ",{"type":37,"tag":104,"props":2819,"children":2821},{"className":2820},[],[2822],{"type":43,"value":2823},"MSB4019",{"type":43,"value":2825},". See the ",{"type":37,"tag":104,"props":2827,"children":2829},{"className":2828},[],[2830],{"type":43,"value":2831},"extension-points",{"type":43,"value":2741},{"type":37,"tag":2468,"props":2834,"children":2835},{},[2836],{"type":43,"value":2837},"Forwarding chain",{"type":43,"value":2839}," — for the rule and derivation expression.",{"type":37,"tag":93,"props":2841,"children":2842},{},[],{"type":37,"tag":97,"props":2844,"children":2846},{"id":2845},"ap-14-backslashes-in-paths-where-it-matters",[2847],{"type":43,"value":2848},"AP-14: Backslashes in Paths — Where It Matters",{"type":37,"tag":46,"props":2850,"children":2851},{},[2852,2856,2858,2863,2864,2869],{"type":37,"tag":60,"props":2853,"children":2854},{},[2855],{"type":43,"value":64},{"type":43,"value":2857},": Backslash path separators in ",{"type":37,"tag":104,"props":2859,"children":2861},{"className":2860},[],[2862],{"type":43,"value":2173},{"type":43,"value":2490},{"type":37,"tag":104,"props":2865,"children":2867},{"className":2866},[],[2868],{"type":43,"value":2143},{"type":43,"value":2870}," files meant to run cross-platform.",{"type":37,"tag":46,"props":2872,"children":2873},{},[2874,2879,2881,2886],{"type":37,"tag":60,"props":2875,"children":2876},{},[2877],{"type":43,"value":2878},"Where this is a real bug (🔴 Error)",{"type":43,"value":2880}," — paths that MSBuild does ",{"type":37,"tag":60,"props":2882,"children":2883},{},[2884],{"type":43,"value":2885},"not",{"type":43,"value":2887}," route through its path normalizer:",{"type":37,"tag":52,"props":2889,"children":2890},{},[2891,2927,2939],{"type":37,"tag":56,"props":2892,"children":2893},{},[2894,2896,2902,2904,2910,2911,2917,2919,2925],{"type":43,"value":2895},"Raw shell strings inside ",{"type":37,"tag":104,"props":2897,"children":2899},{"className":2898},[],[2900],{"type":43,"value":2901},"\u003CExec Command=\"...\\tools\\foo.exe ...\" \u002F>",{"type":43,"value":2903}," — passed verbatim to ",{"type":37,"tag":104,"props":2905,"children":2907},{"className":2906},[],[2908],{"type":43,"value":2909},"bash",{"type":43,"value":2490},{"type":37,"tag":104,"props":2912,"children":2914},{"className":2913},[],[2915],{"type":43,"value":2916},"sh",{"type":43,"value":2918}," on Unix, which treats ",{"type":37,"tag":104,"props":2920,"children":2922},{"className":2921},[],[2923],{"type":43,"value":2924},"\\",{"type":43,"value":2926}," as an escape.",{"type":37,"tag":56,"props":2928,"children":2929},{},[2930,2932,2937],{"type":43,"value":2931},"Backslash-delimited paths inside CDATA blocks, embedded in source files written by ",{"type":37,"tag":104,"props":2933,"children":2935},{"className":2934},[],[2936],{"type":43,"value":449},{"type":43,"value":2938},", or constructed for non-MSBuild consumers (custom scripts, response files, environment variables).",{"type":37,"tag":56,"props":2940,"children":2941},{},[2942],{"type":43,"value":2943},"Paths handed to custom tasks that call OS file APIs directly without going through MSBuild path utilities.",{"type":37,"tag":46,"props":2945,"children":2946},{},[2947,2952,2954,2960,2962,2967,2968,2973,2974,2979,2981,2987,2988,2994],{"type":37,"tag":60,"props":2948,"children":2949},{},[2950],{"type":43,"value":2951},"Where this is only a style preference (🔵 Style)",{"type":43,"value":2953}," — paths that go through MSBuild's evaluator (",{"type":37,"tag":104,"props":2955,"children":2957},{"className":2956},[],[2958],{"type":43,"value":2959},"\u003CImport Project=\"...\">",{"type":43,"value":2961},", file-path properties consumed by built-in tasks like ",{"type":37,"tag":104,"props":2963,"children":2965},{"className":2964},[],[2966],{"type":43,"value":372},{"type":43,"value":2490},{"type":37,"tag":104,"props":2969,"children":2971},{"className":2970},[],[2972],{"type":43,"value":343},{"type":43,"value":2490},{"type":37,"tag":104,"props":2975,"children":2977},{"className":2976},[],[2978],{"type":43,"value":400},{"type":43,"value":2980},", item ",{"type":37,"tag":104,"props":2982,"children":2984},{"className":2983},[],[2985],{"type":43,"value":2986},"Include=",{"type":43,"value":2490},{"type":37,"tag":104,"props":2989,"children":2991},{"className":2990},[],[2992],{"type":43,"value":2993},"Exclude=",{"type":43,"value":2995}," globs):",{"type":37,"tag":46,"props":2997,"children":2998},{},[2999,3001,3006,3007,3012,3014,3020,3021,3027,3029,3048,3050,3056,3058,3063,3065,3070],{"type":43,"value":3000},"MSBuild's evaluator normalizes ",{"type":37,"tag":104,"props":3002,"children":3004},{"className":3003},[],[3005],{"type":43,"value":2924},{"type":43,"value":2763},{"type":37,"tag":104,"props":3008,"children":3010},{"className":3009},[],[3011],{"type":43,"value":2490},{"type":43,"value":3013}," on Unix-like systems before resolving the path. See ",{"type":37,"tag":104,"props":3015,"children":3017},{"className":3016},[],[3018],{"type":43,"value":3019},"FileUtilities.MaybeAdjustFilePath",{"type":43,"value":625},{"type":37,"tag":104,"props":3022,"children":3024},{"className":3023},[],[3025],{"type":43,"value":3026},"ConvertToUnixSlashes",{"type":43,"value":3028}," in ",{"type":37,"tag":1479,"props":3030,"children":3033},{"href":3031,"rel":3032},"https:\u002F\u002Fgithub.com\u002Fdotnet\u002Fmsbuild\u002Fblob\u002Fmain\u002Fsrc\u002FFramework\u002FFileUtilities.cs",[1789],[3034,3040,3042],{"type":37,"tag":104,"props":3035,"children":3037},{"className":3036},[],[3038],{"type":43,"value":3039},"microsoft\u002Fmsbuild",{"type":43,"value":3041}," ",{"type":37,"tag":104,"props":3043,"children":3045},{"className":3044},[],[3046],{"type":43,"value":3047},"src\u002FFramework\u002FFileUtilities.cs",{"type":43,"value":3049},". So ",{"type":37,"tag":104,"props":3051,"children":3053},{"className":3052},[],[3054],{"type":43,"value":3055},"\u003CImport Project=\"$(MSBuildThisFileDirectory)..\\..\\build\\common.props\" \u002F>",{"type":43,"value":3057}," resolves correctly on Linux\u002FmacOS today. Forward slashes are still ",{"type":37,"tag":60,"props":3059,"children":3060},{},[3061],{"type":43,"value":3062},"preferred for consistency",{"type":43,"value":3064},", but the import will not break and existing backslash-style imports should not be flagged as 🔴 ",{"type":37,"tag":60,"props":3066,"children":3067},{},[3068],{"type":43,"value":3069},"Error",{"type":43,"value":1456},{"type":37,"tag":159,"props":3072,"children":3074},{"className":161,"code":3073,"language":163,"meta":164,"style":164},"\u003C!-- 🔴 Error: \\ in raw shell string breaks on Linux\u002FmacOS -->\n\u003CExec Command=\"$(MSBuildThisFileDirectory)tools\\release\\sign.exe $(OutputPath)\" \u002F>\n\n\u003C!-- 🔵 Style: \\ in Import is normalized on Unix, but \u002F is nicer -->\n\u003CImport Project=\"$(MSBuildThisFileDirectory)..\\..\\build\\common.props\" \u002F>\n\n\u003C!-- ✅ Recommended in new code -->\n\u003CImport Project=\"$(MSBuildThisFileDirectory)..\u002F..\u002Fbuild\u002Fcommon.props\" \u002F>\n",[3075],{"type":37,"tag":104,"props":3076,"children":3077},{"__ignoreMap":164},[3078,3086,3094,3101,3109,3117,3124,3132],{"type":37,"tag":170,"props":3079,"children":3080},{"class":172,"line":173},[3081],{"type":37,"tag":170,"props":3082,"children":3083},{},[3084],{"type":43,"value":3085},"\u003C!-- 🔴 Error: \\ in raw shell string breaks on Linux\u002FmacOS -->\n",{"type":37,"tag":170,"props":3087,"children":3088},{"class":172,"line":182},[3089],{"type":37,"tag":170,"props":3090,"children":3091},{},[3092],{"type":43,"value":3093},"\u003CExec Command=\"$(MSBuildThisFileDirectory)tools\\release\\sign.exe $(OutputPath)\" \u002F>\n",{"type":37,"tag":170,"props":3095,"children":3096},{"class":172,"line":191},[3097],{"type":37,"tag":170,"props":3098,"children":3099},{"emptyLinePlaceholder":231},[3100],{"type":43,"value":234},{"type":37,"tag":170,"props":3102,"children":3103},{"class":172,"line":200},[3104],{"type":37,"tag":170,"props":3105,"children":3106},{},[3107],{"type":43,"value":3108},"\u003C!-- 🔵 Style: \\ in Import is normalized on Unix, but \u002F is nicer -->\n",{"type":37,"tag":170,"props":3110,"children":3111},{"class":172,"line":209},[3112],{"type":37,"tag":170,"props":3113,"children":3114},{},[3115],{"type":43,"value":3116},"\u003CImport Project=\"$(MSBuildThisFileDirectory)..\\..\\build\\common.props\" \u002F>\n",{"type":37,"tag":170,"props":3118,"children":3119},{"class":172,"line":218},[3120],{"type":37,"tag":170,"props":3121,"children":3122},{"emptyLinePlaceholder":231},[3123],{"type":43,"value":234},{"type":37,"tag":170,"props":3125,"children":3126},{"class":172,"line":227},[3127],{"type":37,"tag":170,"props":3128,"children":3129},{},[3130],{"type":43,"value":3131},"\u003C!-- ✅ Recommended in new code -->\n",{"type":37,"tag":170,"props":3133,"children":3134},{"class":172,"line":237},[3135],{"type":37,"tag":170,"props":3136,"children":3137},{},[3138],{"type":43,"value":3139},"\u003CImport Project=\"$(MSBuildThisFileDirectory)..\u002F..\u002Fbuild\u002Fcommon.props\" \u002F>\n",{"type":37,"tag":46,"props":3141,"children":3142},{},[3143,3148,3150,3154,3156,3161],{"type":37,"tag":60,"props":3144,"children":3145},{},[3146],{"type":43,"value":3147},"Verification rule",{"type":43,"value":3149},": Before flagging a backslash path as 🔴 ",{"type":37,"tag":60,"props":3151,"children":3152},{},[3153],{"type":43,"value":3069},{"type":43,"value":3155},", ask ",{"type":37,"tag":2468,"props":3157,"children":3158},{},[3159],{"type":43,"value":3160},"\"does this string flow through MSBuild's evaluator, or is it handed verbatim to a non-MSBuild consumer?\"",{"type":43,"value":3162}," Only the second case is a correctness defect.",{"type":37,"tag":46,"props":3164,"children":3165},{},[3166,3170,3171,3176,3178,3184],{"type":37,"tag":60,"props":3167,"children":3168},{},[3169],{"type":43,"value":1393},{"type":43,"value":120},{"type":37,"tag":104,"props":3172,"children":3174},{"className":3173},[],[3175],{"type":43,"value":813},{"type":43,"value":3177}," already ends with a platform-appropriate separator, so ",{"type":37,"tag":104,"props":3179,"children":3181},{"className":3180},[],[3182],{"type":43,"value":3183},"$(MSBuildThisFileDirectory)tools\u002Fmytool",{"type":43,"value":3185}," works on both platforms.",{"type":37,"tag":93,"props":3187,"children":3188},{},[],{"type":37,"tag":97,"props":3190,"children":3192},{"id":3191},"ap-15-unconditional-property-override-in-multiple-scopes",[3193],{"type":43,"value":3194},"AP-15: Unconditional Property Override in Multiple Scopes",{"type":37,"tag":46,"props":3196,"children":3197},{},[3198,3202,3204,3209,3211,3216],{"type":37,"tag":60,"props":3199,"children":3200},{},[3201],{"type":43,"value":64},{"type":43,"value":3203},": A property set unconditionally in both ",{"type":37,"tag":104,"props":3205,"children":3207},{"className":3206},[],[3208],{"type":43,"value":1685},{"type":43,"value":3210}," and a ",{"type":37,"tag":104,"props":3212,"children":3214},{"className":3213},[],[3215],{"type":43,"value":2599},{"type":43,"value":3217}," — last write wins silently.",{"type":37,"tag":46,"props":3219,"children":3220},{},[3221,3225],{"type":37,"tag":60,"props":3222,"children":3223},{},[3224],{"type":43,"value":74},{"type":43,"value":3226},": Hard to trace which value is actually used. Makes the build fragile and confusing for anyone reading the project files.",{"type":37,"tag":159,"props":3228,"children":3230},{"className":161,"code":3229,"language":163,"meta":164,"style":164},"\u003C!-- BAD: Directory.Build.props sets it, csproj silently overrides -->\n\u003C!-- Directory.Build.props -->\n\u003CPropertyGroup>\n  \u003COutputPath>bin\\custom\\\u003C\u002FOutputPath>\n\u003C\u002FPropertyGroup>\n\u003C!-- MyProject.csproj -->\n\u003CPropertyGroup>\n  \u003COutputPath>bin\\other\\\u003C\u002FOutputPath>\n\u003C\u002FPropertyGroup>\n\n\u003C!-- GOOD: Use a condition so overrides are intentional -->\n\u003C!-- Directory.Build.props -->\n\u003CPropertyGroup>\n  \u003COutputPath Condition=\"'$(OutputPath)' == ''\">bin\\custom\\\u003C\u002FOutputPath>\n\u003C\u002FPropertyGroup>\n\u003C!-- MyProject.csproj can now intentionally override or leave the default -->\n",[3231],{"type":37,"tag":104,"props":3232,"children":3233},{"__ignoreMap":164},[3234,3242,3249,3256,3264,3271,3279,3286,3294,3301,3308,3316,3323,3330,3338,3345],{"type":37,"tag":170,"props":3235,"children":3236},{"class":172,"line":173},[3237],{"type":37,"tag":170,"props":3238,"children":3239},{},[3240],{"type":43,"value":3241},"\u003C!-- BAD: Directory.Build.props sets it, csproj silently overrides -->\n",{"type":37,"tag":170,"props":3243,"children":3244},{"class":172,"line":182},[3245],{"type":37,"tag":170,"props":3246,"children":3247},{},[3248],{"type":43,"value":1608},{"type":37,"tag":170,"props":3250,"children":3251},{"class":172,"line":191},[3252],{"type":37,"tag":170,"props":3253,"children":3254},{},[3255],{"type":43,"value":704},{"type":37,"tag":170,"props":3257,"children":3258},{"class":172,"line":200},[3259],{"type":37,"tag":170,"props":3260,"children":3261},{},[3262],{"type":43,"value":3263},"  \u003COutputPath>bin\\custom\\\u003C\u002FOutputPath>\n",{"type":37,"tag":170,"props":3265,"children":3266},{"class":172,"line":209},[3267],{"type":37,"tag":170,"props":3268,"children":3269},{},[3270],{"type":43,"value":564},{"type":37,"tag":170,"props":3272,"children":3273},{"class":172,"line":218},[3274],{"type":37,"tag":170,"props":3275,"children":3276},{},[3277],{"type":43,"value":3278},"\u003C!-- MyProject.csproj -->\n",{"type":37,"tag":170,"props":3280,"children":3281},{"class":172,"line":227},[3282],{"type":37,"tag":170,"props":3283,"children":3284},{},[3285],{"type":43,"value":704},{"type":37,"tag":170,"props":3287,"children":3288},{"class":172,"line":237},[3289],{"type":37,"tag":170,"props":3290,"children":3291},{},[3292],{"type":43,"value":3293},"  \u003COutputPath>bin\\other\\\u003C\u002FOutputPath>\n",{"type":37,"tag":170,"props":3295,"children":3296},{"class":172,"line":246},[3297],{"type":37,"tag":170,"props":3298,"children":3299},{},[3300],{"type":43,"value":564},{"type":37,"tag":170,"props":3302,"children":3303},{"class":172,"line":254},[3304],{"type":37,"tag":170,"props":3305,"children":3306},{"emptyLinePlaceholder":231},[3307],{"type":43,"value":234},{"type":37,"tag":170,"props":3309,"children":3310},{"class":172,"line":263},[3311],{"type":37,"tag":170,"props":3312,"children":3313},{},[3314],{"type":43,"value":3315},"\u003C!-- GOOD: Use a condition so overrides are intentional -->\n",{"type":37,"tag":170,"props":3317,"children":3318},{"class":172,"line":272},[3319],{"type":37,"tag":170,"props":3320,"children":3321},{},[3322],{"type":43,"value":1608},{"type":37,"tag":170,"props":3324,"children":3325},{"class":172,"line":281},[3326],{"type":37,"tag":170,"props":3327,"children":3328},{},[3329],{"type":43,"value":704},{"type":37,"tag":170,"props":3331,"children":3332},{"class":172,"line":1006},[3333],{"type":37,"tag":170,"props":3334,"children":3335},{},[3336],{"type":43,"value":3337},"  \u003COutputPath Condition=\"'$(OutputPath)' == ''\">bin\\custom\\\u003C\u002FOutputPath>\n",{"type":37,"tag":170,"props":3339,"children":3340},{"class":172,"line":1643},[3341],{"type":37,"tag":170,"props":3342,"children":3343},{},[3344],{"type":43,"value":564},{"type":37,"tag":170,"props":3346,"children":3347},{"class":172,"line":1652},[3348],{"type":37,"tag":170,"props":3349,"children":3350},{},[3351],{"type":43,"value":3352},"\u003C!-- MyProject.csproj can now intentionally override or leave the default -->\n",{"type":37,"tag":93,"props":3354,"children":3355},{},[],{"type":37,"tag":46,"props":3357,"children":3358},{},[3359,3361,3367],{"type":43,"value":3360},"For additional anti-patterns (AP-16 through AP-23) and a quick-reference checklist, see ",{"type":37,"tag":1479,"props":3362,"children":3364},{"href":3363},"references\u002Fadditional-antipatterns.md",[3365],{"type":43,"value":3366},"additional-antipatterns.md",{"type":43,"value":1456},{"type":37,"tag":3369,"props":3370,"children":3371},"style",{},[3372],{"type":43,"value":3373},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3375,"total":3538},[3376,3392,3405,3420,3438,3452,3472,3482,3494,3504,3517,3528],{"slug":3377,"name":3377,"fn":3378,"description":3379,"org":3380,"tags":3381,"stars":3389,"repoUrl":3390,"updatedAt":3391},"multithreaded-task-migration","migrate MSBuild tasks to multithreaded mode","Guide for migrating MSBuild tasks to multithreaded mode support, including compatibility red-team review. Use this when converting tasks to thread-safe versions, implementing IMultiThreadableTask, adding TaskEnvironment support, or auditing migrations for behavioral compatibility.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3382,3385,3386],{"name":3383,"slug":3384,"type":15},".NET","net",{"name":13,"slug":14,"type":15},{"name":3387,"slug":3388,"type":15},"Performance","performance",5535,"https:\u002F\u002Fgithub.com\u002Fdotnet\u002Fmsbuild","2026-07-22T05:37:33.965588",{"slug":3393,"name":3393,"fn":3394,"description":3395,"org":3396,"tags":3397,"stars":19,"repoUrl":20,"updatedAt":3404},"analyzing-dotnet-performance","analyze .NET code for performance anti-patterns","Scans .NET code for ~50 performance anti-patterns across async, memory, strings, collections, LINQ, regex, serialization, and I\u002FO with tiered severity classification. Use when analyzing .NET code for optimization opportunities, reviewing hot paths, or auditing allocation-heavy patterns.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3398,3399,3400,3403],{"name":3383,"slug":3384,"type":15},{"name":17,"slug":18,"type":15},{"name":3401,"slug":3402,"type":15},"Debugging","debugging",{"name":3387,"slug":3388,"type":15},"2026-07-12T08:23:25.400375",{"slug":3406,"name":3406,"fn":3407,"description":3408,"org":3409,"tags":3410,"stars":19,"repoUrl":20,"updatedAt":3419},"android-tombstone-symbolication","symbolicate .NET runtime frames in Android tombstones","Symbolicate the .NET runtime frames in an Android tombstone file. Extracts BuildIds and PC offsets from the native backtrace, downloads debug symbols from the Microsoft symbol server, and runs llvm-symbolizer to produce function names with source file and line numbers. USE FOR triaging a .NET MAUI or Mono Android app crash from a tombstone, resolving native backtrace frames in libmonosgen-2.0.so or libcoreclr.so to .NET runtime source code, or investigating SIGABRT, SIGSEGV, or other native signals originating from the .NET runtime on Android. DO NOT USE FOR pure Java\u002FKotlin crashes, managed .NET exceptions that are already captured in logcat, or iOS crash logs. INVOKES Symbolicate-Tombstone.ps1 script, llvm-symbolizer, Microsoft symbol server.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3411,3412,3415,3416],{"name":3383,"slug":3384,"type":15},{"name":3413,"slug":3414,"type":15},"Android","android",{"name":3401,"slug":3402,"type":15},{"name":3417,"slug":3418,"type":15},"Microsoft","microsoft","2026-07-12T08:23:21.595572",{"slug":3421,"name":3421,"fn":3422,"description":3423,"org":3424,"tags":3425,"stars":19,"repoUrl":20,"updatedAt":3437},"apple-crash-symbolication","symbolicate .NET runtime frames in crash logs","Symbolicate .NET runtime frames in Apple platform .ips crash logs (iOS, tvOS, Mac Catalyst, macOS). Extracts UUIDs and addresses from the native backtrace, locates dSYM debug symbols, and runs atos to produce function names with source file and line numbers. Automatically downloads .dwarf symbols from the Microsoft symbol server using Mach-O UUIDs. USE FOR triaging a .NET MAUI or Mono app crash from an .ips file on any Apple platform, resolving native backtrace frames in libcoreclr or libmonosgen-2.0 to .NET runtime source code, retrieving .ips crash logs from a connected iOS device or iPhone, or investigating EXC_CRASH, EXC_BAD_ACCESS, SIGABRT, or SIGSEGV originating from the .NET runtime. DO NOT USE FOR pure Swift\u002FObjective-C crashes with no .NET components, or Android tombstone files. INVOKES Symbolicate-Crash.ps1 script, atos, dwarfdump, idevicecrashreport.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3426,3427,3428,3431,3434],{"name":3383,"slug":3384,"type":15},{"name":3401,"slug":3402,"type":15},{"name":3429,"slug":3430,"type":15},"iOS","ios",{"name":3432,"slug":3433,"type":15},"macOS","macos",{"name":3435,"slug":3436,"type":15},"Observability","observability","2026-07-12T08:23:20.369986",{"slug":3439,"name":3439,"fn":3440,"description":3441,"org":3442,"tags":3443,"stars":19,"repoUrl":20,"updatedAt":3451},"assertion-quality","evaluate assertion quality in test suites","Analyzes the variety and depth of assertions across test suites in any language. Use when the user asks to evaluate assertion quality, find shallow tests, identify assertion-free tests (no assertions or only trivial ones like Assert.IsNotNull \u002F toBeTruthy()), flag self-referential or tautological assertions, measure assertion diversity, or audit whether tests verify different facets of behavior. Polyglot: .NET, Python, TS\u002FJS, Java, Go, Ruby, Rust, Swift, Kotlin, PowerShell, C++. DO NOT USE FOR: writing new tests (use code-testing-agent \u002F writing-mstest-tests), mutation reasoning about whether tests would catch a bug (use test-gap-analysis), or a general severity-ranked anti-pattern audit (use test-anti-patterns), fixing or rewriting assertions, or writing, fixing, or modernizing MSTest tests, assertions, or attributes (use writing-mstest-tests).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3444,3445,3448],{"name":17,"slug":18,"type":15},{"name":3446,"slug":3447,"type":15},"QA","qa",{"name":3449,"slug":3450,"type":15},"Testing","testing","2026-07-12T08:23:51.277743",{"slug":3453,"name":3453,"fn":3454,"description":3455,"org":3456,"tags":3457,"stars":19,"repoUrl":20,"updatedAt":3471},"author-component","create and review Blazor components","Create or review Blazor components (.razor files) with correct architecture. USE FOR: writing new Blazor components that do NOT involve JavaScript interop, implementing parameters and EventCallback, RenderFragment slots, component lifecycle (OnInitializedAsync, OnParametersSet), async patterns, IAsyncDisposable, CancellationToken, CSS isolation, code-behind. DO NOT USE FOR: creating new projects (use create-blazor-project), JavaScript interop or calling browser APIs from Blazor (use use-js-interop), forms and validation (use collect-user-input), prerendering issues (use support-prerendering), HTTP data fetching patterns (use fetch-and-send-data), coordinating state between unrelated components (use coordinate-components).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3458,3459,3462,3465,3468],{"name":3383,"slug":3384,"type":15},{"name":3460,"slug":3461,"type":15},"Blazor","blazor",{"name":3463,"slug":3464,"type":15},"C#","csharp",{"name":3466,"slug":3467,"type":15},"UI Components","ui-components",{"name":3469,"slug":3470,"type":15},"Web Development","web-development","2026-07-15T06:03:29.216359",{"slug":3473,"name":3473,"fn":3474,"description":3475,"org":3476,"tags":3477,"stars":19,"repoUrl":20,"updatedAt":3481},"binlog-failure-analysis","analyze MSBuild binary logs","Analyze MSBuild binary logs to diagnose build failures. USE FOR: build errors that are unclear from console output, diagnosing cascading failures across multi-project builds, tracing MSBuild target execution order, and generally any MSBuild build issues. Requires an existing .binlog file. DO NOT USE FOR: generating binlogs (use binlog-generation), non-MSBuild build systems.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3478,3479,3480],{"name":17,"slug":18,"type":15},{"name":3401,"slug":3402,"type":15},{"name":3417,"slug":3418,"type":15},"2026-07-12T08:21:34.637923",{"slug":3483,"name":3483,"fn":3484,"description":3485,"org":3486,"tags":3487,"stars":19,"repoUrl":20,"updatedAt":3493},"binlog-generation","generate MSBuild binary logs for diagnostics","Generate MSBuild binary logs (binlogs) for build diagnostics and analysis. USE FOR: adding \u002Fbl:{} to any dotnet build, test, pack, publish, or restore command to capture a full build execution trace, prerequisite for binlog-failure-analysis and build-perf-diagnostics skills, enabling post-build investigation of errors or performance. Requires MSBuild 17.8+ \u002F .NET 8 SDK+ for {} placeholder; PowerShell needs -bl:{{}}. DO NOT USE FOR: non-MSBuild build systems (npm, Maven, CMake), analyzing an existing binlog (use binlog-failure-analysis instead).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3488,3491,3492],{"name":3489,"slug":3490,"type":15},"Build","build",{"name":3401,"slug":3402,"type":15},{"name":13,"slug":14,"type":15},"2026-07-19T05:38:19.340791",{"slug":3495,"name":3495,"fn":3496,"description":3497,"org":3498,"tags":3499,"stars":19,"repoUrl":20,"updatedAt":3503},"build-parallelism","optimize MSBuild build parallelism","Diagnose and fix under-parallelized MSBuild builds. USE WHEN a multi-project solution build is slower than expected, doesn't speed up when you add cores, pegs a single core while others idle, or you want to know why `-m` isn't helping. Note: `\u002Fmaxcpucount` default is 1 (sequential) — always pass `-m` for parallel builds. Covers finding the critical path (longest serial ProjectReference chain), graph build (`\u002Fgraph`), BuildInParallel, and solution filters (`.slnf`). DO NOT USE FOR: single-project builds, incremental issues (use incremental-build), compilation slowness inside one project (use build-perf-diagnostics), non-MSBuild build systems.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3500,3501,3502],{"name":3383,"slug":3384,"type":15},{"name":13,"slug":14,"type":15},{"name":3387,"slug":3388,"type":15},"2026-07-19T05:38:18.364937",{"slug":3505,"name":3505,"fn":3506,"description":3507,"org":3508,"tags":3509,"stars":19,"repoUrl":20,"updatedAt":3516},"build-perf-baseline","establish and optimize build performance baselines","Establish build performance baselines and apply systematic optimization techniques. USE FOR: diagnosing slow builds, establishing before\u002Fafter measurements (cold, warm, no-op scenarios), applying optimization strategies like MSBuild Server, static graph builds, artifacts output, and dependency graph trimming. Start here before diving into build-perf-diagnostics, incremental-build, or build-parallelism. DO NOT USE FOR: non-MSBuild build systems, detailed bottleneck analysis (use build-perf-diagnostics after baselining).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3510,3511,3514,3515],{"name":13,"slug":14,"type":15},{"name":3512,"slug":3513,"type":15},"Monitoring","monitoring",{"name":3387,"slug":3388,"type":15},{"name":3449,"slug":3450,"type":15},"2026-07-12T08:21:35.865649",{"slug":3518,"name":3518,"fn":3519,"description":3520,"org":3521,"tags":3522,"stars":19,"repoUrl":20,"updatedAt":3527},"build-perf-diagnostics","diagnose MSBuild build performance bottlenecks","Diagnose MSBuild build performance bottlenecks using binary log analysis. USE FOR: identifying why builds are slow by analyzing binlog performance summaries, detecting ResolveAssemblyReference (RAR) taking >5s, Roslyn analyzers consuming >30% of Csc time, single targets dominating >50% of build time, node utilization below 80%, excessive Copy tasks, NuGet restore running every build. Covers timeline analysis, Target\u002FTask Performance Summary interpretation, and 7 common bottleneck categories. Use after build-perf-baseline has established measurements. DO NOT USE FOR: establishing initial baselines (use build-perf-baseline first), fixing incremental build issues (use incremental-build), parallelism tuning (use build-parallelism), non-MSBuild build systems.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3523,3524,3525,3526],{"name":3383,"slug":3384,"type":15},{"name":3401,"slug":3402,"type":15},{"name":13,"slug":14,"type":15},{"name":3387,"slug":3388,"type":15},"2026-07-12T08:21:40.961722",{"slug":3529,"name":3529,"fn":3530,"description":3531,"org":3532,"tags":3533,"stars":19,"repoUrl":20,"updatedAt":3537},"check-bin-obj-clash","detect MSBuild output path conflicts","Detects MSBuild projects with conflicting OutputPath or IntermediateOutputPath. USE FOR: builds failing with 'Cannot create a file when that file already exists', 'The process cannot access the file because it is being used by another process', intermittent build failures that succeed on retry, or missing\u002Foverwritten outputs in multi-project or multi-targeting builds where bin\u002Fobj (or project.assets.json) collide. Common causes: shared OutputPath, missing AppendTargetFrameworkToOutputPath, extra global properties (e.g. PublishReadyToRun), or SetTargetFramework on a ProjectReference to a single-targeting project. DO NOT USE FOR: file access errors unrelated to MSBuild (OS-level locking), single-project single-TFM builds, non-MSBuild build systems.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3534,3535,3536],{"name":3401,"slug":3402,"type":15},{"name":13,"slug":14,"type":15},{"name":3446,"slug":3447,"type":15},"2026-07-19T05:38:14.336279",144,{"items":3540,"total":3589},[3541,3548,3555,3563,3569,3577,3583],{"slug":3393,"name":3393,"fn":3394,"description":3395,"org":3542,"tags":3543,"stars":19,"repoUrl":20,"updatedAt":3404},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3544,3545,3546,3547],{"name":3383,"slug":3384,"type":15},{"name":17,"slug":18,"type":15},{"name":3401,"slug":3402,"type":15},{"name":3387,"slug":3388,"type":15},{"slug":3406,"name":3406,"fn":3407,"description":3408,"org":3549,"tags":3550,"stars":19,"repoUrl":20,"updatedAt":3419},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3551,3552,3553,3554],{"name":3383,"slug":3384,"type":15},{"name":3413,"slug":3414,"type":15},{"name":3401,"slug":3402,"type":15},{"name":3417,"slug":3418,"type":15},{"slug":3421,"name":3421,"fn":3422,"description":3423,"org":3556,"tags":3557,"stars":19,"repoUrl":20,"updatedAt":3437},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3558,3559,3560,3561,3562],{"name":3383,"slug":3384,"type":15},{"name":3401,"slug":3402,"type":15},{"name":3429,"slug":3430,"type":15},{"name":3432,"slug":3433,"type":15},{"name":3435,"slug":3436,"type":15},{"slug":3439,"name":3439,"fn":3440,"description":3441,"org":3564,"tags":3565,"stars":19,"repoUrl":20,"updatedAt":3451},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3566,3567,3568],{"name":17,"slug":18,"type":15},{"name":3446,"slug":3447,"type":15},{"name":3449,"slug":3450,"type":15},{"slug":3453,"name":3453,"fn":3454,"description":3455,"org":3570,"tags":3571,"stars":19,"repoUrl":20,"updatedAt":3471},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3572,3573,3574,3575,3576],{"name":3383,"slug":3384,"type":15},{"name":3460,"slug":3461,"type":15},{"name":3463,"slug":3464,"type":15},{"name":3466,"slug":3467,"type":15},{"name":3469,"slug":3470,"type":15},{"slug":3473,"name":3473,"fn":3474,"description":3475,"org":3578,"tags":3579,"stars":19,"repoUrl":20,"updatedAt":3481},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3580,3581,3582],{"name":17,"slug":18,"type":15},{"name":3401,"slug":3402,"type":15},{"name":3417,"slug":3418,"type":15},{"slug":3483,"name":3483,"fn":3484,"description":3485,"org":3584,"tags":3585,"stars":19,"repoUrl":20,"updatedAt":3493},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3586,3587,3588],{"name":3489,"slug":3490,"type":15},{"name":3401,"slug":3402,"type":15},{"name":13,"slug":14,"type":15},96]