코드베이스에서 모든 인라인 문서를 제거했습니다

얘가 슬롭(slop)인 건 알아채는데 정작 지가 슬롭 쓰는 건 못 멈추더라. 그냥 네 시스템이 어떻게 돌아가는지 파악하고 주석은 직접 달거나, 아니면 그냥 포기하고 다 빼버리는 게 답임.

.claude/rules/ 파일을 만들어서 주석을 어떻게 작성할지 정할 수 있음.

솔직히 여기서 사람들이 말하는 문제의 90%는 그냥 Claude Code 문서를 안 읽고 기본적인 커스터마이징을 안 해서 생기는 거임.

세팅 다 해놓으면 진짜 “이슈 12345 수정해” 같은 짧은 프롬프트만 입력해도 결과 잘 나옴.

요즘은 규칙(rules)으로 제어하는 게 대세임? CLAUDE.md에 있는 스킬이나 지시사항으로는 안 되는 거야? 나도 Opus 5랑 doc comment 하나 가지고 몇 번이나 실랑이했는지 모르겠음. 도대체 어떻게 설정해야 머리 다친 박사 과정생이 자기 속마음 다 들린다고 착각하면서 떠드는 것처럼 안 들릴지 감도 안 잡힘.

6개월 전엔 맞는 말이었을지 몰라도, 지금은 쏟아져 나오는 쓰레기 같은 코드(slop)를 막을 방법이 없음.

실제 대규모 코드베이스에서 그게 얼마나 쉬울까? 10명 넘는 사람들이 작업할 텐데. 코드베이스 내의 모든 변경 사항을 검토하는 것도 불가능하고.

ASD-STE100 쓰면 삶의 질이 수백만 배는 나아짐.

아예 안 씀. 인라인으로 코드 동작을 문서화하라고 수년간 훈련받아온 입장에서, 이게 더 나은 관행일 수 있다고 생각하는 게 좀 미친 짓 같긴 함. 모델들은 이제 코드만 보고도 동작을 추론하는 능력이 점점 좋아지고 있고, 인라인 주석은 진실의 중복 소스일 뿐임. 종종 낡고, 부정확하거나, 오해를 불러일으키지. 지금까지 인라인 문서가 그리웠던 적은 한 번도 없음.

구현된 것만 추론할 수 있잖아. 주석은 왜 그렇게 했는지, 왜 다른 해결책은 안 썼는지, 혹은 다른 해결책에 부작용이 있었는지 이해하는 걸 도와줌. 코드에 오류가 있는지 알 수 없으니, 잠재적으로 잘못된 코드에서 추론하게 되는 거고 오류가 발생했을 때 왜 그런 경로를 택했는지 알 방법이 없게 됨.