update design spec to have a more clear framing format