move todo to assembly; add architecture doc