The main readme needs to be focused on how a user can get started, install the tools and use them. Explaining the ideas and the design decisions is important but should not be too verbose and should be left for per-tools readme. Reorganize and cleanup the readme.