jurisupport-plugins

변호사용 클로드코드 통합 패키지 — 한국 송무 자동화의 표준 워크플로우

쥬리서포트 주식회사 (jurisupport.com)

한 줄 요약

사건폴더를 던지면 사실관계 정리 → 쟁점 추출 → 법령·판례 검증 → 준비서면 초안·완성본까지 자동 작성합니다. 모든 단계에 변호사 책임 검증을 거치며, 데이터 보호 Hook은 알려진 외부 도구와 한국형 식별정보 패턴을 탐지하는 보조 안전장치로 작동합니다.

그간의 주요 업데이트

JuriSupport는 초기 프로토타입 이후, 설치 안정성·송무 작성 흐름·법률자료 검증·개인정보 보호를 중심으로 개선되어 왔습니다.

• Claude Opus 5/high 지원: JuriSupport 스킬이 현재 세션의 Opus 5/high 설정을 일관되게 상속하고, 사무소별 로컬 플레이북에서 문체·검증 기준·저장 경로를 불러옵니다.
• 한 줄 설치 안정화: macOS/Linux/Windows 설치 흐름을 정리하고, Windows winget·긴 경로·PowerShell·의존성 설치 실패 케이스를 보강했습니다.
• 송무 워크플로우 통합: 사건 인테이크부터 쟁점 정리, 법령·판례 검증, 준비서면 초안·정본·PDF 흐름까지 JuriSupport 플러그인 중심으로 통합했습니다.
• 모의변론 강화: mock-hearing이 청구권규범, 요건사실, 입증책임, 항변·재항변, 판결 유추·구별 순서로 서면을 점검하도록 개선했습니다.
• 로컬 법률자료 확장: 법제처 OC 키가 없어도 실습 가능한 오프라인 법령 폴백과 clean-legal-db 오프라인 검색을 추가했습니다.
• 과거 사건 활용 개선: case-records 검색이 실제 준비서면·신청서면 등 재사용 가능한 서면 중심으로 작동하도록 정리했습니다.
• 법원 양식·판례 검색 보강: court-forms, beopgoeul-search, lbox-guide 등 공개·로컬 자료 기반의 보조 검색 흐름을 추가했습니다.
• 개인 프로필 완성 기능: 변호사가 자신의 사건자료와 작성 이력을 바탕으로 프로필을 정리하고, 명시적 동의 후 JuriSupport에 업로드할 수 있게 했습니다.
• 보안·동의 흐름 정리: 의뢰인 정보 보호, 외부 업로드 전 웹 동의, 로컬 토큰 처리, 설치 진단 리포트 흐름을 보강했습니다.

⚠️ 가장 먼저 읽어야 할 것

빠른 시작

macOS / Linux — 한 줄 자동 설치

