mirror of https://github.com/microsoft/PowerToys.git synced 2026-02-23 19:49:43 +01:00

Files

Gordon Lam 0899961e56 Docs: consolidate instructions and fix prompt frontmatter (#44610 )

Title: Docs: consolidate Copilot instructions and prompt metadata

## Summary
- Consolidated AI guidance into a root AGENTS.md and new
`.github/instructions` files, removing older per-folder instructions.
- Scoped instruction files for pipelines, common libraries,
runner/settings UI, prompts, and simplified
`.github/copilot-instructions.md` to point to the sources of truth.
- Fixed prompt frontmatter (YAML markers, quoted fields, headings)
across built-in prompt files.
- Most instructions.md is from https://github.com/github/awesome-copilot

## Testing
- Not run (documentation/instructions-only change)

2026-01-08 20:04:33 +08:00

1.4 KiB

Raw Blame History

description

description
PowerToys AI contributor guidance

PowerToys – Copilot Instructions

Concise guidance for AI contributions. For complete details, see AGENTS.md.

Quick Reference

Build: tools\build\build-essentials.cmd (first time), then tools\build\build.cmd
Tests: Find <Product>*UnitTests project, build it, run via VS Test Explorer
Exit code 0 = success – do not proceed if build fails

Key Rules

One terminal per operation (build → test)
Atomic PRs: one logical change, no drive-by refactors
Add tests when changing behavior
Keep hot paths quiet (no logging in hooks/tight loops)

Style Enforcement

C#: src/.editorconfig, StyleCop.Analyzers
C++: src/.clang-format
XAML: XamlStyler

When to Ask for Clarification

Ambiguous spec after scanning docs
Cross-module impact unclear
Security, elevation, or installer changes

Component-Specific Instructions

These are auto-applied based on file location:

Detailed Documentation

AGENTS.md – Full contributor guide
Build Guidelines
Architecture
Coding Style

1.4 KiB Raw Blame History Unescape Escape