> I ask the agent to generate markdown docs, graphviz diagrams, changelogs, audit reports, etc. I only review that.

From an alternative perspective, that is the code.

I sometimes end up at or near this conclusion when considering the future.

Consider some software that was written by AI purely using markdown files. The spec was sufficient enough to classify all of the business logic, conditionals, etc... You might even end up creating "loops" that tell AI to do something over and over again. Some markdown files become standard, repeatable "functions" that are to be followed EXACTLY (determinism). Some markdown files become assertion tests. Heck, the markdown file might eventually invent some kind of "typing system" so that you know when you're working with the person "class", it's always going to have the same facets.

I love the concept of it going in this direction - we already had plenty of languages to tell a computer what to do, we've just generated MORE text at a higher level and made it less deterministic.

Just to clarify, I don't think it's likely that this is the end result, but it sure is funny to think about.