Matrix architecture design documentation

Daniel wrote up a good usage document in the README, this is to document the design decisions that the code should support. Please point out anything I missed