powerplatform-vibecoding-samples: Instructions file for GitHub Copilot

GitHub Copilot Instructions for Dataverse Plugin Development

These are special instructions for GitHub Copilot (Agent Mode) to follow when helping with Dataverse plugin development.

---

📌 Project Context

• This repository is for Dataverse plugin development.
• The code is written in C# (.NET Framework 4.6.2).
• Plugins are deployed as NuGet packages using Power Platform CLI (PAC), not Plugin Registration Tool (PRT).
• The project uses early bound classes generated with pac modelbuilder build.
• We use Visual Studio Code as the main IDE.
• CRITICAL: Always use pac plugin init to create plugin projects and ensure all plugins extend the generated PluginBase.cs class.

---

📁 Project Structure

Each plugin project should follow this standard folder structure:

Plugins/
└── {ProjectName}/
    ├── {ProjectName}.csproj          # Project file with NuGet package configuration
    ├── {ProjectName}.snk             # Strong name key file for assembly signing
    ├── PluginBase.cs                 # Generated base class from pac plugin init
    ├── Models/                       # Early-bound entity classes
    │   ├── Entities/                 # Generated entity classes
    │   ├── OptionSets/               # Generated option set classes
    │   └── EntityOptionSetEnum.cs    # Option set enumeration
    ├── Helpers/                      # Reusable helper classes
    │   ├── EnvironmentVariableHelper.cs
    │   ├── BusinessUnitHelper.cs
    │   ├── TeamHelper.cs
    │   ├── SecurityRoleHelper.cs
    │   └── CommonHelper.cs
    └── Plugins/                      # Plugin implementations
        ├── EntityNameCreatePlugin.cs
        ├── EntityNameUpdatePlugin.cs
        └── ...

Project File (.csproj) Configuration

The .csproj file must include:

• Target Framework: net462
• Assembly Signing: Strong name key file
• NuGet Package Configuration: PackageId, Version, Authors, Company, Description
• Required NuGet Packages:
  • Microsoft.CrmSdk.CoreAssemblies (version 9.0.2.*)
  • Microsoft.PowerApps.MSBuild.Plugin (version 1.*)
  • Microsoft.NETFramework.ReferenceAssemblies (version 1.0.*)