Related, one other thing we are doing at least in the SDK, is:
• AGENTS.md per directory.
• e.g. one for agent-server, for the llm module, etc
They are loaded automatically when the agent enters/edits/reads something in that directory
calm-artist-7206
09/25/2026, 10:24 AM
I think maybe it makes sense to think and split
• the AGENTS.md-like instructions (e.g. commands to test, architectural intentions, important constraints when working with that code) -> in path-based AGENTS.md
• the rest in repo skills…
Though it’s not always clear which is which 😅