바이브 코더들아 제발 부탁인데, 깃허브에 앱이나 툴 올릴 때 Claude가 쓴 군더더기 좀 지워줘

세 줄 요약: VR 헤드셋용 스크립트 찾으려고 깃허브 뒤지는 중인데, 죄다 클로드(Claude)가 쓴 리드미(README)라 가독성 개박살남. 사람이 쓴 것보다 훨씬 빽빽하고 읽기 힘듦. 애초에 AI 모델 보라고 만든 것도 아니고 사람 보라고 만든 건데, 정작 사용자한테는 1도 필요 없는 정보만 잔뜩 들어있음.

아까 깃허브에서 내 스팀 프레임(Steam Frame) VR 헤드셋에 쓸 스크립트랑 툴 좀 찾고 있었거든. 99%는 그냥 감성으로 짠 코드들이더라. 뭐, 그것까진 괜찮아. 어차피 내가 겪는 문제 해결하려고 누군가 클로드 써서 만든 툴 공유해 주는 건데, 도움만 된다면야 굳이 불평할 생각은 없지.

근데.

그 프로젝트들 리드미(README.md)가 하나같이 전부 클로드가 쓴 거더라. 문제는 요즘 클로드 문체가 너무 장황하다는 거야. 사용자한테는 1도 안 중요한 내용을 말하려고 단어를 너무 많이 써. 간결하고 명확하게 쓰는 게 아니라, 마치 클로드가 자기 혼자 보려고 메모하는 것처럼 글을 써놔.

예를 하나 들어볼게. 아이 트래킹 스크립트 기능 목록인데, 원래는 이렇게 써야 정상 아님?

• PC 자동 감지

• One Euro 필터 및 동공 움직임 데드존을 이용한 시선 보정

이거 딱 15단어거든?

근데 클로드는 이렇게 써놨더라.

스팀 링크가 스트리밍 중인 PC로 신호를 보내 PC를 스스로 찾아냅니다. 번들로 제공되는 무선 어댑터를 사용하면 어댑터와 직접 연결되므로 홈 네트워크 환경은 상관없습니다.

시선과 눈꺼풀은 One Euro 필터로 부드럽게 보정됩니다. 작은 데드존을 설정해 응시할 때 눈이 떨리지 않게 했고, 눈을 다시 뜰 때 시선이 튀는 현상을 막기 위해 눈을 감고 있는 동안에도 시선 위치를 유지합니다.

무려 71단어임. 5배나 길고 읽기도 훨씬 힘들어. 이게 겨우 두 항목인데, 리드미 전체가 이런 식이라고 생각해 봐.

게다가 클로드는 스크립트나 앱의 모든 기능을 하나하나 다 설명하려고 들어. 당연한 거나, 굳이 몰라도 되는 백엔드 정보까지 다 쑤셔 넣는다고.

깃허브 저장소 구경하기가 진짜 너무 힘들어. 개발자(나 다른 AI 에이전트)한테나 도움 될 법한 쓸데없는 정보로 도배가 되어 있으니까. 어차피 개발자들은 코드 직접 뜯어볼 텐데 말이야.

허공에 대고 소리치는 거 아는데, 깃허브에 좋은 스크립트 올릴 거면 제발 5분만 투자해서 리드미 좀 읽기 쉽게 다듬어 줘라. 진짜 큰 도움 될 거다.

수정: "AI가 쓴 리드미는 다른 AI가 읽으라고 만든 거 아님?" 하는 애들 있는데, 이번 경우는 아니야. 클로드는 스팀 프레임에서 돌아가지도 않아서 리드미 던져주고 알아서 하라고 시킬 수도 없어. 내가 말하는 리드미들은 전부 사람이 직접 헤드셋에서 명령어를 입력하라고 적혀 있는 것들이라고. 근데 너희 말이 맞네. 결국 사람이 보라고 만든 건데도 AI 에이전트들끼리나 읽을 법하게 써놨다는 게 문제인 거지.