Draft design document

ignore weird messages about me committing your files, I had to delete
and re-sync everything.