ARCHITECTURE.md: initial iteration

[pedronis]

this document tries to give a high-level architecture and implementation overview

it's a starting point to navigate the code base and the why/philosophy of some parts of it

I worked with copilot to add references to code in the repo/documentation for the code