Skip to content

Add AGENTS.md and per-TFM MSBuild loader skills - #381

Merged
Rainer Sigwald (rainersigwald) merged 19 commits into
mainfrom
agent-instructions
Aug 28, 2026
Merged

Add AGENTS.md and per-TFM MSBuild loader skills#381
Rainer Sigwald (rainersigwald) merged 19 commits into
mainfrom
agent-instructions

Conversation

@rainersigwald

@rainersigwald Rainer Sigwald (rainersigwald) commented Jun 4, 2026

Copy link
Copy Markdown
Member

Why

MSBuildLocator's implementation forks heavily between net46 (Visual Studio) and net8.0 (.NET SDK). This PR adds Copilot agent instructions and splits the documentation into an always-loaded base file and two on-demand skills to prevent context bloat and confusion between the frameworks.

What's added

  • AGENTS.md: Core repository context, build/test commands, conventions, and the cross-TFM register-before-load contract.
  • msbuild-loader-netcore skill: net8.0 / NETCOREAPP specifics (AssemblyLoadContext, hostfxr SDK discovery, probe order, SDK environment variables).
  • msbuild-loader-netframework skill: net46 specifics (AppDomain.AssemblyResolve, Developer Console / VS Setup COM discovery).

Notes

  • Content was LLM-verified against the source code and official MSBuild documentation.
  • Documentation only; no code changes.
  • I did AGENTS.md pretty manually but the skills are generated.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Test class is QueryInstancesTests (plural); the singular form did not
  substring-match in dotnet test --filter.
- Unregister() is a documented no-op kept only for back-compat; calling
  the section 'register/unregister' suggested behavior that does not exist.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The AssemblyLoadContext-vs-AppDomain handler split, the ResolveDotnetPathCandidates
probe order, the hostfxr API names, the VS Setup COM details, and the net46-vs-netcore
gating for VisualStudioLocationHelper are already covered in the two loader skill
files. Keeping them in AGENTS.md as well burns the always-loaded context budget for
work that only touches one TFM. Replace the per-TFM lines with pointers to the
relevant skill while keeping the multi-targeting heads-up (TFM list + conditional
compilation constants) so agents still know to check both forks.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

@OvesN Veronika Ovsyannikova (OvesN) left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we want to treat SKILL.md also as a documentation, I would expand it a little bit.

Comment thread .agents/skills/msbuild-loader-netframework/SKILL.md Outdated
Comment thread .agents/skills/msbuild-loader-netcore/SKILL.md
Comment thread AGENTS.md
Comment thread .agents/skills/msbuild-loader-netcore/SKILL.md
Comment thread AGENTS.md Outdated
Comment thread .agents/skills/msbuild-loader-netcore/SKILL.md
Comment thread .agents/skills/msbuild-loader-netframework/SKILL.md Outdated
Clarified platform-specific code requirements for .NET SDK discovery.
Split the props/targets guidance into the core no-copy rule and keeping the target's package list in sync.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 2b3282da-484d-4b88-8a92-e2db9c2dac8e
…uildLocator into agent-instructions

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 2b3282da-484d-4b88-8a92-e2db9c2dac8e

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds repository-wide Copilot guidance and targeted documentation for each MSBuild loader implementation.

Changes:

  • Documents repository architecture, workflows, and conventions.
  • Adds .NET SDK loader guidance.
  • Adds .NET Framework and Visual Studio loader guidance.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
AGENTS.md Adds shared repository instructions.
.agents/skills/msbuild-loader-netcore/SKILL.md Documents net8.0 SDK discovery and loading.
.agents/skills/msbuild-loader-netframework/SKILL.md Documents net46 Visual Studio discovery and loading.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread .agents/skills/msbuild-loader-netcore/SKILL.md Outdated
Comment thread .agents/skills/msbuild-loader-netframework/SKILL.md
Comment thread .agents/skills/msbuild-loader-netframework/SKILL.md Outdated
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 2b3282da-484d-4b88-8a92-e2db9c2dac8e
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 2b3282da-484d-4b88-8a92-e2db9c2dac8e
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 2b3282da-484d-4b88-8a92-e2db9c2dac8e
Comment thread .agents/skills/msbuild-loader-netcore/SKILL.md Outdated
Comment thread AGENTS.md Outdated
@rainersigwald
Rainer Sigwald (rainersigwald) merged commit 277dd0d into main Aug 28, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants