Claude Code가 평이한 영어로 글을 쓰도록 'The Elements of Style'을 적용해 봄
I adapted The Elements of Style to make Claude Code write in plain English
핵심 요약
Claude Code의 글쓰기 스타일을 개선하기 위해 'The Elements of Style' 규칙을 적용한 가이드를 공유함.
- 글쓰기 가이드 적용 — Claude의 간결하고 명확한 문체 유도를 위해 Strunk의 규칙을 에이전트용으로 최적화함.
- 토큰 효율성 논쟁 — 규칙을 무조건 CLAUDE.md에 넣는 것이 토큰 낭비라는 의견과 필요할 때만 불러와야 한다는 의견이 대립함.
- 프롬프트 엔지니어링 — 모호한 '간결하게'라는 지시보다 구체적인 작성 규칙을 제공하는 것이 훨씬 효과적임.
- 학습 데이터 활용 — Claude가 이미 학습한 내용을 명시적으로 호출하는 방식과 컨텍스트에 직접 넣는 방식의 효율성을 비교함.
Claude가 내용을 빼먹지 않으면서도 간결하게, 그리고 똑같은 말 반복 안 하고 꼼꼼하게 글을 썼으면 좋겠더라고.
The Elements of Style은 1920년에 William Strunk Jr.가 쓴 짧은 작문 가이드인데, 1959년에 E. B. White가 개정했어. 핵심은 이거야. 직설적으로 쓰고, 구체적인 언어를 사용하고, 능동태를 선호하고, 불필요한 단어는 다 쳐내라는 거지.
그래서 사용자 응답이나 파일에 들어갈 글을 위해 CC0 작문 표준을 하나 만들었어. 루트에 있는 CLAUDE.md에는 짧은 기본 규칙을 담았고, SKILL.md에는 Strunk의 18가지 규칙을 그대로 살리면서 대화가 길어지거나 글쓰기 비중이 높은 작업에 필요한 가이드를 더 얹었어.
이걸 에이전트용으로 개조하면서 가이드를 좀 추가했지. 전문 용어 쓰기 전에 생소한 개념부터 설명하고, 과장 광고나 불필요한 신조어는 피하고, 모든 단어에 의미를 담고, 마크다운은 읽기 편하게 만들라는 내용이야.
https://github.com/sdi2200262/elements-of-style-for-agents
Codex로도 테스트해 봤는데 아주 잘 먹히더라. 경험상 그냥 "간결하게 써라"라고만 하고 구체적인 방법론을 안 알려주면, Claude 특유의 그 뻔한 글쓰기 스타일만 짧게 압축해서 뱉어내더라고. 근데 이 규칙들을 적용하니까 훨씬 결과물이 좋아.
너라면 이걸 모든 CLAUDE.md에 다 박아둘 거야, 아니면 글쓰기 작업이 많을 때만 따로 불러올 거야?


