various discussions with claude code about design. should become documentation and implementation decisions at some point too.