README Style
Overview
Analyze a project and rewrite its README.md with modern GitHub visual styling. The goal is a README that renders well on GitHub, communicates project purpose at a glance, and follows current open-source conventions.
Workflow
- Read the existing README and project root files (
package.json,pyproject.toml,go.mod,Cargo.toml,Makefile,LICENSE*). - Identify the tech stack, build tools, test tools, and project structure.
- Check for existing docs (
CHANGELOG,CONTRIBUTING,docs/) to link. - Decide which sections apply to this project — do not add sections for features that do not exist.
- Write the README following the style guide in
references/readme-style-guide.md. - Verify all file paths, commands, and feature descriptions match the actual project.
Rules
- Only include badges for technologies actually present in the project.
- Do not fabricate CI, npm, or PyPI badges if no pipeline or package exists.
- Preserve all essential information from the original README.
- Use ASCII box diagrams over Mermaid for workflow visualization.
- Prefer tables over bullet lists for structured information.
- Scale README length to project size: small tools ~80 lines, libraries ~150, large projects 200+.
- Match the language of the existing README (Korean, English, or mixed).
- Technical terms (commands, file paths, function names) are always in English regardless of document language.