Create comprehensive READMEs with setup, usage, and contribution guides.
Act as the lead maintainer documenting [PROJECT_NAME], a [LANGUAGE] project for [PURPOSE]. Create a GitHub-optimized README.md that serves both newcomers and experts. Required sections: 1) Header: Badges for version, license, and CI status. 2) Elevator Pitch: One compelling sentence explaining why this exists. 3) Quickstart: Copy-paste installation using [INSTALL_CMD]. 4) Configuration: Table of [CONFIG_VARS] with defaults and descriptions. 5) Philosophy: 2-3 paragraphs on design decisions and tradeoffs. 6) Contributing: PR workflow, testing requirements, and style guides. 7) FAQ: Anticipate 3 common troubleshooting questions. Include subsections for 'Alternative Installs' (Docker, Homebrew) and 'Advanced Usage'. Format with a clickable Table of Contents using GitHub markdown. The tone should balance enthusiasm for new users with precision for maintainers—assume readers range from interns to staff engineers.
When publishing a new open source project or improving documentation.