If you’re like me and often create product specs and technical design docs for agents, I found these kind of specs(if LLM generates) mostly would be 10s of pages and you are subjected to fatigue from reading and reviewing them.

What worked for me was to ask Astra/Fable to include pseudo code in the design doc. which comes to 1-2 pages. Easy for me to skim and change the direction/approach. Rest all of the flowery language is for LLM giving context.