microsoft / microsoft/vscode-docs

Clarify scope of and when custom instructions are applied

Open
#9,006 1 comment 0 reactions 1 assignee View on GitHub

@ntrogh is already working on this.

Since Oct 29, 2025.

doc-bug
Dominant language
Markdown
Stars
6.6k
Forks
5.8k
Avg merge
11h 43m
Merged PRs (30d)
123

Description

There's confusion about the different scopes of instructions files (workspace vs user) and when they are actually applied (manually vs automatic). Clarify these topics in the Custom Instructions docs.

Also clearly describe that repo-level instructions are not supported (as is the case in GH.com).

Ref: https://github.com/microsoft/vscode/issues/272199

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.