Repository README Writer

Create or improve repository READMEs that help humans and agents understand the project quickly without overfitting to fragile implementation details.

Decision Tree

What kind of README work is this?

• Creating a new README from a repository Inspect relevant repository evidence; consult references/repository-audit.md and adapt templates/repository-readme.md when useful.

• Improving an existing README Read references/rewrite-patterns.md, then preserve useful sections and remove stale or overly specific material.

• Fixing only the setup path Read references/quickstart-design.md and make the quickstart the shortest verified path from clone to useful local feedback.

• Reviewing README quality without editing yet Review the requested scope against repository evidence. The probe and templates/readme-review.md are optional aids for broader reviews, not prerequisites for a wording or link review.