chore: architecture notes