Keep the README scannable (install, quick start, capability map, config, security, develop) and put full options/examples/API mapping in docs/COMMANDS.md without dropping detail. Ship COMMANDS.md in the npm package files list.
