docs: add architecture.md
This document explains how the current code is structured and it also hints at what changes are we planning to do to the extension structure in the near future.
Read the latest rendered document here: https://gitlab.com/gitlab-org/gitlab-vscode-extension/-/blob/architecture-md/docs/architecture.md
Edited by Tomas Vik (OOO back on 2024-08-12)