AGENTS.md is a plain markdown file that provides always-on instructions to the agent. It works at two levels: a global one that applies everywhere, and a project one scoped to a workspace.

Global

Place an AGENTS.md at ~/.jean2/AGENTS.md. This is machine-level instructions that apply to all workspaces and all sessions. Use it for things like your operating system, preferred shell, or personal conventions.

# AGENTS.md

- I use macOS with zsh
- Prefer pnpm over npm
- Use tabs for indentation
- Always write commit messages in English

Workspace

Place an AGENTS.md in the root of your workspace. Instructions here only apply to sessions in that workspace. Use it for project-specific rules, build commands, architecture notes, or team conventions.

# AGENTS.md

- Run tests with `bun test`
- This project uses TypeScript strict mode
- Never push to main directly
- Database migrations live in `db/migrations/`

Both files are optional. If both exist, the global file is loaded first, then the workspace file. Changes take effect on the next session. No config, no registration. Plain markdown.