AI가 작성한 프로젝트 README의 끔찍한 가독성
Atrocious READMEs in vibe coded projects.
핵심 요약
AI가 생성한 장황하고 불필요한 설명이 가득한 프로젝트 README에 대한 비판과 논의입니다.
- README 가독성 — AI가 생성한 마케팅 문구와 장황한 설명이 사용자 경험을 저해함
- 정보 밀도 — 핵심 정보보다 불필요한 수식어가 많아 읽기 불편함
- AI의 자기 참조 — AI가 스스로를 위해 작성한 README가 오히려 인간의 이해를 방해함
- 문서화 전략 — 인간용과 AI용 README를 분리하거나 간결함을 유지해야 한다는 의견 제시
이거 진짜 심각한 문제라고 본다.
요즘 프로젝트들 README 보면 죄다 "마케팅" 문구로 도배를 해놨음(당연히 AI가 쓴 거겠지, Claude가 딱 저런 식으로 글 쓰는 거 좋아하니까). README는 핵심만 간결하게 적어야지, 뭔 영양가 없는 말장난만 잔뜩 늘어놓는지 모르겠음. 게다가 무슨 이유에서인지 읽는 사람을 난생처음 PC 써보는 유아 취급하는 것도 개킹받음. 제발 이런 꼴 좀 안 봤으면 좋겠고, 이게 기본값이 되는 일은 없었으면 함...
예를 하나 들어볼게:
"Runs locally: No cloud, no servers, no API keys, zero network calls. It parses your files right on your CPU, writes its cache to your local disk, and leaves the internet completely out of the equation"
와, 진짜 쓸데없는 말 존나 많네! 최대한 단어 많이 써서 있어 보이려고 애쓰는 것 같은데(정작 알맹이는 하나도 없음), 그냥 이렇게 쓰면 되는 거 아님?
- Runs locally and is fully offline (caches data in %LOCALAPPDATA%\projectname).
고정 게시물인 "Show us what youve created"에 올라오는 레포들 훑어봐라. README들이 죄다 이 모양이라, 프로젝트 자체는 괜찮은데 읽기가 너무 짜증 나서 못 보겠음 :/
