agentsmd
[repository hygiene]: Allow specifying Agents.md as a "dotfile" i.e. `.agents.md`
There are enough Thisfile and Thatfile and Otherfile sitting at the root of every repository. Allow agents to read from a dot file or a dot directory.
Even if there were enough Thatfiles, how would making it a dotfile improve the situation at all?
I'm not sure I understand. Is the question why use dot files for anything at all?
+1 for the root AGENTS.md also being able to be in dot directories, like .github and .gitlab
Can you give an example?
@Schweinepriester gave a couple of good ones. .vscode is another. You can put your settings.json in the root, or in .vscode/settings.json, but it is up to the maintainers if decluttering is warranted. It's a courtesy to code owners that also leaves open the possibility of adding more files there in the future.
I think this is important as well, especially for workflows that go beyond just top-level agent files. Larger codebases often need additional context in deeper areas of the repository.
From an organizational perspective, I’d prefer not to have agent files mixed in with implementation files. For example, in a controllers folder that follows a specific design pattern, you’d want those conventions applied consistently by the agent. If an agent file gets alphabetically interleaved (e.g., ag.*), it disrupts that structure. Using dotfiles provides a clear and familiar visual cue that these are configuration files, which helps keep the directory layout intuitive.
