Copilot code review: Path-scoped custom instruction file support
Copilot code review is becoming even more customizable! You can now use your existing path-scoped instruction files to provide targeted guidance for specific parts of your repository. Plus we have a few other important updates for you to know about. 👇
Path-scoped instruction files now supported in Copilot code review
Copilot code review now recognizes *.instructions.md
files with an applyTo
section, making it easier to give code review guidance for specific files or directories in your repository. Path-scoped instruction files have been supported for other Copilot features for a while. Now Copilot code review will also use these files in addition to your repository-wide copilot-instructions.md
to deliver more focused, relevant feedback in pull requests.
This means you can:
- Scope guidance to individual areas, like
frontend
orsecurity
, with separate*.instructions.md
files. - Use an
applyTo
section with path globs to target exactly where each instruction applies — files withoutapplyTo
are ignored. - Maintain concise, purpose-driven instructions for each part of your codebase.
Quick start
- Create or update a file such as
frontend.instructions.md
within the.github/instructions
directory in a repository. - Add an
applyTo:
section with one or more path globs (e.g.,webapp/src/**
). - Add concise, self-contained guidance.
- Commit and open or update a pull request that touches a matching path — Copilot code review will use the relevant instructions.
Example:
# frontend.instructions.md
applyTo:
- webapp/src/**
- ui/components/**
---
Emphasize accessibility (ARIA, focus management). Prefer design tokens. Flag deprecated components under `legacy/`.
For more details, check the documentation for Copilot custom instructions.
More customization updates
Organization-level instructions now supported in Copilot code review
Organization-level instructions are now also considered by Copilot code review. If your organization already maintains org-level instructions, these will now be automatically included when generating review feedback for pull requests. This helps ensure your coding standards and best practices are consistently applied across all your repositories.
Coding guidelines deprecation
Earlier, we announced that the coding guidelines feature (previously in private preview for Copilot Enterprise) was being partially deprecated. Today, we’re completely deprecating the feature. Going forward, add all your customization specifications to copilot-instructions.md
or *.instructions.md
files.
Join the discussion within GitHub Community.