실제로 작동하는 CLAUDE.md 파일 작성 방법 (Harness Engineering #2)
발행: (2026년 4월 4일 AM 10:43 GMT+9)
2 분 소요
원문: Dev.to
Source: Dev.to
ETH 취리히 연구 결과
연구원들은 여러 AI 코딩 에이전트를 대상으로 138개의 에이전트 파일을 테스트했습니다. 결과는 다음과 같습니다:
- 인간이 직접 작성한, 간결한 (< 60 줄) 파일: +4 % 성공률
- LLM이 생성한, 장황한 (200 줄 +) 파일: ‑3 % 성공률, +20 % 토큰 비용
LLM이 만든 파일은 에이전트를 오히려 악화시켰습니다.
이 가이드에서 다루는 내용
- 60줄 원칙: 포함할 내용과 제외할 내용
- 안티패턴 갤러리: 문서 덤프, LLM 선언문, 모든 것을 포함하는 파일
- Skills를 활용한 점진적 공개
- 3가지 프로젝트 유형 템플릿: 모노레포, API, 프론트엔드
- CLAUDE.md가 제대로 작동하는지 측정하는 방법
추가 읽을거리
- 전체 기사: How to Write CLAUDE.md Files That Actually Work (Harness Engineering #2)
- 이 내용이 도움이 되었다면, 더 많은 AI 엔지니어링 가이드를 위해 내 블로그를 확인해 보세요.