This specification is made for structuring how AI agents and humans collaborate in software systems.
Well, I tried to vibecode but my codebase was growing messy really fast. I was frustrated.
So, I tried to understand why, and the reason was simple!
Agents don't properly know where to put code (they need clear rules). In general, they don't know how to architect code. You have to guide them.
Thus, I revised my classics: MVC, Clean Code, Hexagon, etc.
And, took the best from these and made a modern spec that fits modern apps' needs (scalability, iterating fast, etc).
Check it here: https://www.zapstudio.dev/specifications/uaa