proposal: Standardized Location & Format for Agentic Toolkit Documentation (agents/*.md)
Resolved 💬 2 comments Opened Aug 7, 2025 by KRRT7 Closed Nov 27, 2025
💡 Likely answer: A maintainer (etraut-openai, contributor)
responded on this thread — see the highlighted reply below.
Currently, agent/toolkit documentation for AI agents is fragmented, each provider uses different naming conventions, folder structures, and formats. This makes it harder for the community to share, extend, and integrate toolkits across ecosystems.
I propose adopting a common standard for storing these markdown files:
One folder, one .md per tool.
Suggested structure:
agents/
WARP.md
VSC.md
CLAUDE.md
...
codex seems to have an AGENTS.md but perhaps it could be agents/codex.md
PS. I have opened this issue in Claude-code, VSC, and this repo
2 Comments
See also:
used by over 20k open-source projects.
AGENTS.mdas a README for agents: a dedicated, predictable place to provide the context and instructions to help AI coding agents work on your project.Thanks for the feature request. This hasn't received any new upvotes in more than three months, so I'm going to close.