{
  "id": 2272842,
  "title": "Pet peeves with GitHub Copilot Instructions and my solution",
  "url": "https://urgent.news/2026/08/21/pet-peeves-with-github-copilot-instructions-and-my-solution",
  "topic": "ai",
  "section": "AI",
  "published": "2026-08-21T01:42:50.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/reyronald/pet-peeves-with-github-copilot-instructions-and-my-solution-31af"
  },
  "original_language": "en",
  "account": "Pet peeves with GitHub Copilot Instructions and my solution\n\nClaude Code's .claude/rules/ feature allows creating custom markdown files with instructions for the model. This feature is advantageous as it lets developers include specific rules for certain codebases while omitting irrelevant guidance. This saves input tokens and improves agent performance.\n\nHowever, GitHub Copilot has its own format for custom instructions, located in .github/instructions/*.instructions.md. The format requires a single string property called applyTo instead of the paths property used in Claude Code. If a Copilot instructions file needs to reference multiple patterns, this becomes cluttered and unreadable.\n\nTo add to the frustration, Claude Code supports a @path/to/file syntax that allows referencing other files in the project's context at launch. This can be useful when there are pre-existing project documentation files that are not directly related to the AI-assisted development rules. This feature is missing from GitHub Copilot's instructions format.\n\nOne client I work with operates in a restricted security environment, only allowing GitHub Copilot access through the CLI, VSCode, or IntelliJ plugins. While they appreciate the cross-compatibility of Copilot with Claude rules, they encountered a limitation - the missing @import syntax in Copilot instructions. This feature would have been helpful for loading referenced files and integrating with Backstage for generating online wikis.\n\nThe workaround I implemented was to create a Node.js script that parses through instruction files, searching for patterns like !-- @import path/to/file -- and replacing them with the referenced contents. By using HTML comments, the script avoids interfering with the LLM's processing. This solution lets me author my instruction files with the desired @import syntax while avoiding redundancy in the documentation.",
  "summary": "This blog post was originally published on my own web site . Photo by Łukasz Łada on Unsplash One of my favorite features of Claude Code is .claude/rules/ , docs here: https://code.claude.com/docs/en/memory#organize-rules-with-claude/rules/ . If you're not yet aware, it allows you to create arbitrary markdown files with instructions or guidance for the model that will be loaded only when the…",
  "key_points": [
    "Claude Code allows custom markdown files with developer-specific instructions",
    "GitHub Copilot uses a different format with applyTo property for custom instructions",
    "@path/to/file syntax in Claude Code enables referencing other files, missing in Copilot"
  ],
  "editors_take": "The author's workaround enables using a more versatile instruction format with GitHub Copilot, bridging a feature gap with Claude Code and enhancing documentation integration.",
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}