Phase 66-2

플러그인의 개념과 구조

플러그인은 특정 전문 분야를 위한 CLAUDE.md 확장 모듈입니다. 역할→지시→규칙→출력형식의 구조를 배우고, 전문가 모드 전환을 이해합니다.

플러그인 = 전문가 모드

CLAUDE.md가 '우리 사무실의 기본 매뉴얼'이라면, 플러그인은 '특정 업무를 위한 전문 매뉴얼'입니다. 특정 분야 전문 노무사를 AI로 구현한 것이라고 생각하시면 됩니다. 비유하자면 이렇습니다: - CLAUDE.md = 사무실 직원 핸드북 (모든 직원이 따르는 기본 규칙) - 플러그인 = 업무별 전문 매뉴얼 (산업안전 전문 노무사, 중대재해 전문 노무사, 병원 노무 전문 노무사 등) **기존:** 산업안전 사건이 들어오면 산안법 관련 조문을 찾고, 중대재해 사건이 들어오면 중처법 관련 자료를 꺼냅니다. 전문 분야가 바뀔 때마다 참고 자료와 검토 기준이 달라집니다. **AI 활용:** 플러그인을 활성화하면, Claude가 해당 분야의 전문가처럼 행동합니다. 산업안전 플러그인을 켜면 산안법·시행령·시행규칙 기준으로 점검하고, 중대재해 플러그인을 켜면 중처법 적용 여부·경영책임자 범위·안전보건확보의무 이행 현황을 자동으로 검토합니다. 노무사 사무실에서 "이 사건은 산재 전문가에게 맡기자", "이건 중대재해 TF에서 처리하자"라고 하는 것처럼, 플러그인은 AI에게 전문가 역할을 부여하는 것입니다.
# 전문 분야별 플러그인(CLAUDE.md) 만들기 (터미널에서):

# 산재 전문가 플러그인
mkdir -p ~/업무/산재사건_김OO
cat > ~/업무/산재사건_김OO/CLAUDE.md << 'EOF'
# 산업재해 전문 노무사
당신은 산업재해보상보험 전문 노무사입니다.
## 적용 법령
- 산업재해보상보험법, 산업안전보건법
## 주요 업무
- 업무상 재해 인정 기준 분석
- 요양급여 신청서 검토
EOF

# 해당 폴더에서 Claude Code 시작 → 자동으로 산재 전문가 모드:
cd ~/업무/산재사건_김OO && claude

플러그인의 4가지 구성 요소

좋은 플러그인은 4가지 요소로 구성됩니다. 1. 역할 (Role): "당신은 ~입니다" 2. 지시 (Instructions): "~를 해야 합니다" 3. 규칙 (Rules): "~하면 안 됩니다", "~할 때는 반드시 ~하세요" 4. 출력형식 (Output Format): "결과는 ~형식으로 제시하세요"
# 플러그인 구조 예시: 산업안전 점검 플러그인

## 1. 역할 (Role)
당신은 산업안전보건 전문 노무사입니다.
사업장의 안전보건 관리체계를 점검하고 개선안을 제시합니다.

## 2. 지시 (Instructions)
- 산업안전보건법 및 시행령·시행규칙 기준으로 점검
- 업종별 안전보건관리 기준 적용
- 중대재해처벌법 적용 대상 여부 확인
- 안전보건관리체계 구축 현황 평가

## 3. 규칙 (Rules)
- 법정 의무사항과 권고사항을 명확히 구분할 것
- 과태료/벌칙 조항은 반드시 금액/형량과 함께 명시
- 개선 권고 시 우선순위(긴급/중요/보통)를 표시
- 현장 사진이나 자료 없이 안전상태를 단정하지 말 것

## 4. 출력형식 (Output Format)
### 점검 결과 보고서
| 점검항목 | 법적근거 | 현황 | 적합/부적합 | 개선사항 | 우선순위 |
기한: 각 항목별 법정 이행기한 명시
비용: 예상 소요 비용 범위 제시
TIP: 플러그인은 일반 CLAUDE.md보다 훨씬 상세합니다. 해당 분야의 전문 지식을 최대한 구체적으로 넣을수록 Claude의 응답 품질이 올라갑니다.

