korean-contracts

한국 사업자를 위한 AI 계약서 자동 작성 도구

창업자·HR 담당자·소상공인이 근로계약서, 알바계약서, 프리랜서 계약서, 외주용역계약서 등 8종의 계약서를 Claude Code에서 대화형으로 작성할 수 있는 스킬 모음입니다. 2026년 최저임금·최신 대법원 판례를 반영하고, RULE 1~14 법률 검증을 통과한 계약서 초안을 .txt + .docx 두 가지 형식으로 자동 생성합니다.

한국 법률 AI 허브 SpeciAI에서 만들고 있습니다. 계약·노동·투자·지재권을 AI로 해결하는 창업자·변호사 커뮤니티에 초대합니다. → discord.gg/3gYGuMcqgb | @kimlawtech

지원 계약서 8종

계약서 생성 예시

아래는 /employment-contract 스킬이 실제로 생성한 근로계약서입니다. 인터뷰 응답만 입력하면 조항이 자동 완성되고, RULE 1~14 법률 검증을 거쳐 .txt + .docx 파일로 저장됩니다.

이 화면에서 확인할 수 있는 것:

• 법적 면책 고지 자동 삽입
• 근로기준법 §17 필수 5항목(계약기간·업무·근로시간·임금·휴가) 자동 구성
• 임금 구성 항목 분리 기재 (기본급 + 수당 + 합계)
• 최저임금 10,320원/시 자동 검증 (미달 시 계약서 생성 차단)
• 통상임금 재직조건부 상여금 포함 문구 (대법원 2024.12.19.)

핵심 기능

20년 경력 공인노무사·변호사 페르소나

각 계약 유형마다 전문 페르소나가 인터뷰를 진행합니다. 법적 리스크를 먼저 설명하고 사용자가 이해한 뒤 입력할 수 있게 안내합니다.

RULE 1~14 자동 법률 검증

계약서 생성 전·후 14개 체크리스트를 자동 적용합니다.

기존 계약서 검토 및 개정법령 반영

사용 중인 계약서를 붙여넣으면 개정법령·최신 판례 기준으로 분석해 3단계로 분류된 검토 결과를 제공합니다.

수정할 항목을 고르면 원본 조항을 최대한 유지하면서 선택 항목만 반영해 재작성합니다.

자동 분기 처리

• 5인 이상/미만 — 가산수당·공휴일 유급·연차·부당해고 조항 자동 분기
• 주 15시간 이상/미만 — 주휴수당·4대보험 가입 기준 자동 적용
• 계약직 갱신기대권 방지 — 기간제 계약서에 자동 삽입

최신 법령·판례 반영

• 2026년 최저임금 10,320원/시 자동 검증 (미달 시 생성 차단)
• 대법원 2024.12.19. — 재직조건부 상여금 통상임금 포함 (고정성 폐지)
• 대법원 2024.12.26. — 포괄임금 최저임금 미달 부분 무효
• 배우자 출산휴가 20일 (남녀고용평등법 §18의2, 2025년 시행)
• 하도급법 2024.8.28. — 기술자료 유용 5배 손해배상
• 임금명세서 교부 의무 (근로기준법 §48②, 과태료 100만원)

🔒 MCP 보안 서버 (v2.1 신규)

가장 중요한 기능입니다. 계약서에 들어가는 근로자 이름·주민번호·주소·급여는 민감 개인정보이므로 Claude·Anthropic 서버에 평문으로 노출되지 않아야 합니다.

본 패키지는 Model Context Protocol (MCP) 로컬 서버를 내장해 개인정보를 토큰으로 마스킹한 뒤 Claude에 전달하고, 최종 파일 저장 시에만 사용자 맥에서 복원합니다.

처리 흐름

[사용자 입력]
"홍길동 대표, 이직원 직원, 월 300만원"
         ↓
[MCP 마스킹 — 사용자 맥 로컬]
"PERSON_B, PERSON_A, AMOUNT_3M"
         ↓
[Claude가 보는 것 — 토큰만]
계약서 조항을 토큰 상태로 생성
         ↓
[MCP 저장 — 사용자 맥 로컬에서 복원]
실제 값 치환 → .txt + .docx 저장

무엇이 보호되는가

세션 수명: 계약서 저장 직후 자동 삭제. 프로세스 종료 시에도 삭제.

제공되는 MCP 도구 5종

MCP 서버 설치

# 1. Python 의존성 설치
pip install mcp python-docx

# 2. Claude Desktop 설정 파일에 서버 등록
# ~/Library/Application Support/Claude/claude_desktop_config.json

설정 파일 내용:

{
  "mcpServers": {
    "korean-contracts": {
      "command": "python3",
      "args": ["/Users/<사용자>/Desktop/skill/korean-contracts/mcp-server/server.py"]
    }
  }
}

