주요 내용

• 개요: Anthropic은 Claude Code 시스템 프롬프트의 80% 이상을 제거하고도 코딩 평가에서 성능 저하가 없음을 확인함.
• 핵심 교훈: 컨텍스트 엔지니어링은 프롬프트보다 더 큰 영향을 미치며, Claude 5세대 모델(Opus 5, Fable 5)은 더 적은 제약으로 더 나은 판단을 내릴 수 있음.
• 과거 vs 현재 규칙:
  • 규칙 부여 → 판단 활용: 이전에는 "코드에 주석을 달지 마라" 같은 강력한 지침이 필요했지만, 새로운 모델은 "주변 코드 스타일에 맞춰 주석 밀도와 작명 관용구를 일치시켜라"와 같은 유연한 지침으로 충분함.
  • 예제 제공 → 인터페이스 설계: 예제는 탐색 공간을 제한함. 대신 도구의 매개변수(예: Todo 상태 열거형: pending, in_progress, completed)를 표현적으로 설계하는 것이 더 효과적임.
  • 모든 정보를 앞부분에 배치 → 점진적 공개(Progressive Disclosure): Claude Code는 필요한 순간에만 검증 및 코드 리뷰 스킬을 로드하도록 변경됨. ToolSearch로 도구 정의를 지연 로딩하는 방식도 활용.
  • 반복 설명 → 간결한 도구 설명: 이전에는 시스템 프롬프트와 도구 설명 모두에 지침을 반복했지만, 이제는 도구 설명에만 관련 지침을 두는 것으로 충분함.
  • CLAUDE.md에 메모리 저장 → 자동 메모리: Claude가 사용자 대신 관련 메모리를 자동으로 저장하도록 진화함.
  • 단순한 스펙 → 풍부한 참조: 간단한 마크다운 계획 파일 대신 HTML 아티팩트, 코드 기반의 테스트 스위트, 함수 포팅, 루브릭(좋은 API 디자인 기준 등)을 참조로 활용.
• 컨텍스트 적용 지침:
  • 시스템 프롬프트: 제품 컨텍스트와 밀접하게 연결. 자체 에이전트 구축 시에는 많은 시간 투자 필요.
  • CLAUDE.md: 가볍게 유지하고, 저장소의 "gotcha"(예: 특이한 코드 구성 방식)에 집중. 파일 시스템에서 명백히 알 수 있는 내용은 피할 것. 점진적 공개를 활용해 검증 등은 별도 스킬로 분리.
  • 스킬: 가벼운 가이드로 유지하고, 특정 의견이나 지식을 인코딩하는 데 초점. 긴 스킬은 여러 파일로 분할.
  • 참조: @ 파일 언급으로 참조. 코드 기반 파일(예: HTML 목업)이 설명이나 스크린샷보다 더 나은 결과를 제공.
• 결론: 시스템 프롬프트, 스킬, CLAUDE.md 전체를 간소화하라. claude doctor 명령어가 자동 간소화를 도와줌.