3 ms·
Documenting for AI exactly like you would document for a human is ignoring how these tools work
by mvkel 11mo ago
Documenting for AI exactly like you would document for a human is ignoring how these tools work
- anonzzzies 11mo agoBut 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.
- CuriouslyC 11mo agoYou 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.
- notachatbot123 11mo agoSounds like we should call them tools, not AI!
- theshrike79 11mo agoAgentic 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.