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/`

How they combine

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.

What's next

Skills: conditional instruction sets loaded on demand
Preconfigs: system prompts for specific agent personalities