반복적인 프롬프트 작성은 그만. CLAUDE.md 파일을 사용하세요 (Harness Engineering)
Stop writing repetitive prompts. Use a CLAUDE.md file instead (Harness Engineering)
핵심 요약
프로젝트 루트에 CLAUDE.md 파일을 배치하여 AI에게 일관된 규칙과 구조를 제공하는 방법.
- CLAUDE.md 활용 — 프로젝트 루트에 규칙 파일을 배치하여 AI의 일관된 동작을 유도함.
- Harness Engineering — 채팅창 밖에서 지속적인 구조를 구축해 AI의 문맥 유지를 돕는 방식.
- 규칙 설정 5계명 — 기술 스택, 자동 검증, 역할 분리, 버그 로그, 범위 제한을 포함한 5가지 핵심 규칙.
- AI 드리프트 방지 — 세션 간 기억력이 없는 AI에게 프로젝트 규칙을 상기시켜 성능 저하를 막음.
다들 Claude를 코딩하는 시간보다 돌보는 데 더 많은 시간을 쓴다고 느끼시나요? "항상 테스트를 실행해." "커밋은 작게 유지해." "X 라이브러리는 사용하지 마." 정말 지치죠. 완벽하게 작동하는 Claude와 딴길로 새는 Claude의 차이는 모델이나 프롬프트 실력이 아니라, 바로 구조입니다.
저는 제가 **"Harness Engineering"**이라고 부르는 방식을 실험해 왔습니다. 채팅을 통해 AI를 제어하려 하는 대신, 그 주변에 지속적인 구조를 구축하는 것이죠. 가장 쉬운 방법은 프로젝트 루트에 간단한 CLAUDE.md 파일을 넣는 것입니다. Claude는 모든 세션 시작 시 이를 자동으로 읽고 상시 명령으로 취급합니다.
수많은 시행착오 끝에, 효과적인 CLAUDE.md에는 5가지 특정 규칙만 있으면 된다는 것을 알게 되었습니다:
- 규칙을 작성하고, 상기시키지 마라: 기술 스택, 커밋 규칙, 일반적인 행동 지침을 여기에 넣으세요. 신호 밀도가 희석되지 않도록 300줄 미만으로 유지하세요.
- 검증 자동화: 규칙에 QA를 포함하세요. Claude가 코드를 넘겨주기 전에 린터를 통과하고, 테스트를 실행하고, 콘솔 오류를 확인하도록 지시하세요.
- 역할 분리 (문맥 분리): AI는 자신의 결과물을 너무 높게 평가합니다. "빌더 에이전트"와 "리뷰어 에이전트"는 같은 문맥 창을 공유해서는 안 됩니다.
- AI의 실수 기록: Claude는 세션 간 기억력이 없습니다. 파일에 "버그 로그"를 만드세요. 실수를 하면 근본 원인과 해결책을 기록하세요. 그러면 같은 실수를 다시 하지 않을 것입니다.
- 범위 좁히기: 울타리가 AI를 더 똑똑하게 만듭니다. 요청당 하나의 기능만 수행하게 하세요. 큰 작업이라면 먼저 하위 작업을 개요로 작성하도록 강제하세요.
제대로 구조화하면, AI를 위한 사원 핸드북처럼 작동합니다. 한 번 작성하면 매번 규칙을 따르게 되죠.
이 문맥 분리가 어떻게 작동하는지에 대한 더 깊은 분석을 작성했고, 프로젝트에 바로 사용할 수 있는 무료 템플릿을 준비했습니다.
전체 분석을 읽고 템플릿을 여기서 다운로드할 수 있습니다:5 Rules That Make Claude Dramatically Smarter
다른 분들도 LLM의 드리프트를 제어하기 위해 이런 지속적인 프로젝트 파일을 사용하고 계신지 궁금합니다!
