Are writing docs for humans using what you built anything like writing docs for what you want an ai to build?

Do you need to write long-ass, hyper-detailed instructions for your coworkers?

I do not, but I don't do that for LLMs either. Conventions and documentation I write and present are as succinct or lengthy as they need to be, no matter if the recipient is human or machine.