AGENTS.md Template

Define scope, safe commands, verification, and handoff expectations once—close to the code.

What the resource contains

Root template

Nested-directory override example

Safe editing rules

Definition-of-done checklist

Selected preview

Root instructions

Keep rules concrete and executable.

# AGENTS.md

## Scope
These instructions apply to the entire repository. Nested AGENTS.md files override them for their directory.

## Before editing
1. Read the nearest package manifest and relevant tests.
2. Check git status; preserve changes you did not create.
3. Prefer existing patterns and dependencies.

## Verification
- Types: `[command]`
- Focused tests: `[command]`
- Build: `[command]`

## Handoff
Report changed behavior, checks run, migrations, deployment steps, and residual risk.