Update package.json
Add top-level explanatory comments to classes
Update readme