{"id":92281,"date":"2025-11-14T09:00:00","date_gmt":"2025-11-14T17:00:00","guid":{"rendered":"https:\/\/github.blog\/?p=92281"},"modified":"2026-04-17T14:04:57","modified_gmt":"2026-04-17T21:04:57","slug":"unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files","status":"publish","type":"post","link":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/","title":{"rendered":"Unlocking the full power of Copilot code review: Master your instructions files"},"content":{"rendered":"<!DOCTYPE html PUBLIC \"-\/\/W3C\/\/DTD HTML 4.0 Transitional\/\/EN\" \"http:\/\/www.w3.org\/TR\/REC-html40\/loose.dtd\">\n<html><body><p>Copilot code review (CCR) helps you automate code reviews and ensure your project meets your team&rsquo;s standards. We recently added support for both <code>copilot-instructions.md<\/code> and path-specific <code>*.instructions.md<\/code> files, so now you can customize Copilot&rsquo;s behavior to fit your workflow. This flexibility empowers you to guide Copilot with clear, actionable rules for effective and consistent reviews.<\/p>\n\n\n\n<p>But with this flexibility comes some uncertainty:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>When is Copilot code review reading your instructions?<\/li>\n\n\n\n<li>Why doesn&rsquo;t it always follow your instructions exactly?<\/li>\n\n\n\n<li>How can you ensure Copilot code review listens to your guidance?<\/li>\n<\/ul>\n\n\n\n<p>While you can format your instructions file however you want, Copilot code review is non-deterministic and has specific limitations that will evolve as we improve the product. Understanding how to guide Copilot within its current capabilities is key to getting the most from your reviews.<\/p>\n\n\n\n<p>After reviewing many instructions files, common questions, and feedback, we&rsquo;ve created this guide to help you write instructions that really work&mdash;and avoid some pitfalls along the way.<\/p>\n\n\n\n<p>&#9888;&#65039; Note: While these tips are designed for Copilot code review, you might find some of them useful when writing instructions files for other Copilot products.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-general-tips\">General tips<\/h2>\n\n\n\n<p>Getting started is the hardest part. Here are some things to keep in mind when starting with your instructions.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Keep it concise: <\/strong>Copilot works best with focused, short instructions. Start small and iterate. Even a single line can help guide Copilot. On the flip side, long instructions files (over ~1,000 lines) can lead to inconsistent behavior.<\/li>\n\n\n\n<li><strong>Structure matters: <\/strong>Use headings and bullet points to keep information organized and easy for Copilot to process.<\/li>\n\n\n\n<li><strong>Be direct: <\/strong>Short, imperative rules are more effective than long paragraphs.<\/li>\n\n\n\n<li><strong>Show examples: <\/strong>Demonstrate concepts with sample code or explanations&mdash;just like you would with a teammate.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"repo-wide-vs-path-specific-instructions\">Repo-wide vs. path-specific instructions<\/h2>\n\n\n\n<p>In addition to the centralized repo-wide <code>copilot-instructions.md<\/code> file, we recently expanded your customization options by enabling Copilot code review to read any <code>NAME.instructions.md<\/code> file with an <code>applyTo<\/code> frontmatter in your <code>.github\/instructions<\/code> directory. It can be confusing to have two seemingly similar options for customization, but each provides different value! Here are some tips for how to differentiate between the two, and use them both effectively.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Place language-specific rules in <code>*.instructions.md<\/code> files and then use the <code>applyTo<\/code> frontmatter property to target specific languages (e.g., <code>applyTo: **\/*.py<\/code> or <code>applyTo: documentation\/*.md<\/code>).<\/li>\n\n\n\n<li>Place rules meant specifically for only Copilot code review or only Copilot coding agent in <code>*.instructions.md<\/code> files, and use the <code>excludeAgent<\/code> frontmatter property to prevent either agent from reading your file.<\/li>\n\n\n\n<li>Organize different topics (e.g., security, language-specific guidelines, etc.) into separate <code>*.instructions.md<\/code> files.<\/li>\n\n\n\n<li>Reserve general instructions, team standards, and guidelines for the whole repository for <code>copilot-instructions.md<\/code> (e.g., &ldquo;Flag use of deprecated libraries across the codebase&rdquo;).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"rules-of-thumb\">Rules of thumb<\/h2>\n\n\n\n<p>Effective instructions files often include:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Clear titles<\/li>\n\n\n\n<li>A purpose or scope statement to clarify intent<\/li>\n\n\n\n<li>Lists of guidelines\/rules instead of dense paragraphs<\/li>\n\n\n\n<li>Best practice recommendations<\/li>\n\n\n\n<li>Style conventions (indentation, naming, organization)<\/li>\n\n\n\n<li>Sample code blocks for clarification<\/li>\n\n\n\n<li>Section headings for organization<\/li>\n\n\n\n<li>Task-specific instructions (e.g., for tests or endpoints)<\/li>\n\n\n\n<li>Language\/tooling context<\/li>\n\n\n\n<li>Emphasis on readability and consistency<\/li>\n\n\n\n<li>Explicit directives for Copilot (&ldquo;Prefer X over Y&rdquo;)<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"what-not-to-do\">What not to do<\/h2>\n\n\n\n<p>Certain types of instructions aren&rsquo;t supported by Copilot code review. Here are common pitfalls to avoid:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Trying to <strong>change the UX or formatting of Copilot comments<\/strong> (e.g., &ldquo;Change the font of Copilot code review comments&rdquo;).<\/li>\n\n\n\n<li>Trying to<strong> modify the &ldquo;Pull Request Overview&rdquo; comment <\/strong>(e.g. prompting to remove it or change its purpose to be something other than provide an overview of the pull request).<\/li>\n\n\n\n<li>Requesting Copilot code review <strong>performs tasks outside of code review<\/strong>. (e.g., trying to modify the product behavior like asking it to block a pull request from merging).<\/li>\n\n\n\n<li>Including <strong>external links. <\/strong>Copilot won&rsquo;t follow them. You should copy relevant info into your instructions files instead.<\/li>\n\n\n\n<li>Adding <strong>requests meant to generally and non-specifically improve behavior <\/strong>(e.g., &ldquo;Be more accurate&rdquo; or &ldquo;Identify all issues&rdquo;). Copilot code review is already tuned to do this and adding language like this adds more noise that confuses the LLM.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"recommended-structure-for-instructions-files\">Recommended structure for instructions files<\/h2>\n\n\n\n<p>Starting off with a blank Markdown file can feel daunting. Here&rsquo;s one structure that you can use, ready to copy-paste into your instructions file as a starting point! <\/p>\n\n\n<div class=\"wp-block-code-wrapper\">\n<pre class=\"wp-block-code\"><code># [Your Title Here]\n*Example: ReactJS Development Guidelines*\n\n## Purpose &amp; Scope\nBriefly describe what this file covers and when to use it.\n\n---\n\n## Naming Conventions\n- [Add rules here, e.g., \"Use camelCase for variable names.\"]\n\n## Code Style\n- [Add rules here, e.g., \"Indent using 2 spaces.\"]\n\n## Error Handling\n- [Add rules here.]\n\n## Testing\n- [Add rules here.]\n\n## Security\n- [Add rules here.]\n\n---\n\n## Code Examples\n```js\n\/\/ Correct pattern\nfunction myFunction() { ... }\n\n\/\/ Incorrect pattern\nfunction My_function() { ... }\n```\n\n---\n\n## [Optional] Task-Specific or Advanced Sections\n\n### Framework-Specific Rules\n- [Add any relevant rules for frameworks, libraries, or tooling.]\n\n### Advanced Tips &amp; Edge Cases\n- [Document exceptions, advanced patterns, or important caveats.]<\/code><\/pre>\n<clipboard-copy aria-label=\"Copy\" class=\"code-copy-btn\" data-copy-feedback=\"Copied!\" value='# [Your Title Here]\n*Example: ReactJS Development Guidelines*\n\n## Purpose &amp; Scope\nBriefly describe what this file covers and when to use it.\n\n---\n\n## Naming Conventions\n- [Add rules here, e.g., \"Use camelCase for variable names.\"]\n\n## Code Style\n- [Add rules here, e.g., \"Indent using 2 spaces.\"]\n\n## Error Handling\n- [Add rules here.]\n\n## Testing\n- [Add rules here.]\n\n## Security\n- [Add rules here.]\n\n---\n\n## Code Examples\n```js\n\/\/ Correct pattern\nfunction myFunction() { ... }\n\n\/\/ Incorrect pattern\nfunction My_function() { ... }\n```\n\n---\n\n## [Optional] Task-Specific or Advanced Sections\n\n### Framework-Specific Rules\n- [Add any relevant rules for frameworks, libraries, or tooling.]\n\n### Advanced Tips &amp; Edge Cases\n- [Document exceptions, advanced patterns, or important caveats.]' tabindex=\"0\" role=\"button\"><svg aria-hidden=\"true\" height=\"16\" viewbox=\"0 0 16 16\" version=\"1.1\" width=\"16\" class=\"octicon octicon-copy js-clipboard-copy-icon\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"><\/path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"><\/path><\/svg><svg aria-hidden=\"true\" height=\"16\" viewbox=\"0 0 16 16\" version=\"1.1\" width=\"16\" class=\"octicon octicon-check js-clipboard-check-icon\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"><\/path><\/svg><\/clipboard-copy><\/div>\n\n\n<h2 class=\"wp-block-heading\" id=\"h-example-a-typescript-instructions-md-file\">Example: A <code>typescript.instructions.md<\/code> file<\/h2>\n\n\n\n<p>Now let&rsquo;s implement all of these guidelines in an example path-specific instruction file.<\/p>\n\n\n<div class=\"wp-block-code-wrapper\">\n<pre class=\"wp-block-code\"><code>---\napplyTo: \"**\/*.ts\"\n---\n# TypeScript Coding Standards\nThis file defines our TypeScript coding conventions for Copilot code review.\n\n## Naming Conventions\n\n- Use `camelCase` for variables and functions.\n- Use `PascalCase` for class and interface names.\n- Prefix private variables with `_`.\n\n## Code Style\n\n- Prefer `const` over `let` when variables are not reassigned.\n- Use arrow functions for anonymous callbacks.\n- Avoid using `any` type; specify more precise types whenever possible.\n- Limit line length to 100 characters.\n\n## Error Handling\n\n- Always handle promise rejections with `try\/catch` or `.catch()`.\n- Use custom error classes for application-specific errors.\n\n## Testing\n\n- Write unit tests for all exported functions.\n- Use [Jest](https:\/\/jestjs.io\/) for all testing.\n- Name test files as `&lt;filename&gt;.test.ts`.\n\n## Example\n\n```typescript\n\/\/ Good\ninterface User {\n  id: number;\n  name: string;\n}\n\nconst fetchUser = async (id: number): Promise&lt;User&gt; =&gt; {\n  try {\n    \/\/ ...fetch logic\n  } catch (error) {\n    \/\/ handle error\n  }\n};\n\n\/\/ Bad\ninterface user {\n  Id: number;\n  Name: string;\n}\n\nasync function FetchUser(Id) {\n  \/\/ ...fetch logic, no error handling\n}<\/code><\/pre>\n<clipboard-copy aria-label=\"Copy\" class=\"code-copy-btn\" data-copy-feedback=\"Copied!\" value='---\napplyTo: \"**\/*.ts\"\n---\n# TypeScript Coding Standards\nThis file defines our TypeScript coding conventions for Copilot code review.\n\n## Naming Conventions\n\n- Use `camelCase` for variables and functions.\n- Use `PascalCase` for class and interface names.\n- Prefix private variables with `_`.\n\n## Code Style\n\n- Prefer `const` over `let` when variables are not reassigned.\n- Use arrow functions for anonymous callbacks.\n- Avoid using `any` type; specify more precise types whenever possible.\n- Limit line length to 100 characters.\n\n## Error Handling\n\n- Always handle promise rejections with `try\/catch` or `.catch()`.\n- Use custom error classes for application-specific errors.\n\n## Testing\n\n- Write unit tests for all exported functions.\n- Use [Jest](https:\/\/jestjs.io\/) for all testing.\n- Name test files as `&lt;filename&gt;.test.ts`.\n\n## Example\n\n```typescript\n\/\/ Good\ninterface User {\n  id: number;\n  name: string;\n}\n\nconst fetchUser = async (id: number): Promise&lt;User&gt; =&gt; {\n  try {\n    \/\/ ...fetch logic\n  } catch (error) {\n    \/\/ handle error\n  }\n};\n\n\/\/ Bad\ninterface user {\n  Id: number;\n  Name: string;\n}\n\nasync function FetchUser(Id) {\n  \/\/ ...fetch logic, no error handling\n}' tabindex=\"0\" role=\"button\"><svg aria-hidden=\"true\" height=\"16\" viewbox=\"0 0 16 16\" version=\"1.1\" width=\"16\" class=\"octicon octicon-copy js-clipboard-copy-icon\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"><\/path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"><\/path><\/svg><svg aria-hidden=\"true\" height=\"16\" viewbox=\"0 0 16 16\" version=\"1.1\" width=\"16\" class=\"octicon octicon-check js-clipboard-check-icon\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"><\/path><\/svg><\/clipboard-copy><\/div>\n\n\n<h2 class=\"wp-block-heading\" id=\"get-started\">Get started<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"getting-started-with-copilot-code-review\">Getting started with Copilot code review<\/h3>\n\n\n\n<p>New to Copilot code review? Get started by <a href=\"https:\/\/docs.github.com\/en\/copilot\/how-tos\/use-copilot-agents\/request-a-code-review\/use-code-review#using-copilot-code-review\">adding Copilot as a reviewer<\/a> to your pull requests!&nbsp;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"adding-new-custom-instructions\">Adding new custom instructions<\/h3>\n\n\n\n<p>Create a <code>copilot-instructions.md<\/code> file in the <code>.github<\/code> directory of your repository, or a path-specific <code>*.instructions.md<\/code> file within the <code>.github\/instructions<\/code> directory in your repository, and use this post and <a href=\"https:\/\/github.com\/github\/awesome-copilot\/tree\/main\/instructions\">examples in the awesome-copilot repository<\/a> for inspiration.<\/p>\n\n\n\n<p>Or just <a href=\"https:\/\/docs.github.com\/en\/copilot\/how-tos\/configure-custom-instructions\/add-repository-instructions#asking-copilot-coding-agent-to-generate-a-copilot-instructionsmd-file\">ask Copilot coding agent<\/a> to generate an instructions file for you, and iterate from there.&nbsp;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"editing-existing-custom-instructions\">Editing existing custom instructions<\/h3>\n\n\n\n<p>Have existing custom instructions for Copilot code review that you think could use some editing after reading this post, but don&rsquo;t know where to begin? Have Copilot coding agent edit your file for you!<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to the agents page at <a href=\"https:\/\/github.com\/copilot\/agents\">github.com\/copilot\/agents<\/a>.<\/li>\n\n\n\n<li>Using the dropdown menu in the prompt field, select the repository and branch where you want Copilot to edit custom instructions.<\/li>\n<\/ol>\n\n\n\n<p>Copy the following prompt, editing it for your use-case as needed. <strong>Make sure to modify the first sentence to specify which instruction files you want it to edit.<\/strong> This prompt will tailor your instructions file for Copilot code review, so it may make unwanted edits if used for instruction files meant for other agents.<\/p>\n\n\n<div class=\"wp-block-code-wrapper\">\n<pre class=\"wp-block-code\"><code>**Prompt for Copilot Coding Agent: Revise My Instructions File**\n\n---\nReview and revise my existing `NAME-OF-INSTRUCTION-FILES` files. Preserve my file's meaning and intention&mdash;do NOT make unnecessary changes or edits. Only make improvements where needed, specifically:\n\n- Remove unsupported or redundant content.  \n  Unsupported content includes:\n  - instructions to change Copilot code review comment formatting (font, font size, adding headers, etc)\n  - instructions to change \"PR Overview\" comment content\n  - instructions for product behavior changes outside of existing code review functionality (like trying to block a pull request from merging)\n  - Vague, non-specific directives like &ldquo;be more accurate&rdquo;, \"identify all issues\" or similar\n  - Directives to &ldquo;follow links&rdquo; or inclusion of any external links\n- Reformat sections for clarity if they do not have any structure. \n  - If my file does not have any structure, reformat into the structure below or similar, depending on the topics covered in the file. \n  - Do not change the intent or substance of the original content unless the content is not supported.\n- Organize content with section headings and bullet points or numbered lists.\n- Add sample code blocks if clarification is needed and they are missing.\n- When applicable, separate language-specific rules into path-specific instructions files with the format `NAME.instructions.md`, with the `applyTo` property, if not already done.\n- If the file is over 4000 characters long, prioritize shortening the file by identifying redundant instructions, instructions that could be summarized, and instructions that can be removed due to being unspported. \n\n**Example Structure:**\n\n# Python Coding Standards\n\nGuidelines for Python code reviews with Copilot.\n\n## Naming Conventions\n\n- Use `snake_case` for functions and variables.\n- Use `PascalCase` for class names.\n\n## Code Style\n\n- Prefer list comprehensions for simple loops.\n- Limit lines to 80 characters.\n\n## Error Handling\n\n- Catch specific exceptions, not bare `except:`.\n- Add error messages when raising exceptions.\n\n## Testing\n\n- Name test files as `test_*.py`.\n- Use `pytest` for tests.\n\n## Example\n\n```python\n# Good\ndef calculate_total(items):\n    return sum(items)\n\n# Bad\ndef CalculateTotal(Items):\n    total = 0\n    for item in Items:\n        total += item\n    return total\n```\n\n---\n\n### Framework-Specific Rules\n- For Django, use class-based views when possible.\n\n### Advanced Tips &amp; Edge Cases\n- Use type hints for function signatures.<\/code><\/pre>\n<clipboard-copy aria-label=\"Copy\" class=\"code-copy-btn\" data-copy-feedback=\"Copied!\" value=\"**Prompt for Copilot Coding Agent: Revise My Instructions File**\n\n---\nReview and revise my existing `NAME-OF-INSTRUCTION-FILES` files. Preserve my file's meaning and intention&mdash;do NOT make unnecessary changes or edits. Only make improvements where needed, specifically:\n\n- Remove unsupported or redundant content.  \n  Unsupported content includes:\n  - instructions to change Copilot code review comment formatting (font, font size, adding headers, etc)\n  - instructions to change &quot;PR Overview&quot; comment content\n  - instructions for product behavior changes outside of existing code review functionality (like trying to block a pull request from merging)\n  - Vague, non-specific directives like &ldquo;be more accurate&rdquo;, &quot;identify all issues&quot; or similar\n  - Directives to &ldquo;follow links&rdquo; or inclusion of any external links\n- Reformat sections for clarity if they do not have any structure. \n  - If my file does not have any structure, reformat into the structure below or similar, depending on the topics covered in the file. \n  - Do not change the intent or substance of the original content unless the content is not supported.\n- Organize content with section headings and bullet points or numbered lists.\n- Add sample code blocks if clarification is needed and they are missing.\n- When applicable, separate language-specific rules into path-specific instructions files with the format `NAME.instructions.md`, with the `applyTo` property, if not already done.\n- If the file is over 4000 characters long, prioritize shortening the file by identifying redundant instructions, instructions that could be summarized, and instructions that can be removed due to being unspported. \n\n**Example Structure:**\n\n# Python Coding Standards\n\nGuidelines for Python code reviews with Copilot.\n\n## Naming Conventions\n\n- Use `snake_case` for functions and variables.\n- Use `PascalCase` for class names.\n\n## Code Style\n\n- Prefer list comprehensions for simple loops.\n- Limit lines to 80 characters.\n\n## Error Handling\n\n- Catch specific exceptions, not bare `except:`.\n- Add error messages when raising exceptions.\n\n## Testing\n\n- Name test files as `test_*.py`.\n- Use `pytest` for tests.\n\n## Example\n\n```python\n# Good\ndef calculate_total(items):\n    return sum(items)\n\n# Bad\ndef CalculateTotal(Items):\n    total = 0\n    for item in Items:\n        total += item\n    return total\n```\n\n---\n\n### Framework-Specific Rules\n- For Django, use class-based views when possible.\n\n### Advanced Tips &amp; Edge Cases\n- Use type hints for function signatures.\" tabindex=\"0\" role=\"button\"><svg aria-hidden=\"true\" height=\"16\" viewbox=\"0 0 16 16\" version=\"1.1\" width=\"16\" class=\"octicon octicon-copy js-clipboard-copy-icon\"><path d=\"M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z\"><\/path><path d=\"M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z\"><\/path><\/svg><svg aria-hidden=\"true\" height=\"16\" viewbox=\"0 0 16 16\" version=\"1.1\" width=\"16\" class=\"octicon octicon-check js-clipboard-check-icon\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"><\/path><\/svg><\/clipboard-copy><\/div>\n\n\n<ol start=\"4\" class=\"wp-block-list\">\n<li>Click <strong>Start task<\/strong> or press <kbd>Return<\/kbd>.<\/li>\n<\/ol>\n\n\n\n<p>Copilot will start a new session, which will appear in the list below the prompt box. Copilot will create a draft pull request, modify your custom instructions, push them to the branch, then add you as a reviewer when it has finished. This will trigger a notification for you.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"resources-to-check-out\">Resources to check out<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/docs.github.com\/en\/copilot\/tutorials\/customization-library\/custom-instructions\/code-reviewer\">Copilot code review custom instructions example in GitHub docs<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/github\/awesome-copilot\/tree\/main\/instructions\">awesome-copilot repository of instructions examples<\/a><\/li>\n<\/ul>\n\n\n\n<p>Customizing with Copilot instructions files makes code review work for you&mdash;give it a try and see the difference in your workflow!<\/p>\n\n\n\n<p><\/p>\n<\/body><\/html>\n","protected":false},"excerpt":{"rendered":"<p>Discover practical tips, examples, and best practices for writing effective instructions files. Whether you\u2019re new or experienced, you\u2019ll find something to level up your code reviews.<\/p>\n","protected":false},"author":2343,"featured_media":90561,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_gh_post_show_toc":"yes","_gh_post_is_no_robots":"","_gh_post_is_featured":"yes","_gh_post_is_excluded":"","_gh_post_is_unlisted":"","_gh_post_related_link_1":"","_gh_post_related_link_2":"","_gh_post_related_link_3":"","_gh_post_sq_img":"https:\/\/github.blog\/wp-content\/uploads\/2024\/10\/205x205-Blog-Featured-Square-Light-Mode-3.png","_gh_post_sq_img_id":"80961","_gh_post_cta_title":"","_gh_post_cta_text":"","_gh_post_cta_link":"","_gh_post_cta_button":"","_gh_post_recirc_hide":"","_gh_post_recirc_col_1":"","_gh_post_recirc_col_2":"","_gh_post_recirc_col_3":"","_gh_post_recirc_col_4":"","_featured_video":"","_gh_post_additional_query_params":"","_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"_wpas_customize_per_network":false,"_links_to":"","_links_to_target":""},"categories":[3293,3295],"tags":[3747],"coauthors":[3772],"class_list":["post-92281","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ai-and-ml","category-github-copilot","tag-github-copilot-code-review"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.3 (Yoast SEO v27.3) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Unlocking the full power of Copilot code review: Master your instructions files - The GitHub Blog<\/title>\n<meta name=\"description\" content=\"Ready to make your code reviews smarter and easier? Learn how to structure your instructions files for better results, avoid common pitfalls, and see real-world examples to get started. \ud83d\ude80\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Unlocking the full power of Copilot code review: Master your instructions files\" \/>\n<meta property=\"og:description\" content=\"Ready to make your code reviews smarter and easier? Learn how to structure your instructions files for better results, avoid common pitfalls, and see real-world examples to get started. \ud83d\ude80\" \/>\n<meta property=\"og:url\" content=\"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/\" \/>\n<meta property=\"og:site_name\" content=\"The GitHub Blog\" \/>\n<meta property=\"article:published_time\" content=\"2025-11-14T17:00:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-04-17T21:04:57+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/github.blog\/wp-content\/uploads\/2025\/08\/copilot-wallpaper-generic-logo-header.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1080\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Ria Gopu\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Ria Gopu\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/\"},\"author\":{\"name\":\"Ria Gopu\",\"@id\":\"https:\\\/\\\/github.blog\\\/#\\\/schema\\\/person\\\/44e0cc1151ef9a58475a273c3a858513\"},\"headline\":\"Unlocking the full power of Copilot code review: Master your instructions files\",\"datePublished\":\"2025-11-14T17:00:00+00:00\",\"dateModified\":\"2026-04-17T21:04:57+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/\"},\"wordCount\":1021,\"image\":{\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/github.blog\\\/wp-content\\\/uploads\\\/2025\\\/08\\\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080\",\"keywords\":[\"GitHub Copilot code review\"],\"articleSection\":[\"AI &amp; ML\",\"GitHub Copilot\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/\",\"url\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/\",\"name\":\"Unlocking the full power of Copilot code review: Master your instructions files - The GitHub Blog\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/github.blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/github.blog\\\/wp-content\\\/uploads\\\/2025\\\/08\\\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080\",\"datePublished\":\"2025-11-14T17:00:00+00:00\",\"dateModified\":\"2026-04-17T21:04:57+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/github.blog\\\/#\\\/schema\\\/person\\\/44e0cc1151ef9a58475a273c3a858513\"},\"description\":\"Ready to make your code reviews smarter and easier? Learn how to structure your instructions files for better results, avoid common pitfalls, and see real-world examples to get started. \ud83d\ude80\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/#primaryimage\",\"url\":\"https:\\\/\\\/github.blog\\\/wp-content\\\/uploads\\\/2025\\\/08\\\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080\",\"contentUrl\":\"https:\\\/\\\/github.blog\\\/wp-content\\\/uploads\\\/2025\\\/08\\\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080\",\"width\":1920,\"height\":1080,\"caption\":\"A decorative header image with GitHub Copilot logo.\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/github.blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AI &amp; ML\",\"item\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"GitHub Copilot\",\"item\":\"https:\\\/\\\/github.blog\\\/ai-and-ml\\\/github-copilot\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Unlocking the full power of Copilot code review: Master your instructions files\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/github.blog\\\/#website\",\"url\":\"https:\\\/\\\/github.blog\\\/\",\"name\":\"The GitHub Blog\",\"description\":\"Updates, ideas, and inspiration from GitHub to help developers build and design software.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/github.blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/github.blog\\\/#\\\/schema\\\/person\\\/44e0cc1151ef9a58475a273c3a858513\",\"name\":\"Ria Gopu\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/fe701071d1d7a36438f06a701d81ed5e2a32e22ed66142cc3c0fdb6cf59c53c6?s=96&d=mm&r=g1e9a86330d94ab48b683b7f416161bf1\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/fe701071d1d7a36438f06a701d81ed5e2a32e22ed66142cc3c0fdb6cf59c53c6?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/fe701071d1d7a36438f06a701d81ed5e2a32e22ed66142cc3c0fdb6cf59c53c6?s=96&d=mm&r=g\",\"caption\":\"Ria Gopu\"},\"description\":\"GitHub Product Manager\",\"url\":\"https:\\\/\\\/github.blog\\\/author\\\/ria-gopu\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Unlocking the full power of Copilot code review: Master your instructions files - The GitHub Blog","description":"Ready to make your code reviews smarter and easier? Learn how to structure your instructions files for better results, avoid common pitfalls, and see real-world examples to get started. \ud83d\ude80","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/","og_locale":"en_US","og_type":"article","og_title":"Unlocking the full power of Copilot code review: Master your instructions files","og_description":"Ready to make your code reviews smarter and easier? Learn how to structure your instructions files for better results, avoid common pitfalls, and see real-world examples to get started. \ud83d\ude80","og_url":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/","og_site_name":"The GitHub Blog","article_published_time":"2025-11-14T17:00:00+00:00","article_modified_time":"2026-04-17T21:04:57+00:00","og_image":[{"width":1920,"height":1080,"url":"https:\/\/github.blog\/wp-content\/uploads\/2025\/08\/copilot-wallpaper-generic-logo-header.png","type":"image\/png"}],"author":"Ria Gopu","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Ria Gopu","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/#article","isPartOf":{"@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/"},"author":{"name":"Ria Gopu","@id":"https:\/\/github.blog\/#\/schema\/person\/44e0cc1151ef9a58475a273c3a858513"},"headline":"Unlocking the full power of Copilot code review: Master your instructions files","datePublished":"2025-11-14T17:00:00+00:00","dateModified":"2026-04-17T21:04:57+00:00","mainEntityOfPage":{"@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/"},"wordCount":1021,"image":{"@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/#primaryimage"},"thumbnailUrl":"https:\/\/github.blog\/wp-content\/uploads\/2025\/08\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080","keywords":["GitHub Copilot code review"],"articleSection":["AI &amp; ML","GitHub Copilot"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/","url":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/","name":"Unlocking the full power of Copilot code review: Master your instructions files - The GitHub Blog","isPartOf":{"@id":"https:\/\/github.blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/#primaryimage"},"image":{"@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/#primaryimage"},"thumbnailUrl":"https:\/\/github.blog\/wp-content\/uploads\/2025\/08\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080","datePublished":"2025-11-14T17:00:00+00:00","dateModified":"2026-04-17T21:04:57+00:00","author":{"@id":"https:\/\/github.blog\/#\/schema\/person\/44e0cc1151ef9a58475a273c3a858513"},"description":"Ready to make your code reviews smarter and easier? Learn how to structure your instructions files for better results, avoid common pitfalls, and see real-world examples to get started. \ud83d\ude80","breadcrumb":{"@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/#primaryimage","url":"https:\/\/github.blog\/wp-content\/uploads\/2025\/08\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080","contentUrl":"https:\/\/github.blog\/wp-content\/uploads\/2025\/08\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080","width":1920,"height":1080,"caption":"A decorative header image with GitHub Copilot logo."},{"@type":"BreadcrumbList","@id":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/unlocking-the-full-power-of-copilot-code-review-master-your-instructions-files\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/github.blog\/"},{"@type":"ListItem","position":2,"name":"AI &amp; ML","item":"https:\/\/github.blog\/ai-and-ml\/"},{"@type":"ListItem","position":3,"name":"GitHub Copilot","item":"https:\/\/github.blog\/ai-and-ml\/github-copilot\/"},{"@type":"ListItem","position":4,"name":"Unlocking the full power of Copilot code review: Master your instructions files"}]},{"@type":"WebSite","@id":"https:\/\/github.blog\/#website","url":"https:\/\/github.blog\/","name":"The GitHub Blog","description":"Updates, ideas, and inspiration from GitHub to help developers build and design software.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/github.blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/github.blog\/#\/schema\/person\/44e0cc1151ef9a58475a273c3a858513","name":"Ria Gopu","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/fe701071d1d7a36438f06a701d81ed5e2a32e22ed66142cc3c0fdb6cf59c53c6?s=96&d=mm&r=g1e9a86330d94ab48b683b7f416161bf1","url":"https:\/\/secure.gravatar.com\/avatar\/fe701071d1d7a36438f06a701d81ed5e2a32e22ed66142cc3c0fdb6cf59c53c6?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/fe701071d1d7a36438f06a701d81ed5e2a32e22ed66142cc3c0fdb6cf59c53c6?s=96&d=mm&r=g","caption":"Ria Gopu"},"description":"GitHub Product Manager","url":"https:\/\/github.blog\/author\/ria-gopu\/"}]}},"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/github.blog\/wp-content\/uploads\/2025\/08\/copilot-wallpaper-generic-logo-header.png?fit=1920%2C1080","jetpack_shortlink":"https:\/\/wp.me\/pamS32-o0p","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/posts\/92281","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/users\/2343"}],"replies":[{"embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/comments?post=92281"}],"version-history":[{"count":5,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/posts\/92281\/revisions"}],"predecessor-version":[{"id":95425,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/posts\/92281\/revisions\/95425"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/media\/90561"}],"wp:attachment":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/media?parent=92281"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/categories?post=92281"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/tags?post=92281"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/coauthors?post=92281"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}