Claude Desktop을 재시작하면 MCP 서버가 자동 연결됩니다.

MCP 서버 없이도 동작

MCP가 연결되지 않은 환경에서는 플레이스홀더 모드로 자동 전환됩니다. 민감 필드가 [근로자 이름], [기본급] 형태의 대괄호로 표시되며, 사용자가 최종 파일에서 직접 기입하면 됩니다.

설치

요구 사항

• Claude Code 설치
• Git
• Python 3 (.docx 변환용, python-docx 패키지)

설치 명령

macOS / Linux

git clone https://github.com/kimlawtech/korean-contracts
cd korean-contracts
bash install.sh

Windows (PowerShell)

git clone https://github.com/kimlawtech/korean-contracts
cd korean-contracts
powershell -ExecutionPolicy Bypass -File install.ps1

설치 스크립트가 자동으로 처리하는 것:

1. 각 스킬을 ~/.claude/skills/에 심링크(macOS) 또는 Junction(Windows)으로 연결
2. Python 의존성 설치 (mcp, python-docx)
3. Claude Desktop 설정 파일에 MCP 서버 자동 등록
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

설치 후 Claude Desktop을 완전히 종료 후 재실행하면 MCP 서버가 자동 연결됩니다.

설치 경로 커스터마이즈

# macOS / Linux
CLAUDE_SKILLS_DIR=/your-project/.claude/skills bash install.sh

# Windows
$env:CLAUDE_SKILLS_DIR="C:\your-project\.claude\skills"
powershell -ExecutionPolicy Bypass -File install.ps1

Linux 사용자 안내

Linux는 현재 Claude Desktop 미지원입니다. 스킬 자체는 Claude Code CLI 또는 Codex CLI 에서 사용 가능합니다 (아래 "Codex CLI에서 사용하기" 참고).

Codex CLI에서 사용하기

Codex CLI 사용자도 이 스킬과 MCP 서버를 사용할 수 있습니다.

설치

install.sh (또는 install.ps1)는 시스템에 codex 명령이 있으면 자동으로 Codex CLI 설정에도 MCP 서버를 등록합니다.

수동으로 Codex만 등록하려면:

python3 mcp-server/install-config.py --target codex

~/.codex/config.toml 파일에 다음 항목이 자동 추가됩니다:

[mcp_servers.korean-contracts]
command = "python3"
args = ["<클론 경로>/mcp-server/server.py"]

사용

Codex CLI는 Claude Code의 슬래시 명령(/employment-contract)을 인식하지 않습니다. 대신 레포 루트의 AGENTS.md 파일을 자동으로 읽어 컨텍스트로 사용합니다.

cd ~/Projects/korean-contracts
codex "근로계약서 만들어줘"

또는 작업 지시를 명시적으로:

codex "shared/interview-all.md 의 [근로계약서] 인터뷰를 따라 근로계약서 작성해줘. \
       MCP 도구 mask_personal_info → save_contract 흐름으로 처리하고, \
       shared/references/legal-validation-rules.md 의 RULE 1~10 검증 적용."

Claude Code vs Codex CLI 차이

사용법

슬래시 명령어로 바로 시작

/korean-contracts         # 어떤 계약서가 필요한지 진단 (처음이면 여기서 시작)
/employment-contract      # 근로계약서
/parttime-contract        # 알바·단시간 계약서
/flexible-contract        # 유연근무 계약서
/freelancer-contract      # 프리랜서 계약서
/outsourcing-contract     # 외주용역계약서
/contract-amendment       # 근로조건 변경 합의서
/salary-renewal           # 연봉계약서
/daily-worker-contract    # 일용근로자 계약서

자연어로도 가능

"근로계약서 만들어줘"
"알바 계약서 필요해"
"프리랜서한테 맡기려는데 계약서 작성해줘"
"외주 계약서 만들어줘"
"연봉 인상했는데 계약서 갱신해줘"
"기존 계약서 검토해줘"

진행 흐름

1. 스킬 시작
2. 기존 계약서 여부 확인 (있으면 자동 분석)
3. 유형별 인터뷰 (1~2문항씩, 전문용어 풀어서 설명)
4. 입력 내용 요약 확인
5. RULE 1~14 법률 검증
6. .txt + .docx 파일 생성 및 저장

파일 구조

