Update the project README.md with comprehensive documentation based on the current codebase state. Use when the README needs updating or is outdated.
