mbrucedogs/ai-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: explain agents.md vs instructions

Browse Source
This commit is contained in:
Matt Bruce 2026-02-11 09:58:59 -06:00
parent e0bd11deae
commit b39ce9cb65
1 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/ai/overview.md
View File

@ -60,6 +60,11 @@ Where they live:
Instructions are always-on defaults. Agents and skills are optional and only used when you explicitly invoke them.
## Agents.md vs Instructions
Agents.md is a human-readable contributor guide for how to work in this repo (request format, plan-first habits, and sync expectations). It does not apply automatically.
Instructions files are machine-readable rules that auto-apply when you edit matching files. They are enforced by the assistant without you having to reference 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.