CLAUDE.md와 스킬, 어떤 내용을 어디에 적나요?

프로젝트를 이해하는 데 필요한 짧은 사실과 공통 규칙을 남겨요. 문서가 있는 위치, 사용하는 명령, 고객 안내문에서 지킬 용어처럼 여러 작업에 영향을 주는 내용이에요.

‘항상 최고 품질로 작업하기’처럼 결과를 확인할 수 없는 말보다 ‘고객 안내문에서는 사용자를 회원으로 표기한다’처럼 판단 가능한 내용을 적어 주세요.

특정 요청이 있을 때만 필요한 순서가 길게 적혀 있다면 후보예요. ‘월간 보고서 작성 시 표를 읽고, 전월과 비교하고, 변동 항목을 설명한다’ 같은 절차를 별도 스킬로 만들 수 있어요.

옮긴 뒤에는 언제 그 스킬을 사용해야 하는지 description에 적어 주세요. 공통 규칙까지 모두 옮기면 관련 없는 작업에서 필요한 사실을 놓칠 수 있어요.

CLAUDE.md에는 ‘보고서 원자료는 data/, 완성 문서는 reports/에 둔다’는 위치 규칙을 남겨요. 보고서 스킬에는 ‘해당 월 파일을 확인하고, 누락값을 표시하고, 주요 변동을 설명한다’는 순서를 넣을 수 있어요.

작업 요청에는 매번 바뀌는 기간을 적어요. ‘9월 자료로 월간 보고서를 만들어 줘’처럼 요청값과 고정 규칙을 분리하면 다음 달에도 같은 스킬을 쓰기 쉬워요.

두 곳에 복사해 두면 나중에 한쪽만 고칠 수 있어요. 바뀔 가능성이 큰 용어표나 작성 기준은 원본 위치를 하나 정하고, 필요한 파일에서 어디를 읽을지 안내하는 편이 관리하기 좋아요.

다만 파일 이름만 적어 두고 읽는 조건을 빼먹지 마세요. ‘고객 공지를 교정할 때 references/terms.md를 먼저 읽는다’처럼 시점을 함께 적으면 필요한 자료를 찾기 쉬워요.

일반 프로젝트 질문 한 개와 옮긴 작업 요청 한 개를 새 대화에서 시험해 보세요. 일반 질문에서는 공통 규칙이 유지되는지, 작업 요청에서는 스킬의 세부 절차가 적용되는지 확인해요.

작업이 잘못됐다면 곧바로 파일을 합치기보다, 공통 사실을 빠뜨렸는지와 스킬이 선택됐는지를 따로 봐요. 두 문제가 다르면 고칠 곳도 달라요.

Q. CLAUDE.md를 스킬로 전부 바꾸면 되나요? A. 여러 작업에 필요한 프로젝트 사실은 남겨 두는 편이 좋아요. 특정 업무 절차가 길어진 부분부터 옮겨 보세요.

Q. 다른 AI 도구도 CLAUDE.md를 읽나요? A. 자동으로 읽는 지침 파일은 도구마다 달라요. 사용하는 도구의 프로젝트 지침 안내를 확인해 주세요.