구성

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넘버 매핑을 담습니다.

이 파일들이 하네스를 어떻게 재구성할지에 대한 기준 문서입니다. 사건 처리만 할 거라면 볼 필요가 없고, 하네스 자체를 수정할 때 봅니다.

다음

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