프로젝트별 플러그인 전환

사건 폴더마다 다른 CLAUDE.md를 두면, 폴더를 이동할 때마다 Claude가 자동으로 다른 전문가 모드로 전환됩니다. **기존:** 산재 사건을 처리하다가 해고 사건으로 넘어가면, 머릿속에서 관련 법령과 검토 기준을 전환해야 합니다. 자료도 다시 꺼내야 합니다. **AI 활용:** 산재 폴더에서 해고 폴더로 이동하는 것만으로, Claude가 산재 전문가에서 해고 전문가로 자동 전환됩니다. 별도 설명 없이 해당 사건의 맥락을 바로 파악합니다.
# 폴더 구조 예시:

업무/
├── 산재사건_김OO/
│   ├── CLAUDE.md          ← 산재 전문가 플러그인
│   ├── 요양급여신청서.docx
│   └── 의무기록.pdf
│
├── 해고사건_이OO/
│   ├── CLAUDE.md          ← 해고·징계 전문가 플러그인
│   ├── 해고통지서.pdf
│   └── 근로계약서.pdf
│
├── 병원노무_OO의원/
│   ├── CLAUDE.md          ← 병원 노무관리 플러그인
│   ├── 취업규칙.docx
│   └── 급여대장.xlsx
│
└── .claude/
    └── CLAUDE.md          ← 글로벌 기본 설정

# 산재사건 폴더에서 Claude Code를 열면
# → 산재 전문가로 동작
# 해고사건 폴더에서 열면
# → 해고·징계 전문가로 동작
TIP: 하나의 잘 만든 플러그인(CLAUDE.md)은 같은 유형의 다른 사건에도 재사용할 수 있습니다. 템플릿으로 관리하세요.

플러그인 설계 체크리스트

플러그인을 만들 때 다음 체크리스트를 활용하세요. 역할 설정: - Claude가 어떤 전문가인지 명확한가? - 사건 유형(사업주 측/근로자 측)이 지정되어 있는가? 업무 지시: - 적용할 법령 목록이 있는가? - 분석/검토 절차가 단계별로 정리되어 있는가? - 산출물(문서, 보고서 등)이 명시되어 있는가? 규칙: - 금지사항이 있는가? (할루시네이션 방지, 단정 금지 등) - 불확실할 때의 행동 지침이 있는가? - 정보 부족 시 질문하도록 되어 있는가? 출력 형식: - 표, 목록, 문장 등 형식이 지정되어 있는가? - 파일 형식(docx, xlsx 등)이 필요한가?
# 플러그인(CLAUDE.md) 템플릿을 한 번에 만들기 (터미널에서):

cat > CLAUDE.md << 'EOF'
# [업무 유형] 전문 플러그인

## 1. 역할 (Role)
당신은 [전문 분야] 전문 노무사입니다.
[구체적 역할 설명]

## 2. 지시 (Instructions)
- [적용 법령 1]
- [적용 법령 2]
- [분석/검토 절차]

## 3. 규칙 (Rules)
- [금지사항]
- 확실하지 않으면 단정하지 말 것
- 정보 부족 시 반드시 질문할 것

## 4. 출력형식 (Output Format)
| 점검항목 | 법적근거 | 현황 | 판단 | 개선사항 |
EOF

# 작성 후 Claude Code에서 테스트:
claude

핵심 정리

  • 플러그인은 특정 업무를 위한 전문 CLAUDE.md입니다
  • 역할→지시→규칙→출력형식 4가지 요소로 구성합니다
  • 사건 폴더마다 다른 CLAUDE.md를 두면 자동으로 전문가 모드가 전환됩니다
  • 잘 만든 플러그인은 같은 유형의 사건에 템플릿으로 재사용할 수 있습니다

이 강의가 어떠셨나요?