CLAUDE.md는 짧게 두고, 자세한 규칙은 나눠 두는 편이 낫다
긴 작업에서 나 를 너무 크게 만들면 매번 필요 없는 지시까지 함께 읽히게 된다. 이 파일들은 가 을 이해하는 데 도움이 되지만, 모든 내용을 한곳에 넣으면 현재 작업과 상관없는 문맥 비용이 늘어난다.
중요한 규칙이 긴 문서 안에 묻힐 수 있고, 오래된 가정이 계속 영향을 줄 수 있다. 특정 작업용 지시가 다른 작업을 방해할 수도 있다.
기본 파일에는 공통 , 기준이 되는 문서 위치, 건드리면 안 되는 영역, 질문이 필요한 상황, 작업별 문서를 찾는 방법만 담는 편이 좋다. 구현 규칙, 수정 규칙, 테스트 규칙, 인수인계 규칙, 배포 점검표, 긴 작업의 단계 보고서는 별도 문서로 나누는 방식이 제안된다.
핵심 포인트
- 나 가 너무 길면 매 세션에서 불필요한 지시까지 읽힌다.
- 긴 기본 파일은 문맥 비용을 늘리고 중요한 규칙을 묻히게 할 수 있다.
- 오래된 가정이나 특정 작업용 지시가 다른 작업에 계속 영향을 줄 수 있다.
- 기본 파일에는 공통 규칙과 작업별 문서 위치만 짧게 담는 방식이 좋다.
- 구현, 테스트, 배포, 인수인계 같은 무거운 규칙은 별도 문서로 나누는 편이 낫다.