This file is included in full context for every agent conversation. Keep it tiny and stable.
- Avoid adding operational details to
AGENTS.md. - Only update
AGENTS.mdto reference other docs/files. - Put project callouts and workflow details in
docs/agents/and link them from here.
docs/agents/project-context.md(setup, commands, project-specific caveats)docs/agents/code-style.mddocs/agents/bugfix-workflow.mddocs/agents/testing-principles.md
If you discover a new sharp edge, workflow, or non-obvious project behavior,
update the relevant doc(s) in docs/agents/ so future agent runs are faster and
more correct. Keep callouts organized under clear headings and prefer concise,
project-specific guidance over generic advice.
- See
docs/agents/project-context.mdfor setup, commands, seed data, VM snapshot details, and caveats.