Copilot Instructions Ecosystem

aid: copilot-instructions-md:related-conventions
name: Copilot Instructions Ecosystem
tags:
- AI Coding
- Conventions
- GitHub Copilot
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
humanURL: https://docs.github.com/en/copilot/customizing-copilot
properties:
- url: https://docs.github.com/en/copilot/customizing-copilot
  type: Documentation
- url: https://docs.github.com/en/copilot/customizing-copilot/adding-personal-custom-instructions-for-github-copilot
  type: Documentation
- url: https://docs.github.com/en/copilot/customizing-copilot/adding-organization-custom-instructions-for-github-copilot
  type: Documentation
- url: https://docs.github.com/en/copilot/customizing-copilot/adding-prompt-files-to-your-repository
  type: Documentation
description: Repository copilot-instructions.md is one layer in a stack of GitHub Copilot customization
  options. Personal custom instructions apply to a single user across all repositories. Organization custom
  instructions apply to every repository in a GitHub organization. Path-scoped .github/instructions/*.instructions.md
  files target specific files or globs. Prompt files in .github/prompts/ provide reusable named prompts.
  The copilot-instructions.md file sits at the repository tier and travels with the code, providing the
  same context to every collaborator.
x-features:
- Composes with personal and organization-level instructions
- Path-scoped .instructions.md files override repo-wide instructions
- Reusable prompts in .github/prompts/*.prompt.md
- Effective in Copilot Chat, Copilot in IDE, and Copilot coding agent
- Versioned and reviewed alongside code through pull requests
x-useCases:
- Applying organization-wide guardrails across all repos
- Layering repo-specific rules on top of organization defaults
- Targeting language-specific conventions to subdirectories
- Sharing reusable named prompts with all collaborators