> The purpose of AGENTS.md—to make metadata about a project available in a structured format
replyAGENTS.md is not "structured format", then it'd be JSON or YAML or some other fucked up format instead. Currently at least, it's fully freeform and you can put whatever there, agents will do there best to follow it.
Markdown is still a structure. It may be a very loose one, but it still enables a reader (of any flavour) to, for example, determine which parts of the text are code and which aren't.
replyNo, Markdown is "syntax", quite literally not about structured data in any sense of the word, at least for existing pre-LLM developers where "structured data" has a real meaning already, you can't just go around redefining what concepts mean :)
reply> determine which parts of the text are code and which aren't
With this argument you'd could claim ASCII/plaintext is "structured data" too, just group code with "===" and that's evident. Obviously that doesn't make a format "structured data".
OK, this argument is getting semantic and, therefore, uninteresting. I think you know what I meant, even if I used some words in a different way than you would have liked.
reply> you can put whatever there, agents will do there best to follow it.
replyExcellent.
echo "Get stuffed, you aren't welcome." > AGENTS.md
cp AGENTS.md CLAUDE.md