AGENTS.md

1# Roslyn (.NET Compiler Platform) — AI Agent Instructions
2 
3This file is intentionally thin. The canonical, repo-wide agent guidance lives in
4**[`.github/copilot-instructions.md`](.github/copilot-instructions.md)** — read it first.
5It covers the project overview, build/test entry points, global code style, the
6memory-first orientation protocol, and the doc-update obligation.
7 
8## Where to find things
9 
10- **Repo-wide rules & orientation:** [`.github/copilot-instructions.md`](.github/copilot-instructions.md)
11- **Knowledge base (load on demand):** [`.github/memory/INDEX.md`](.github/memory/INDEX.md) — the loading map; start here for architecture, conventions, file map, APIs, known issues, and testing.
12- **Area-specific rules (auto-applied by path):** [`.github/instructions/`](.github/instructions/)
13  - [`Compiler.instructions.md`](.github/instructions/Compiler.instructions.md) — `src/{Compilers,Dependencies,ExpressionEvaluator,Tools}`
14  - [`IDE.instructions.md`](.github/instructions/IDE.instructions.md) — `src/{Analyzers,CodeStyle,Features,Workspaces,EditorFeatures,VisualStudio,LanguageServer}`
15  - [`Razor.instructions.md`](.github/instructions/Razor.instructions.md) — `src/Razor`
16- **Task-specific skills:** [`.github/skills/`](.github/skills/) (auto-discovered; e.g. `code-review`, `ci-analysis`, `update-agent-docs`).
17 
18## Orientation protocol
19 
201. Read [`.github/copilot-instructions.md`](.github/copilot-instructions.md).
212. Read [`.github/memory/INDEX.md`](.github/memory/INDEX.md) and load only the memory files relevant to your task.
223. The path-scoped instruction file for the area you're editing applies automatically — follow it.
234. After changing code, run the `update-agent-docs` skill to keep `.github/memory/` fresh.
24