Recommended structure
# Repository instructions
## Scope
These instructions apply to ...
## Setup
- Install: `...`
- Start: `...`
## Change rules
- ...
- Do not edit generated files under ...
## Verification
- Lint: `...`
- Test: `...`
- Build: `...`
## Pull requests
Report changed behavior, checks run, and remaining risk.Fill facts, not slogans
Replace every placeholder with a real command, path, ownership boundary, or observable completion condition. Delete sections that do not apply instead of leaving generic advice.
Nested repositories
Use nested AGENTS.md files when a package has materially different commands or rules. State precedence at the root and keep local instructions close to the code they govern.