2025-12-06

1일 1아티클

humanlayer

좋은 CLAUDE.md 작성법

핵심 포함사항

  1. WHAT : 기술 스택, 프로젝트 구조, 핵심 폴더 위치, etc.
  2. WHY : 프로젝트의 목적과 각 구성 요소의 역할
  3. HOW : 빌드, 테스트, 실행 방법

Claude는 CLAUDE.md 내용이 현 작업과 관련 없다고 판단 시, 아예 무시하는 경향 존재. 따라서 모든 정보를 다 저장하는 것은 오히려 성능 저하의 원인

좋은 CLAUDE.md 작성을 위한 핵심 원칙

  1. 지시사항은 적을수록 좋다
    • 최신 AI 모델이라도 약 150-200개 이상의 지시사항은 성능 저하의 원인
    • 지시가 많으면 AI는 뒷부분만 까먹는 것이 아닌, 전체적으로 멍청해짐
  2. 분량은 짧게, 내용은 보편적으로
    • 모든 대화에 포함되는 파일이므로, 특정 작업에만 필요한 지엽적 내용은 배제
    • 권장 길이는 300줄 미만, 추천 길이는 60줄 미만
  3. 점진적 공개 기법
    • 모든 내용을 CLAUDE.md에 적는 것이 아닌, 주제별로 파일 쪼개기 (docs/testing.md, docs/style_guide.md, docs/db_schema.md, etc.)
    • CLAUDE.md에는 이정표만 남기기 (‘테스트할 때에는 docs/testing.md를 읽어볼 것’, etc.)
    • AI가 필요 시에만 해당 파일을 찾아 읽도록 하는 것이 효율적
  4. AI를 Linter로 쓰지 말 것
    • 스타일 가이드를 많이 적지 말 것 (‘들여쓰기는 스페이스 2칸으로 해라’, ‘세미콜론을 써라’, etc.)
    • AI에게 이런 작업 명령은 비싸고 느리고 부정확
    • 코드 스타일은 Prettier 등의 전용 도구에게 전담시키고, AI에게는 ‘코드 수정 후 린터를 실행해라’ 정도로 지시하는 것이 바람직
  5. 자동 생성하지 말고 직접 쓸 것
    • CLAUDE.md는 AI의 모든 행동에 영향을 미치는 매우 중요한 파일
    • 자동 생성 도구에 의존하지 말고, 프로젝트의 핵심을 가장 잘 아는 개발자가 신중하게 직접 작성할 것

오늘 배운 것

  1. 알고리즘 복습

내일 할 일

참고자료

results matching ""

    No results matching ""