Summary
Add Agentic AI development assets so that GitHub Copilot (agent mode) and other AI coding agents can build, test, and contribute to this repository correctly — following DSC Community conventions and FSRMDsc-specific patterns.
Files to create
1. AGENTS.md (repository root)
- Repository overview — File Server Resource Manager (FSRM) DSC resources, supported Windows Server versions
- Resource type — MOF-based resources in
source/DSCResources/
- Build commands:
./build.ps1 -Tasks noop # one-time setup per pwsh session
./build.ps1 -Tasks build
Invoke-Pester -Path 'tests/Unit' -Output Detailed
- Never run integration tests locally — CI only
- DSC Community resources — Guidelines, Blog Posts
2. tests/AGENTS.md
- Pester 5 syntax required; Pester 4 must not be used
Should -Invoke, Should -BeTrue, BeforeDiscovery, $PSDefaultParameterValues
- Unit tests:
tests/Unit/DSCResources/; Integration tests: tests/Integration/ (CI only)
3. .github/copilot-instructions.md
4. .github/instructions/*.instructions.md
| New file |
Adaptations |
dsc-community-style-guidelines.instructions.md |
DSCResources layout; MOF-only |
dsc-community-style-guidelines-mof-resources.instructions.md |
Copy as-is |
dsc-community-style-guidelines-pester.instructions.md |
Copy as-is |
dsc-community-style-guidelines-unit-tests.instructions.md |
FSRMDsc; tests/Unit/DSCResources/; no SMO |
dsc-community-style-guidelines-integration-tests.instructions.md |
FSRMDsc; tests/Integration/; no SQL CI notes |
dsc-community-style-guidelines-powershell.instructions.md |
Copy as-is |
dsc-community-style-guidelines-localization.instructions.md |
MOF resource string paths |
dsc-community-style-guidelines-changelog.instructions.md |
dsccommunity/FSRMDsc repo URL |
dsc-community-style-guidelines-markdown.instructions.md |
Copy as-is |
FSRMDsc-guidelines.instructions.md |
FSRMDsc-specific: build/test workflow, MOF naming, no SQL/SMO; applyTo: "**" |
Acceptance criteria
References
Summary
Add Agentic AI development assets so that GitHub Copilot (agent mode) and other AI coding agents can build, test, and contribute to this repository correctly — following DSC Community conventions and FSRMDsc-specific patterns.
Files to create
1.
AGENTS.md(repository root)source/DSCResources/2.
tests/AGENTS.mdShould -Invoke,Should -BeTrue,BeforeDiscovery,$PSDefaultParameterValuestests/Unit/DSCResources/; Integration tests:tests/Integration/(CI only)3.
.github/copilot-instructions.md4.
.github/instructions/*.instructions.mddsc-community-style-guidelines.instructions.mddsc-community-style-guidelines-mof-resources.instructions.mddsc-community-style-guidelines-pester.instructions.mddsc-community-style-guidelines-unit-tests.instructions.mdFSRMDsc;tests/Unit/DSCResources/; no SMOdsc-community-style-guidelines-integration-tests.instructions.mdFSRMDsc;tests/Integration/; no SQL CI notesdsc-community-style-guidelines-powershell.instructions.mddsc-community-style-guidelines-localization.instructions.mddsc-community-style-guidelines-changelog.instructions.mddsccommunity/FSRMDscrepo URLdsc-community-style-guidelines-markdown.instructions.mdFSRMDsc-guidelines.instructions.mdapplyTo: "**"Acceptance criteria
AGENTS.mdcreated at repository roottests/AGENTS.mdcreated.github/copilot-instructions.mdcreated.github/instructions/*.instructions.mdfiles created with no SQL Server–specific contentReferences