[enhancement] tightened specs and added descriptions