@shinya.maeda I'll answer these on the product side 🤝 and your interpretation is right on all points, confirming them here:
- "Workspace-level" = project-level. Correct. In the Web UI there's no workspace concept, so AGENTS.md at the project root (or .gitlab/agents.md) applies to all conversations in that project.
- Subdirectory-level: we can make it out of scope for this issue. Your examples for how subdirectory context would be determined from the URL make sense, but this adds meaningful complexity (tree-walking, caching, Gitaly calls). Let's scope this issue to project-level only and track subdirectory support as a follow-up.
- User-level: skip in Web UI. No local filesystem in a browser, so this is IDE-only. We'll document it as a limitation.
- One additional decision that came out of the related chat-rules.md discussion (#593392 (comment 3166099842)): AGENTS.md rules should be re-evaluated on each message based on the user's current project context, not locked at conversation start. If a user switches projects mid-conversation, the new project's AGENTS.md should apply. This keeps behavior consistent across both features.
/cc @juan-silva