ElBruno.ModelContextProtocol: Instructions file for GitHub Copilot

ElBruno .NET Repository Conventions

These instructions define the conventions for ElBruno's .NET NuGet library repositories. Apply them when creating, modifying, or reviewing any project in this repo.

---

Repository Structure

{ProjectName}/
├── README.md                    # Project overview, badges, quick start
├── LICENSE                      # MIT License
├── Directory.Build.props        # Shared MSBuild properties (all projects)
├── global.json                  # SDK version with rollForward
├── .gitignore                   # .NET + IDE + OS ignores
├── {ProjectName}.slnx           # XML-based solution file
├── src/
│   ├── {Owner}.{ProjectName}.{Package}/   # Library projects
│   ├── tests/{Package}.Tests/             # xUnit test projects
│   └── samples/{SampleName}/              # Sample/demo apps
├── docs/                        # All documentation except README.md and LICENSE
├── images/                      # All images including nuget_logo.png
└── .github/workflows/           # CI/CD workflows

• Root files only: README.md, LICENSE, Directory.Build.props, global.json, .gitignore, solution file
• All source code (libraries, tests, samples) lives under src/
• All documentation (except README.md and LICENSE) lives under docs/
• All images live under images/, including nuget_logo.png for NuGet packages

---

Solution Format

• Use .slnx (XML-based solution format), not .sln
• All projects (libraries, tests, samples) must be included in the solution file
• Use <Folder> elements for logical grouping: /src/, /src/tests/, /src/samples/

---

Project Conventions

Library Projects

• Target net8.0;net10.0 (multi-target: LTS + latest)
• Package naming: {Owner}.{ProjectName}.{Feature} (e.g., ElBruno.QRCodeGenerator.Svg)
• Each packable project must include the NuGet icon:

  <None Include="$(MSBuildThisFileDirectory)..\..\images\nuget_logo.png" Pack="true" PackagePath="" />
  

• Include <InternalsVisibleTo> for the corresponding test project
• Enable symbol packages: <IncludeSymbols>true</IncludeSymbols>, <SymbolPackageFormat>snupkg</SymbolPackageFormat>
• Enable deterministic CI builds: <ContinuousIntegrationBuild Condition="'$(GITHUB_ACTIONS)' == 'true'">true</ContinuousIntegrationBuild>