feat(docs): add design principles, globalization, performance, securi…#6217
Merged
yeelam-gordon merged 1 commit intouser/muyuanli/dotnetnewtemplatefrom Feb 14, 2026
Merged
Conversation
…ty, and testing guidelines
MuyuanMS
approved these changes
Feb 14, 2026
d88c7a6
into
user/muyuanli/dotnetnewtemplate
1 check passed
DinahK-2SO
pushed a commit
that referenced
this pull request
Apr 20, 2026
…ty, and testing guidelines (#6217)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Important to read
With this instruction, when I start GitHub Copilot in this new project:
In contrast, WITHOUT instructions, I ask the exact same questions:
Summary of this change
This pull request adds comprehensive agent instructions and detailed best-practice guides for WinUI 3 / Windows App SDK C# project templates. The main changes introduce a structured set of markdown instruction files covering design principles, code quality, accessibility, and more. These documents are included in the template package so that agents and developers have clear, authoritative guidance for every aspect of development and review.
Addition of agent instructions and best-practice documentation:
Agents.md, a central guide for agents working on WinUI 3/Windows App SDK projects. It explains how to interpret project configuration, outlines the agent workflow, and provides an index of all instruction files.Agents.mdand those underinstructions/) into the VSIX template output, ensuring they are available with the template content.New instruction documents for best practices:
design-principles.instructions.md, detailing DRY, KISS, SOLID, and YAGNI principles, with rules, anti-patterns, and validation steps.code-quality.instructions.md, covering static analysis, StyleCop, naming conventions, code cleanup, and validation requirements.accessibility.instructions.md, specifying accessibility requirements for UI controls, keyboard navigation, screen readers, and validation checklists.These changes ensure that every code change is guided by clear, enforceable standards for maintainability, accessibility, and code quality, directly within the template package.