Opus 5는 문서화 작업에 쓰기엔 정말 쓸모가 없다
Opus 5 is literally useless for documentation
핵심 요약
Claude Opus 5가 과도하게 장황하고 불필요한 기술 용어를 남발하며 문서화를 강행하는 문제에 대한 불만 토로.
- 장황한 문서화 — Opus 5가 코드와 주석에 불필요한 설명을 너무 많이 생성함
- AI 특유의 말투 — 'load-bearing', 'blast radius' 등 특정 용어를 과도하게 반복함
- 지시사항 무시 — 문서화하지 말라고 해도 매번 다시 설정해야 하는 번거로움 발생
- 워크플로우 고민 — Opus 5의 비효율적인 작업 방식을 개선할 최적의 조합 탐색
Opus 5 (Claude Code를 통해)가 오늘 나한테 이런 보석 같은 문단을 선사했어.
Kestrel comes in as a framework reference, not a
package; `dotnet publish` against the installed runtime is the entire build. That
is deliberate and load-bearing rather than tidy.
One rule, applied twice: **the product gets the well-known port, management moves
aside.**
**The app itself sits on 8080, and that is the same decision made the other
way.** Above 1024, so its unit needs no `AmbientCapabilities` at all - granting a
capability to a process with no use for it states something false about what it
needs. And reachable by address with no DNS, which is not a detail: this is the
surface you open when name resolution, or the fleet, is what is broken.
이제 정말 한계야. 기억 기능도 며칠째 쓰고 있고, claude.md도 있고, 문서화 스타일에 대한 스킬도 다 설정해 뒀어. 근데 다 무시당해. Opus 5가 코드를 짤 때마다 문서화든 주석이든 이런 쓰레기 같은 글을 두 페이지씩 써내려가. 지적하면 "완전 맞아요!"라고 하고 고치긴 하는데, 이제는 매번 "기억해: 문서화나 주석은 아예 쓰지 마"라고 지시하는 걸 잊지 말아야 하는 단계까지 왔어. 안 그러면 내가 다 고쳐야 하니까.
Claude Code를 쓰면서 파일을 건드릴 때마다 읽지도 못할 헛소리를 페이지 단위로 검토하지 않아도 되는 방법을 찾고 있어. 혹시 '계획은 Fable로 고강도 작업, 코딩은 Sonnet 5로 울트라 코딩'하는 워크플로우가 여전히 권장되는 방식이야?
Opus 5를 좋아해보려고 정말 노력했는데, 지금은 도움이 되기는커녕 일만 더 늘리고 있어. 이 짐승을 어떻게 길들여야 할까?


