Comment by mvkel
Documenting for AI exactly like you would document for a human is ignoring how these tools work
Documenting for AI exactly like you would document for a human is ignoring how these tools work
You can make affordances for agent abilities without deviating from what humans find to be good documentation. Use hyperlinks, organize information, document in layers, use examples, be concise. It's not either/or unless you're being lazy.
Agentic AI is LLMs using tools in a loop to achieve a goal.
Needs a better term than "AI", I agree, but it's 99% marketing the tech will stay the same.
But they are right, claude routinely ignores stuff from CLAUDE.md, even with warning bells etc. You need a linter preventing things. Like drizzle sql` templates: it just loves them.