korean-contracts/
├── README.md
├── DISCLAIMER.md
├── install.sh                    macOS·Linux용 자동 설치
├── install.ps1                   Windows PowerShell용 자동 설치
├── AGENTS.md                     Codex CLI·기타 AI 에이전트용 컨텍스트
│
├── korean-contracts/           ← /korean-contracts (진입점 라우터)
│   └── SKILL.md
│
├── employment-contract/        ← /employment-contract
│   └── SKILL.md
│
├── parttime-contract/          ← /parttime-contract
│   └── SKILL.md
│
├── flexible-contract/          ← /flexible-contract
│   └── SKILL.md
│
├── freelancer-contract/        ← /freelancer-contract
│   └── SKILL.md
│
├── outsourcing-contract/       ← /outsourcing-contract
│   └── SKILL.md
│
├── contract-amendment/         ← /contract-amendment
│   └── SKILL.md
│
├── salary-renewal/             ← /salary-renewal
│   └── SKILL.md
│
├── daily-worker-contract/      ← /daily-worker-contract
│   └── SKILL.md
│
├── assets/
│   └── sample-employment-contract.png
│
├── mcp-server/                 ← 🔒 개인정보 보호 MCP 서버
│   └── server.py                 마스킹·복원·저장 5개 도구
│
├── examples/
│   └── TEST-CASES.md             16개 테스트 시나리오
│
└── shared/                     ← 8개 스킬 공용 리소스
    ├── interview-all.md          유형별 인터뷰 질문 전체
    ├── render.md                 템플릿 치환 프로토콜
    ├── docx-generator.py         .docx 변환 스크립트
    ├── references/
    │   ├── labor-law-checklist.md    근로기준법 §17 + 5인 비교표
    │   ├── minimum-wage-2026.md      2026 최저임금 10,320원 기준
    │   ├── four-insurance.md         4대보험 가입 기준
    │   ├── legal-validation-rules.md RULE 1~14 법률 검증 체계
    │   ├── freelancer-tax.md         원천징수·위장프리랜서
    │   ├── outsourcing-law.md        도급·위임·불법파견
    │   ├── contract-glossary.md      전문용어 사전
    │   └── penalty-risks.md          위반 제재 표
    └── templates/
        ├── employment-contract.tmpl
        ├── parttime-contract.tmpl
        ├── flexible-contract.tmpl
        ├── freelancer-contract.tmpl
        ├── outsourcing-contract.tmpl
        ├── contract-amendment.tmpl
        ├── salary-renewal.tmpl
        └── daily-worker-contract.tmpl

왜 이 스킬을 만들었나

사업자·프리랜서·인사담당자가 계약서 한 장 쓰려면 법무 비용이 많이 들거나, 인터넷 템플릿을 구해도 2026년 개정법령·대법원 최신 판례가 반영되지 않은 경우가 대부분입니다.

이 스킬은 Claude Desktop에 한 번 설치하면:

• 9가지 계약 유형을 대화만으로 작성
• 2026년 최저임금·통상임금·포괄임금 판례 자동 반영
• RULE 1~14 법률 검증 자동 통과
• 개인정보 마스킹 MCP 서버로 프라이버시 보호
• .txt + .docx 두 파일 자동 저장

5분 내외로 노무사 검토용 초안을 뽑을 수 있도록 만들었습니다.

누가 쓰면 좋은가:

• 직원을 처음 채용하는 스타트업 창업자
• 알바·프리랜서 계약이 잦은 소상공인
• 계약서 검토 업무가 반복되는 인사담당자
• 기존 계약서를 개정법령 기준으로 재검토해야 하는 노무사·변호사

기여하기

이 프로젝트는 커뮤니티 기여를 환영합니다.

• 버그 제보·기능 제안: Issues 에서 양식에 맞춰 등록
• 신규 계약 유형·법령 업데이트: 전용 Issue 템플릿 제공
• 자유 토론·사용 후기: GitHub Discussions
• Pull Request: CONTRIBUTING.md 규칙 준수 필수
• 실시간 채팅: Discord

커밋 메시지 규칙

[LABEL] 한국어 단문

라벨: [ADD] · [FIX] · [UPDATE] · [REMOVE] 4종만 사용. 자세한 규칙은 CONTRIBUTING.md 참고.

법률 관련 기여 주의사항

• 법령·판례 인용 시 출처 명시 필수 (조문 번호·판례 번호)
• 예시 데이터는 가명·가상 정보만 사용 (실명·실주민번호 금지)
• 면책 문구 삭제 금지

행동 강령: CODE_OF_CONDUCT.md

법적 면책

본 스킬이 생성하는 문서는 참고용 초안이며 법률 자문이 아닙니다. 실제 서명 전 반드시 공인노무사·변호사 검토를 받으세요.

커뮤니티 — SpeciAI

한국 법률 AI 허브 SpeciAI 디스코드에서 만나세요. 노동·계약·투자·지재권 법률 이슈를 AI와 함께 풀어가는 창업자·변호사 커뮤니티입니다.

초대 링크: discord.gg/3gYGuMcqgb

이 프로젝트를 만들고 있습니다: @kimlawtech 질문·기여·버그 제보를 환영합니다. Issue 또는 PR로 참여해주세요.

License

Apache License 2.0 — Copyright 2026 kimlawtech (SpeciAI).