Incidentally, I just spent some time yesterday with Gemini and Grok writing a first draft of docs for a complex codebase. The end result is far more useful and complete than anything I could have possibly produced without AI in the same amount of time, and I didn't even have to learn Mermaid syntax to fill the docs with helpful visual aids.

Of course it's a collaborative process — you can't just tell it to document the code with no other information and expect it to one-shot exactly what you wanted — but I find that documentation is actually a major strength of LLMs.

That use case works, I meant writing designs

The AI docs are good enough for AIs, to throw them at agents without previous context.

Agree. I also wonder whether this helps account for why some people get great value from AI and some terrible value.

It can also be bad if you're writing code in a tech island, with an abysmal codebase, or with weak AI tooling