클로드 코드 레벨 테스트 4단계

프로젝트 폴더 맨 위에 두는 글 파일이에요. 대화를 새로 켤 때마다 클로드가 자동으로 읽어요. "우리 프로젝트는 pnpm 써", "답은 한국어로" 같은 걸 매번 다시 말할 필요가 없어져요.

클로드 코드에 아래 문장을 붙여 넣은 뒤, 그 아래 상자 내용(10줄 예시)을 이어 붙이세요. 내 프로젝트에 맞게 고쳐도 돼요.

# 프로젝트 규칙

## 도구
- 패키지 매니저는 pnpm (npm 쓰지 않기)
- 커밋 전에 반드시 `pnpm test` 실행

## 답변
- 답변은 한국어로, 결론부터
- 파일을 고치기 전에 무엇을 바꿀지 한 줄로 먼저 말하기

## 구조
- API 핸들러는 src/api/ 아래에만

> /init

200줄을 넘기지 마세요. 길수록 오히려 덜 지켜요. "코드 예쁘게" 같은 두루뭉술한 말 대신 "2칸 들여쓰기"처럼 지켰는지 확인할 수 있는 문장으로 쓰는 게 핵심이에요.

반복해서 시키는 일을 하나로 묶어 두는 거예요. 만들어 두면 슬래시 한 단어(예: /review)로 실행되고, 상황이 맞으면 클로드가 알아서 꺼내 쓰기도 해요. 예시는 "아직 저장(커밋) 안 한 변경을 요약하고 위험한 곳을 표시하는" 스킬이에요.

---
description: 커밋 안 한 변경을 요약하고 위험한 부분을 표시한다. 사용자가 "뭐 바꿨어", "리뷰해줘", 커밋 메시지를 물을 때 사용.
---

## 지금 바뀐 것

!`git diff HEAD`

## 할 일

위 변경을 3줄로 요약한다.
빠진 에러 처리, 하드코딩된 값, 테스트가 필요한 곳은 ⚠ 로 표시한다.
변경이 없으면 "커밋 안 한 변경 없음"이라고만 답한다.

맨 위 설명(description) 한 줄이 제일 중요해요. 클로드는 이 문장을 보고 "지금 이 스킬을 쓸 때인가"를 판단해요. 느낌표로 시작하는 줄은 그 명령을 먼저 실행해서 결과를 클로드에게 넣어 주는 부분이에요.

.claude/skills/review/SKILL.md

규칙 파일에 적은 건 "참고 사항"이라 클로드가 가끔 어겨요. 공식 문서도 "무조건 막고 싶으면 훅을 쓰라"고 해요. 훅은 정해진 순간(명령 실행 직전 등)에 강제로 실행되는 장치예요. 예시는 폴더를 통째로 지우는 명령을 실행 직전에 막는 훅이에요.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(rm -rf *)",
            "command": "echo '삭제 명령은 막혀 있습니다' >&2; exit 2"
          }
        ]
      }
    ]
  }
}

PreToolUse 는 "도구를 쓰기 직전", matcher: Bash 는 "터미널 명령에만 건다"는 뜻이에요. exit 2 로 끝나면 그 명령이 막히고 클로드에게 이유가 전달돼요.

.claude/settings.json

다 되면 이렇게 시험해 보세요.

무거운 조사를 딴 창(별도 대화)에 맡기고 요약만 받는 장치예요. 검색 기록 수백 줄이 내 대화에 안 쌓이니까 대화가 느려지거나 멍청해지지 않아요.

---
name: researcher
description: 라이브러리·도구 비교, 문서 조사처럼 읽을 게 많은 일. "조사해줘", "비교해줘", "뭐 쓸지 골라줘"라고 하면 위임.
tools: Read, Grep, Glob, WebSearch, WebFetch
model: sonnet
---

너는 조사 전담이다. 후보를 찾고 근거를 비교한 뒤,
**결론 1줄 + 근거 2~3개**만 돌려준다. 과정 로그는 보내지 않는다.
확실하지 않은 건 "확인 못 함"이라고 적는다.

name(이름)과 description(언제 맡길지) 두 줄은 필수예요. tools 는 이 도우미가 쓸 수 있는 도구 목록이고(안 적으면 전부), model: sonnet 은 조사엔 빠르고 싼 모델을 쓰라는 뜻이에요. 아래 본문이 이 도우미의 성격이 돼요.

.claude/agents/researcher.md

다 되면 이렇게 시험해 보세요.

세팅이 실제로 잡혔는지 한 번에 보는 방법이에요. 대화창에 이렇게 치세요.

Memory files 에 CLAUDE.md 가 있으면 1단계. /review 가 실행되면 2단계. /hooks 에 PreToolUse 가 보이면 3단계. 조사를 시켰을 때 도우미에게 맡기면 4단계예요.