bash <(curl -fsSL https://raw.githubusercontent.com/jurisupport/jurisupport-plugins/main/bootstrap.sh)

위 한 줄이 Homebrew → jq·git·python·node → Claude Code → 본 패키지 git clone → install.sh 실행까지 이어서 설치합니다 (약 5~10분).

보안이 엄격한 사무소 환경에서는 한 줄 설치 전에 스크립트를 내려받아 검토하거나, 릴리스 태그를 고정해 수동 설치하는 방식을 권장합니다.

bootstrap 완료 후:

claude                            # 새 터미널에서 OAuth 로그인 1회

Windows — 한 줄 자동 설치 (PowerShell)

PowerShell 실행 방법:

1. Windows 시작 메뉴에서 PowerShell 검색
2. Windows PowerShell 또는 PowerShell을 일반 실행 (관리자 권한 불필요)
3. 아래 한 줄을 붙여넣고 Enter

irm https://raw.githubusercontent.com/jurisupport/jurisupport-plugins/main/windows-bootstrap.ps1 | iex

이 한 줄이 모든 의존성(Git/Node/Python/Chrome/Tesseract/qpdf/Ghostscript/rclone) + Claude Code + 본 레포 + install.sh까지 자동으로 끝냅니다 (약 15분).

회사 보안 정책이나 ExecutionPolicy 때문에 irm | iex가 차단되면 같은 PowerShell 창에서 아래 두 줄을 대신 실행하세요.

Set-ExecutionPolicy Bypass -Scope Process -Force
iwr https://raw.githubusercontent.com/jurisupport/jurisupport-plugins/main/windows-bootstrap.ps1 -UseBasicParsing | iex

PowerShell 한 줄 설치도 빠른 시작용입니다. 조직 보안 정책이 엄격하면 스크립트 내용을 먼저 검토한 뒤 실행하세요.

사용자가 답할 것: UAC 팝업 "예", install.sh 단계별 [Y/n], 법제처 Open API 키가 이미 있으면 OC 입력(없으면 Enter로 건너뛰고 오프라인 법령 폴백 사용), (선택) Gemini API 키.

제3자 PC 설치를 지원해야 하면 진단 리포트 옵션을 켠 뒤 실행하세요. 실패 시 설치 로그·Windows 버전·winget/Git/Node/npm/Python/rclone/Claude Code 상태를 ZIP으로 묶고, 업로드 엔드포인트로 전송을 시도합니다.

$env:JURISUPPORT_SUPPORT_REPORT = "1"
irm https://raw.githubusercontent.com/jurisupport/jurisupport-plugins/main/windows-bootstrap.ps1 | iex

자세한 포함 정보와 엔드포인트 계약: SUPPORT_REPORTS.md

WSL2를 선호하시면 WINDOWS_WSL.md (W2 옵션) 참조 — 회사 보안프로그램이 매우 강한 경우만 권장.

사전 준비

• 클로드 Pro/Max 가입 (https://claude.ai/upgrade) — 결제 필요, 자동화 불가
• (Mac/Linux) 관리자 비밀번호 — Homebrew 설치 시 1회 입력
• (Windows) winget 사용 가능한 Windows 10 22H2+ 또는 Windows 11

수동 설치 (사전 준비물 직접 설치한 경우)

git clone -c core.autocrlf=false -c core.longpaths=true https://github.com/jurisupport/jurisupport-plugins.git
cd jurisupport-plugins
./install.sh              # Mac/Linux/Windows(Git Bash) 공통

Windows에서 플러그인이 계속 예전 버전으로 보이면 PowerShell에서 강제 갱신:

cd $env:USERPROFILE\jurisupport-plugins
git config core.autocrlf false
git config core.longpaths true
git fetch origin main
git reset --hard origin/main
claude.cmd plugin marketplace update jurisupport-plugins
claude.cmd plugin uninstall --keep-data -y jurisupport
claude.cmd plugin install jurisupport@jurisupport-plugins

수동 사전 설치 가이드: AUDIENCE_PRE_INSTALL.md (Mac/Linux) / WINDOWS_NATIVE.md (Windows 네이티브) / WINDOWS_WSL.md (Windows WSL2)

설치 후 첫 사건폴더에서:

cd ~/사건/내사건폴더
# Windows PowerShell이면 claude.cmd
claude.cmd

# Mac/Linux/Git Bash
cd ~/사건/내사건폴더
claude

/jurisupport:cold-start-interview      # 최초 1회: 사무소 플레이북 학습
/jurisupport:brief-protocol            # 준비서면 작성 표준 절차

무엇이 들어 있나

지원 환경

사전 준비물

1. 클로드 Pro 또는 Max 계정 (월 20달러 이상) — https://claude.ai/upgrade
2. 클로드코드 설치 — https://docs.claude.com/claude-code
3. Homebrew (macOS) 또는 apt (Linux)
4. Python 3.9+ (3.10+ 권장)
5. 법제처 Open API 키 — korean-law MCP 정식 법령·판례 조회용. 발급 전에도 설치와 실습은 가능하며, 오프라인 법령 폴백을 사용합니다 (발급 가이드)
6. Google Gemini API 키 — https://aistudio.google.com/apikey
   • legal-books·case-records 임베딩 생성용 (해당 toolkit 설치 시만)
   • 테스트·소량 인덱싱은 무료 tier로 가능하나, 교과서 여러 권을 쉽게 인덱싱하려면 결제 연결된 유료 tier 권장
7. Google Chrome — beopgoeul-search toolkit용 (Selenium)

설치 단계 (install.sh 12단계)

부분 설치: INSTALL_PARTIAL.md 참조.

법원 양식 전체 자산화

전자소송포털 공개 양식모음 전체를 원본 파일 + Markdown 파생물로 레포에 넣으려면:

bash toolkit/court-forms/install.sh
~/court-forms/scripts/court_forms.py sync --download all --continue-on-error
~/court-forms/scripts/court_forms.py export-md \
  --output data/court-forms \
  --copy-files \
  --download-missing \
  --continue-on-error

생성물은 data/court-forms/forms/<분야>/<form_id>_<제목>/ 아래에 들어갑니다. index.md는 검색·초안 작성용이고, original/의 공식 HWP/PDF/DOC 파일을 제출·편집 기준으로 둡니다.

사용 시작 (콜드스타트)

설치 후 다음 순서로 시작합니다. 자세한 단계: COLD_START.md 참조.

1. guides/00_security.md 정독 (5분)
2. guides/01_jurisupport_alt.md — JuriSupport 미사용 시 사건정보 관리법 (10분)
3. 첫 사건 시도 — /jurisupport:cold-start-interview 실행하여 사무소 플레이북 작성
4. 첫 준비서면 작성 — /jurisupport:brief-protocol 실행

legal-books · case-records — 처음엔 빈 DB, 점진적으로 채우기

위 두 toolkit은 설치 직후 검색 서버·DB만 빈 채로 세워집니다. 본 패키지가 변호사의 보유 서적·과거 사건을 가져올 방법이 없으므로 사용자가 직접 채워야 합니다.

자세한 가이드: legal-books docs/book-scanning.md, 03_case_records.md. install.sh가 toolkit 설치 직후 동일한 안내를 출력합니다.

문서 인덱스

가이드 (guides/)

메타

언인스톨

본 패키지가 만든 등록·데이터를 단계별로 제거할 수 있습니다.

Mac / Linux / Windows (Git Bash)

cd ~/jurisupport-plugins
./uninstall.sh           # 각 단계마다 Y/n 확인 (10단계)
./uninstall.sh --yes     # 전 항목 자동 제거 (사용자 데이터는 보존)
./uninstall.sh --dry-run # 미리보기만

제거 대상 (10단계):

1. 데이터 보호 Hook 등록 해제 (settings.json jq 편집)
2. JuriSupport/korean-law 플러그인 + marketplace 등록 해제 (claude plugin uninstall)
3. 클로드코드 스킬 (lbox-guide, beopgoeul-search, court-forms, legal-books, case-records)
4. ~/legal-books/ (서버 stop + 폴더)
5. ~/case-records/ (서버 stop + 폴더)
6. ~/court-forms/ (법원 양식 메타DB·다운로드 캐시)
7. ~/jurisupport-beopgoeul/
8. ~/사건/_사건정보관리표.csv (사용자 데이터 가능성 — 확인 후)
9. ~/.jurisupport/secrets.env (Gemini API 키 — 확인 후)
10. JuriSupport MCP 등록 해제 (claude mcp remove)

보존 대상 (기본): ~/사건/ 폴더, Claude Code 자체, 시스템 패키지(brew/apt/winget로 깐 것), jurisupport.com 계정·데이터.

Mac — 시스템 패키지까지 모두 제거

# 1) 본 패키지 제거
cd ~/jurisupport-plugins && ./uninstall.sh --yes
rm -rf ~/jurisupport-plugins

# 2) Claude Code (npm 글로벌)
npm uninstall -g @anthropic-ai/claude-code

# 3) Homebrew 시스템 패키지 (다른 용도로 안 쓰면)
brew uninstall jq ocrmypdf tesseract tesseract-lang
brew uninstall --cask google-chrome
# Node·Python은 다른 앱도 쓸 가능성 → 보존 권장

Linux — 시스템 패키지까지

cd ~/jurisupport-plugins && ./uninstall.sh --yes
rm -rf ~/jurisupport-plugins
npm uninstall -g @anthropic-ai/claude-code
sudo apt remove jq ocrmypdf tesseract-ocr tesseract-ocr-kor google-chrome-stable

Windows — 시스템 패키지까지 모두 제거

# PowerShell
irm https://raw.githubusercontent.com/jurisupport/jurisupport-plugins/main/windows-uninstall.ps1 | iex

위 스크립트가 순서대로:

1. uninstall.sh 호출 (Git Bash) — 등록·데이터 제거
2. npm uninstall -g @anthropic-ai/claude-code — Claude Code 제거
3. ~/jurisupport-plugins/ 폴더 제거
4. winget 시스템 패키지(Git, Node, Python, Chrome, rclone 등) — 개별 Y/n 확인, 기본 보존

라이선스 및 책임 면책

MIT License. 본 패키지의 코드·문서·템플릿은 자유롭게 사용·수정·배포할 수 있습니다.

다만 다음은 본 패키지와 무관하며, 사용 변호사 본인의 절대적 책임입니다.

• 클로드코드가 생성한 결과물의 정확성·법적 적합성 검증
• 의뢰인 정보 보호·비밀유지의무 (변호사윤리장전·개인정보보호법)
• 법원·의뢰인·상대방 제출·전달 전 최종 검토
• 데이터 보호 Hook은 보조 수단이며 완전한 유출 방지를 보장하지 아니함

쥬리서포트 (JuriSupport)

본 패키지는 쥬리서포트 주식회사가 한국 송무 변호사 커뮤니티에 기여하기 위해 공개 배포합니다.

• 홈페이지: jurisupport.com
• 이슈·문의: GitHub Issues
• 보안 신고: admin@jurisupport.com (공개 issue 금지)
• 회사 소개: 한국 변호사·법무법인 전용 사건 관리 SaaS

본 패키지가 권장하는 통합

JuriSupport SaaS와 연동하면 사건·문서·기일·할일·증거를 통합 관리할 수 있습니다. 사건 50건까지 무료라 부담 없이 시작 가능합니다.

시작 흐름:

1. jurisupport.com 가입 (사건 50건까지 무료)
2. jurisupport.com/profile 에서 API 토큰 발급
3. install.sh가 토큰을 입력받아 MCP 등록 (또는 수동: PowerShell은 claude.cmd mcp add ..., Git Bash/Mac/Linux는 claude mcp add ...)
4. jurisupport.com/cases 에서 사건 등록 — 전자소송 사건목록 엑셀 업로드하면 자동 일괄 등록
5. 클로드코드에서 /jurisupport:brief-protocol 실행 시 사건 자동 인식

보안 메모: 현재 Claude Code CLI는 HTTP/SSE MCP bearer header를 --header 인자로 등록합니다. install.sh는 검증 단계의 argv 노출은 줄이지만, MCP 등록 순간에는 같은 PC의 프로세스 목록에 토큰이 짧게 보일 수 있습니다. 공용 PC나 감염이 의심되는 환경에서는 토큰 등록을 미루고 안전한 장비에서 진행하세요.

SaaS 미사용 시에도 CSV 사건정보 관리표 + Obsidian(MD 편집·뷰어) 조합으로 동등한 기능을 활용할 수 있습니다 (01_jurisupport_alt.md 참조).

기여

PR·이슈 환영합니다. 다만 의뢰인 정보·API 키 누출 방지가 최우선 원칙이며, 본 저장소는 한국 송무 실무에 특화되어 있습니다. 자세한 사항은 CONTRIBUTING.md 참조.