구성

legal-workflow는 런타임 에이전트 6개와 스킬 10개로 구성됩니다. 어느 에이전트가 왜 도는지가 궁금할 때 보는 자리입니다. 전체 구성의 정본은 .claude/agents/와 .claude/skills/이고, 여기서는 어떻게 맞물리는지를 봅니다.

런타임 에이전트 6

코어 넷과 조건부 둘로 갈립니다.

에이전트	역할	활성화
preprocessing-agent	자료 전처리	항상 (①)
fact-agent	사실관계 구조화, 보고서	사실 산출 선택 시 (②)
legal-research-agent	법리 검토, 인용 검증	법리 산출 선택 시 (③)
qa-agent	산출물 QA, 검수 패키지	항상 (④)
brief-agent	서면 초안 빌더	조건부 (⑤)
contract-agent	계약 검토, redline	조건부 (⑥)

코어 넷이 전처리부터 QA까지를 채우고, 조건부 둘은 의뢰 성격에 따라 편성됩니다.

스킬 10

스킬	역할
legal-case-orchestrator	사건 실행 진입점. 인테이크부터 검수 게이트까지 체이닝
legal-setup	1회성 설정. 자산 설치, API 키, 라이선스
ecourt-organizer	전처리. PDF, DOCX, HWP와 HWPX, OCR, ZIP
fact-extractor	사실 구조화, 모순 탐지 → facts.json
fact-report-builder	5시트 엑셀 사실관계 보고서
legal-review-ko	법리 검토, 판례 검증 (korean-law-mcp)
qa-review-ko	6대 카테고리 검수, 트랙체인지, 검수 패키지
brief-drafter-ko	서면 빌더 (HWPX 슬롯 치환), 조건부
contract-review-ko	계약 검토, redline, 조건부
legal-workflow	도메인 청사진. 사건 실행용이 아니라 재설계 참조용

조건부 활성화

조건부 단계는 입력 상태에 따라 켜지거나 보류됩니다.

• brief-agent — 양식원본/이 비어 있으면 미실행합니다. 양식 없는 서면 빌더는 무의미하기 때문에(도메인 함정), blocked_no_form 상태로 보고하고 사용자에게 법인 표준 양식을 요청합니다.
• contract-agent — 계약 검토 의뢰가 아니면 편성하지 않습니다. 일반 소송이나 자료 분석에는 미편성입니다.
• legal-research-agent의 Mock 모드 — 법제처 API 키가 없으면 검색을 실행하지 않고 인용을 [검증 미완]으로 표시합니다.

산출물 범위에서 선택된 단계만 실행되고, 전처리(①)는 항상 먼저 돕니다.

데이터 전달 규칙

에이전트 간 전달은 파일 경로로만 합니다. 본문을 복붙하지 않습니다. 컨텍스트를 아끼는 자리입니다. 각 단계 완료는 ✓ {단계} 완료 한 줄과 메타데이터 요약으로 보고하고, 실패만 상세히 보고합니다(성공 시 침묵). CASE_INFO.md의 상태 필드를 단계마다 갱신합니다.

도메인 청사진과 references

legal-workflow 스킬은 사건 실행용이 아니라 시스템 설계 명세입니다. 이 하네스를 재설계하거나 확장할 때 참조하는 블루프린트입니다. 사건을 처리할 때는 legal-case-orchestrator를 쓰고, legal-workflow는 별개입니다.

legal-workflow 스킬의 references/에 청사진이 나뉘어 있습니다.

• principles.md — 원칙
• assets.md — 베이스 자산 매핑
• modules.md — 모듈 정의
• phases.md — 단계 정의
• variants.md — Variants, Mixins, D넘버 매핑

이 자리들이 하네스를 어떻게 재구성할지의 정본입니다. 사건 처리만 할 거라면 볼 필요가 없고, 하네스 자체를 손볼 때 봅니다.

다음

단계별 상세로 갑니다. 전처리, 사실관계와 법리검토, 검수와 서면 순서입니다.