법률 사무소 위키 컴파일러
사용 시기
- 위키에 새 사건 또는 오래된 사건 아카이브 추가 시
- 활동 로그 업데이트 후 재컴파일 시
- 기관 지식을 위해 위키 쿼리 시
- 위키 문서에 대한 린트/상태 검사 실행 시
- 위키 문서에서 Hermes 스킬 생성 시
엑셀 수집 (FileVine 활동 내보내기)
Aaron이 FileVine에서 활동 로그 엑셀 스프레드시트를 보낼 때:
예상 형식
- 시트 열:
프로젝트 이름 | 노트 텍스트 | 생성 일시 | (비어 있음) - 프로젝트 이름 = "클라이언트 이름 사건유형 MM/DD/YYYY" (예: "Amy Stich WC 01/17/2024")
- 노트 텍스트 = 마크다운 형식의 활동 노트 (FileVine 링크, 취소선 포함 가능)
- 생성 일시 = 날짜시간
변환 단계
- 필요시
pip install openpyxl openpyxl.load_workbook(path, read_only=True)로 로드- FirmVault 규칙에 따라 사건명 슬러그화 (소문자, 아포스트로피/따옴표 제거, & → and, 비알파벳숫자 → 하이픈)
- 사례별로 항목 그룹화 후 각 사례 내에서 날짜별 그룹화
- 다음 프론트매터와 함께
FirmVault/cases/<slug>/Activity Log/<YYYY-MM-DD>.md에 작성:schema_version: 2 date: "YYYY-MM-DD" category: imported subcategory: settlement_activity_export - 나중에 엑셀에서 가져온 사례를 식별하기 위해
subcategory: settlement_activity_export태그 사용
한 세션의 여러 파일
Aaron은 종종 여러 엑셀 파일을 순차적으로 보냅니다. 각 파일을 완전히 처리한 후(변환 → 배치 → 컴파일 → 인덱스 재구축) 다음 파일을 요청하세요. 변환기는 자동으로 중복 제거를 처리합니다. 사례 디렉토리가 이미 존재하면 새 로그가 추가되고, 해당 날짜의 로그 파일이 있으면 "Imported Entries" 섹션을 추가합니다.
크기 참조 (2026-04-12 가져오기)
- 파일 1 (settlement_1): 17,639 행 → 198 사례 → 6,221 로그 파일 (13.7 MB)
- 파일 2 (settlement_2): 22,182 행 → 169 사례 → 7,341 로그 파일 (12.9 MB)
- 파일 3 (settlement_3): 688 행 → 8 사례 → 158 로그 파일 (소형)
- 파일 4 (closing): 9,363 행 → 125 사례 → 2,924 로그 파일
- 변환은 파일당 약 2초 소요
- 중복 감지: 행 수 + 첫 번째/마지막 행을 비교하여 재전송 식별
배치 크기 결정
- >50 사례: 3개의 병렬 하위 에이전트 (로그 수 기준으로 균등 분할)
- 10-50 사례: 로그 볼륨에 따라 1-2개의 하위 에이전트
- <10 사례: 대상 문서 업데이트만 수행하는 단일 하위 에이전트. 기존 문서를 모두 읽도록 하지 말고 업데이트 가능성이 가장 높은 5-6개의 문서를 지정하세요. 읽기 중 턴 소진을 방지하기 위해 max_iterations=30으로 설정하세요.
재사용 가능 변환기 스크립트
/tmp/convert_excel.py에 저장하고 새 파일마다 경로를 바꾸세요. 스크립트는:
- openpyxl 사용 (누락 시 pip install)
- FirmVault 규칙에 따라 슬러그화
- 사례 → 날짜별 그룹화 → 프론트매터와 함께 마크다운 작성
- 새 사례 디렉토리와 업데이트된 사례 디렉토리 보고
아키텍처
Karpathy의 3계층 패턴: 원시 소스 → LLM 컴파일러 → 구조화된 위키
계층 1: 원시 (불변)
cases/*/Activity Log/*.md — 21K+ 활동 로그
cases/*/*.md — 사례 파일
계층 2: 위키 (LLM 유지 관리)
wiki/
Home.md — Obsidian 대시보드
index.md — 마스터 카탈로그
log.md — 컴파일 이력
concepts/*.md — 원자적 지식 문서 (2026-04-12 기준 63개)
connections/*.md — 교차 통찰 (2026-04-12 기준 26개)
AGENTS.md — 컴파일러 스키마 (명세서)
SPEC.md — 아키텍처 문서
계층 3: 소비자
Hermes 의미론적 스킬, OpenClaw 에이전트, Aaron (Hermes를 통해)
컴파일 프로세스
배치 처리 (대량 사례용)
- 사례를 약 80K 토큰의 배치로 그룹화
- 3개 배치를 병렬로 위임
- 각 하위 에이전트가 AGENTS.md, 기존 문서, 사례 파일 및 샘플링된 로그를 읽음
- 하위 에이전트가 기존 문서를 업데이트하거나(evidence_count++) 새 문서를 생성
- 하위 에이전트가 index.md를 다시 쓰지 못하게 함 (경쟁 조건) — 완료 후 재구축
- 모든 배치가 완료된 후 디스크의 모든 문서에서 index.md 재구축
컴파일러 하위 에이전트를 위한 주요 지침
- AGENTS.md에서 전체 스키마 읽기
- 쓰기 전에 모든 기존 개념 + 연결 문서 읽기
- 모든 개인 식별 정보(PII) 익명화 ("사례 A", "사례 B" 등 사용)
- 새로 생성하는 것보다 기존 업데이트 우선 (신뢰도 향상이 목표)
- 신뢰도: 낮음 (<5 사례), 중간 (5-9), 높음 (10+)
- 문서 간 [[wikilinks]] 사용
- log.md에 추가, index.md는 다시 쓰지 않음
샘플링 전략
- 대형 사례 (400+ 로그): 시간순 처음 40개 + 마지막 40개
- 중형 사례 (100-400): 처음 25개 + 마지막 25개
- 소형 사례 (<100): 처음 10개 + 마지막 10개 또는 전체
하위 에이전트 프롬프트 템플릿
법률 사무소 위키 컴파일러. /opt/data/FirmVault/wiki/AGENTS.md를 읽으세요.
wiki/concepts/ 및 wiki/connections/에 있는 기존 문서를 읽으세요.
컴파일할 사례: [LIST]. 각각에 대해: cases/<slug>/<slug>.md를 읽고
처음 N개 + 마지막 N개 활동 로그를 샘플링하세요. 기존 문서 업데이트
(evidence_count 증가, 신뢰도 업그레이드: 5=중간, 10=높음).
진정으로 새로운 패턴에 대해서만 새 문서를 생성하세요. PII 익명화.
wiki/에 작성하세요. index.md를 다시 쓰지 마세요. wiki/log.md에 추가하세요.
데이터 카테고리에 맞게 프롬프트 조정
다양한 엑셀 내보내기에는 다양한 유형의 데이터가 포함됩니다. 초점 힌트를 추가하세요:
- 정산 파일: "초점: 정산 패턴, 협상 전술, 치료 타임라인, SOL 관리, 조정관 행동, 유치권 해결"
- 종결 파일: "이것들은 종결 사례입니다 — 특히 다음을 찾으세요: 사례 종결 워크플로우, 거절 사유, 최종 지급, 파일 보관, 종결 후 의무, 클라이언트 종료 패턴"
- 접수 파일: 초점: 온보딩, 보험 확인, 초기 치료 의뢰 이것은 패턴 추출 품질을 극적으로 향상시킵니다.
인덱스 재구축
모든 컴파일 배치가 완료된 후 별도의 delegate_task로 항상 index.md를 재구축하세요. 소규모 배치에도 마찬가지입니다. 하위 에이전트는 concepts/ + connections/에 있는 모든 .md 파일에서 YAML 프론트매터를 파싱하고 AGENTS.md의 스키마에 따라 인덱스를 생성하기만 하면 됩니다. 약 60초 소요, max_iterations=15.
Obsidian 볼트
wiki/ 디렉토리는 Obsidian 볼트입니다:
- 그래프 색상이 있는 .obsidian/ 설정 (파랑=개념, 주황=연결)
- 랜딩 페이지로 Home.md
- [[wikilinks]]는 슬러그 이름 사용 (경로 접두사 없음)
- 그래프 보기는 문서 간 상호 연결 표시
Wikilink 규칙
[[slug-name]]을 사용하고[[concepts/slug-name]]은 사용하지 마세요- Obsidian은 파일 이름으로 해석하며, 경로는 링크를 끊습니다
컴파일할 사례 필터링
두 가지 접근 방식 — 엑셀 파일을 직접 사용(권장)하거나 볼트를 스캔하세요:
권장: 엑셀 파일 자체에서 슬러그 추출
# 엑셀 파싱 → 고유 프로젝트 이름 가져오기 → 슬러그화 → 배치
wb = openpyxl.load_workbook(path, read_only=True)
cases = Counter(str(r[0]).strip() for r in list(wb.active.iter_rows(values_only=True))[1:] if r[0])
slugs = [{"slug": slugify(name), "logs": count} for name, count in cases.items()]
이 방법은 정확합니다. 방금 가져온 것만 컴파일합니다.
대체: 하위 카테고리 태그로 볼트 스캔
for slug in os.listdir(cases_dir):
for logfile in os.listdir(log_dir):
if "settlement_activity_export" in open(logfile).read(200):
new_slugs.append(slug)
break
mtime 기반 필터링을 사용하지 마세요 — 변환 중 디렉토리가 수정된 오래된 사례를 포함하여 볼트의 모든 사례를 선택합니다.
함정
- 병렬 하위 에이전트는 evidence_count에서 경쟁 조건을 유발합니다 — ±3 변동 허용
- 하위 에이전트가 index.md를 다시 쓰지 못하게 하세요 — 모든 배치 후 직접 재구축하세요
- 대형 사례(1000+ 로그)는 반드시 축소해야 합니다 — 전략적으로 샘플링하세요
- 경로 접두사가 있는 Wikilink는 Obsidian에서 깨집니다 —
concepts/등을 제거하세요 - compile.py 스크립트는 프롬프트를 생성하지만 LLM을 직접 호출하지 않습니다 — delegate_task를 사용하세요
- 일부 문서는 아직 생성되지 않은 문서에 대한 미래지향적 링크를 포함합니다 — 더 많은 사례가 컴파일됨에 따라 생성되므로 괜찮습니다
- mtime 기반 볼트 스캐닝은 "방금 가져온" 사례 식별에 적합하지 않습니다 — 변환은 기존 디렉토리도 수정합니다. 항상 엑셀 파일 자체에서 사례 목록을 추출하세요.
- 종결 사례는 대부분 거절입니다, 사후 정산 종결이 아닙니다. 거절/종결 워크플로우가 정산 지급 워크플로우가 아닌 종결 데이터에서 가장 큰 증거 향상을 얻습니다.
- **소규모 배치(<10 사례)**에서 하위 에이전트가 89개 문서를 모두 읽으면 반복 횟수가 소진됩니다. 대신 특정 문서를 가리키세요.
다중 파일 워크플로우
사용자가 여러 엑셀 파일을 보내면 먼저 모두 변환한 후 컴파일하세요:
- /tmp/convert_excel.py 재사용 — 각 파일에 대해 파일 이름만 변경
- 모든 변환 후, 새 사례만 배치 (slugify + 존재 확인 사용)
- 3개의 병렬 배치로 컴파일한 후 마지막에 인덱스 한 번 재구축
중복 감지
사용자가 동일한 파일을 두 번 보낼 수 있습니다(같은 이름, 다른 문서 ID). 변환 전에 행 수 + 첫 번째/마지막 행을 비교하여 중복을 감지하세요.
가져오기에서 크기 참조
- 파일 1 (settlement_1): 17.6K 항목, 198 사례, 6.2K 로그 파일
- 파일 2 (settlement_2): 22.1K 항목, 169 사례, 7.3K 로그 파일
- 파일 3 (settlement_3): 688 항목, 8 사례 (소형 — 단일 배치)
- 파일 4 (closing): 9.3K 항목, 125 사례, 2.9K 로그 파일
- 파일 5-7 (archived 2,3,4): 64.3K 항목, 692 사례, 21K 로그 파일 총 수집: ~114K 항목, 1,170 사례, ~56K 로그 파일 → 93 위키 문서
선호 배치
- <20 사례: 단일 하위 에이전트, 배치 없음
- 20-300 사례: 3개의 병렬 하위 에이전트
-
300 사례: 공격적인 샘플링(처음 10개 + 마지막 10개)을 사용하는 3개의 병렬 하위 에이전트
- 항상 모든 배치가 완료된 후 index.md 재구축 (절대 하위 에이전트가 건드리지 못하게 함)
함정: mtime 기반 필터링은 신뢰할 수 없음
"새" 사례를 찾기 위해 파일 mtime을 사용하지 마세요 — convert_excel.py는 기존 파일도 수정합니다. 대신, 엑셀에서 사례 이름을 직접 추출하고 슬러그화하여 대상 목록을 얻으세요.
파일
- FirmVault: /opt/data/FirmVault
- 위키: /opt/data/FirmVault/wiki/
- 스키마: wiki/AGENTS.md
- 변환기: /tmp/convert_excel.py (실행 사이에 파일 이름 변경)
- 문서 개수: 65 개념 + 28 연결 = 총 93 (2026-04-12 기준)
- 결정: /opt/data/FirmVault/decisions/ (ADR-000 ~ ADR-006)
- 감사 보고서: /opt/data/FirmVault/wiki/reports/workflow-vs-wiki-audit.md
- v2 제안: /opt/data/FirmVault/wiki/reports/PHASE_DAG_v2_proposal.md
워크플로우 감사
주요 컴파일 라운드 후, PHASE_DAG에 대해 위키를 감사하세요:
- PHASE_DAG.yaml 읽기 (규정된 워크플로우)
- 모든 위키 문서 읽기 (관찰된 현실)
- 비교: 모순, 격차, 중복
- wiki/reports/에 감사 보고서 작성
- 변경이 필요하면 PHASE_DAG v2 제안 초안 작성
- decisions/에 ADR로 결정 문서화 (stirps-ai/stirps-gov에서 선별)
이 감사는 93개의 위키 문서를 실행 가능한 아키텍처 결정으로 전환한 것입니다. 위키는 증거이고, ADR은 약속입니다.