clarity + README