1  ---
 2  description: 'PowerToys AI contributor guidance'
 3  ---
 4  
 5  # PowerToys – Copilot Instructions
 6  
 7  Concise guidance for AI contributions. For complete details, see [AGENTS.md](../AGENTS.md).
 8  
 9  ## Key Rules
10  
11  - Atomic PRs: one logical change, no drive-by refactors
12  - Add tests when changing behavior
13  - Keep hot paths quiet (no logging in hooks/tight loops)
14  
15  ## Style Enforcement
16  
17  - C#: `src/.editorconfig`, StyleCop.Analyzers
18  - C++: `src/.clang-format`
19  - XAML: XamlStyler
20  
21  ## When to Ask for Clarification
22  
23  - Ambiguous spec after scanning docs
24  - Cross-module impact unclear
25  - Security, elevation, or installer changes
26  
27  ## Component-Specific Instructions
28  
29  These are auto-applied based on file location:
30  - [Runner & Settings UI](.github/instructions/runner-settings-ui.instructions.md)
31  - [Common Libraries](.github/instructions/common-libraries.instructions.md)
32  
33  ## Detailed Documentation
34  
35  - [Architecture](../doc/devdocs/core/architecture.md)
36  - [Coding Style](../doc/devdocs/development/style.md)