We need a unified Agents document for codebases

,
  • Cursor uses .cursor/rules
  • OpenAI uses AGENTS.md
  • Claude uses CLAUDE.md
  • The list goes on…

Whilst these text based instructions are fantastic for hosting in a repo, how can we account for multiple developers working in the same repo but using different AI tools?

If I had to vote for an existing route, I think AGENTS.md is the most elegant.

If I could offer my own implementation, I think .agents/rules.md would be better. That way we could establish a canonical folder that holds the likely-to-grow list of reference files and docs we’ll be providing to AI agents in the future.

2 responses to “We need a unified Agents document for codebases”

  1. NickG Avatar
    NickG

    The term “agent” implies an FBI-level of competence; it would be more fitting to call them “critters.” Therefore, I propose `.critters/rules.md` be the standard.

    Like

    Reply
    1. Tom Rhodes Avatar
      Tom Rhodes

      Hope you’re well mate 🙂 I would 100% go with `.critters`, but could we push for `.gremlins` instead? If you work after midnight you’re in trouble!

      Like

      Reply

Leave a comment