proposal: Standardized Location & Format for Agentic Toolkit Documentation (agents/*.md)
Resolved 💬 3 comments Opened Aug 7, 2025 by KRRT7 Closed Aug 15, 2025
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
...
you currently can place CLAUDE.md files in several locations which can affect behavior in a local / global way, for local i.e per repo, I suggest it could be agents/CLAUDE.md
PS. I have opened this issue in VSC, codex, and this repo
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