docs: document instructions scope

This commit is contained in:
Matt Bruce 2026-02-11 09:56:03 -06:00
parent 51e2fae97f
commit e0bd11deae

View File

@ -51,6 +51,15 @@ Copilot is an AI coding assistant that integrates with editors and chats to help
- Skills: Reusable knowledge or workflows the assistant can apply.
- Tokens: The usage units that track AI consumption.
## Instructions (Repo Rules)
Instructions are repo-scoped rule files that auto-apply based on file patterns. They set coding or documentation standards the assistant must follow when editing matching files.
Where they live:
- The repo-level instructions directory (for example, [instructions/](../../instructions/))
- Editor or org-level instruction files when configured by your team
Instructions are always-on defaults. Agents and skills are optional and only used when you explicitly invoke them.
## Agents vs Skills (Where They Live)
Agents are full personas or modes (for example, Task Researcher) that control how the assistant behaves end-to-end. Skills are focused, reusable workflows (for example, webapp-testing) that the assistant can load for a specific task.