AI 지침 파일 짜는 법
AI 지침 파일(CLAUDE.md)은 어떻게 작성해야 하나요? 맨 위에 절대 규칙을 10개 이내로 두고 작업별 도구를 표로 정리하며, 자세한 내용은 다른 파일에 두고 경로만 적어 짧게 유지합니다.
AI가 매번 같은 방식으로 일하게 하려면 규칙을 파일로 둡니다. 길어지면 매 대화의 비용이 되니 짧게 유지합니다.
이렇게 씁니다
- 맨 위에 절대 규칙을 10개 이내로 둡니다. 말투, 비밀 키 취급, 배포 전 승인, 되돌릴 수 없는 일 앞에서 멈추기.
- 그다음 작업 유형별로 먼저 쓸 도구와 스킬을 표로 정리합니다.
- 자세한 설명은 다른 파일에 두고 경로만 적습니다. 지침 파일은 목차 역할만 합니다.
- 규칙마다 날짜와 이유를 한 줄 붙입니다. 나중에 이 규칙을 지워도 되는지 판단할 근거가 됩니다.
- 바뀐 규칙은 지우지 말고 이력으로 내려서 왜 바뀌었는지 남깁니다.
- 새 기능은 바로 만들게 하지 않습니다. 한 줄 설명과 완료 기준 2~3개를 먼저 받아 보고 승인한 뒤 시작합니다.
복사해서 쓰는 프롬프트
지침 파일 뼈대
# 프로젝트 지침 ## 절대 규칙 1. 비밀 키 값을 화면에 출력하지 않는다. 2. 배포는 승인을 받은 뒤에만 한다. 3. 되돌릴 수 없는 작업 앞에서는 멈추고 위험을 보고한다. 4. 새 기능은 "한 줄 설명 + 완료 기준 2~3개"를 먼저 보여 주고 승인 후 시작한다. ## 작업별로 먼저 쓸 것 | 작업 | 먼저 쓸 것 | |---|---| | (예: 화면 만들기) | (예: 디자인 점검 스킬) | ## 상세 문서 - 제품 설명: docs/product.md - 디자인 기준: docs/design.md ## 변경 이력 - YYYY-MM-DD: (무엇을 왜 바꿨는지)