Skip to content

Add .github/copilot-instructions.md for Copilot cloud agent onboarding#58

Merged
josesimoes merged 1 commit intomainfrom
copilot/add-copilot-instructions
Apr 8, 2026
Merged

Add .github/copilot-instructions.md for Copilot cloud agent onboarding#58
josesimoes merged 1 commit intomainfrom
copilot/add-copilot-instructions

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 8, 2026

Adds a copilot-instructions.md to give Copilot cloud agents the context needed to work effectively in this repo without trial-and-error discovery.

Key contents

  • Platform constraints — nanoFramework's critical API differences from standard .NET: no generics (all Type-based), no struct/array constructor params in DI, limited reflection, ArrayList/Hashtable instead of generic collections
  • Build environment warning.nfproj files require the nanoFramework MSBuild extensions on Windows; the agent's Linux environment cannot compile or run tests. Documents what is still actionable (source edits, docs, workflows, packages.config) vs. what must be validated by Azure Pipelines CI
  • TestingnanoFramework.TestFramework usage (not MSTest/xUnit), nanoCLR simulator setup via nano.runsettings, assertion API
  • Package management — Old-style packages.config format, packages.lock.json enforcement in CI, and that lock files must be regenerated on Windows after version bumps
  • Known issues — Struct DI limitation (tracked issue), GetImplementationType() gap with factory registrations, array constructor param null exception
  • Repository map — Full directory layout, CI/CD topology (Azure Pipelines primary, GitHub Actions for PR checks), versioning via Nerdbank.GitVersioning

@josesimoes josesimoes marked this pull request as ready for review April 8, 2026 02:12
@josesimoes josesimoes merged commit 552d0d2 into main Apr 8, 2026
3 of 5 checks passed
@josesimoes josesimoes deleted the copilot/add-copilot-instructions branch April 8, 2026 02:13
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented Apr 8, 2026

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.

2 participants