코딩 에이전트 설정과 시스템 프롬프트에는 과거 모델에 맞춰 넣은 지침이 남기 쉽습니다. 원문 게시글은 Anthropic의 /claude-api prompt-audit를 소개하며 이런 지침을 점검해 보자고 권합니다. 대상에는 CLAUDE.md, AGENTS.md, 스킬·룰 파일이 포함됩니다. 시스템 프롬프트와 도구 설명, 이를 조립하는 코드도 살펴볼 수 있습니다.

감사가 찾는 것은 짧게 줄일 문장이 아닙니다

공식 감사 절차 는 오래된 모델 때문에 추가한 강조·단계별 지시, 프로젝트 코드와 어긋난 사실, 서로 충돌하는 규칙을 찾습니다. 각 항목마다 위치와 근거, 확신 수준을 적고 감사 보고서와 수정 제안 두 가지 결과물을 만듭니다. 단순히 프롬프트를 짧게 만들거나 기존 지침을 지우라는 뜻은 아닙니다.

특히 공식 문서는 수정안을 제안하되 사용자 동의 없이 파일에 적용하지 말라고 명시합니다. 원문 게시글의 “실행하면 모두 정리하고 마이그레이션한다”는 설명은 이 절차보다 강한 표현입니다. 실제 작업에서는 감사 결과를 검토한 뒤, 유지할 규칙과 고칠 규칙을 구분해야 합니다.

실행 전 정할 범위

감사는 요청에 명시된 파일이나 작업 디렉터리의 프롬프트 표면을 대상으로 합니다. 대상 모델도 함께 정해야 오래된 지침인지 판단할 수 있습니다. 다른 모델이나 다른 프로젝트에서 필요한 규칙을 근거 없이 제거하지 않도록, 제안된 변경마다 현재 코드나 문서와 맞는지 확인하는 과정이 남습니다.

요약

  • 원문은 Anthropic의 prompt-audit 절차를 소개합니다.
  • 공식 절차의 결과물은 위치·근거가 있는 감사 보고서와 수정 제안입니다.
  • 수정안은 검토 대상이며 공식 문서는 사용자 동의 없는 자동 적용을 지시하지 않습니다.