Adds: - README.md following spec §19.1 (what / install / define problem / run NSGA-II / custom optimizer / current algorithms / design philosophy). - A short-but-runnable crate-level //! example in lib.rs for `cargo doc` (spec §19.2).