---
title: 배포용 맥락공유 볼트 PoC 검증 보고
status: poc_validated_production_blocked
created: 2026-07-15
updated: 2026-07-15
---

# 배포용 맥락공유 볼트 PoC 검증 보고

## 한 줄 결론

**비개발자가 Git을 직접 다루지 않는 배포용 볼트의 핵심 동기화·리서치·보고서 흐름은 외부 격리 저장소에서 검증했지만, 실제 전사 자동 배포는 crash-safe 저장·hostile remote 격리·실제 macOS/인증 테스트를 통과하기 전까지 차단한다.**

## 어디에 만들었나

현재 SRL 볼트의 Git hooks나 동기화 코드는 수정하지 않았다. 별도 개발 저장소 `srl-context-vault-sync-poc`에서 구현·테스트했다. 기기별 절대 경로는 이 공유 문서에 기록하지 않는다.

주요 외부 산출물:

- `artifacts/demo_vault-skill-pack.zip` — Claude Code용 배포 패키지
- `artifacts/demo_vault-skill-pack.zip.sha256.json` — ZIP 무결성·순서·메타데이터
- `demo_vault/.claude/skills/` — 6개 리서치 Skill
- `demo_vault/research_cases/*/publish.html` — 4개 최종 HTML 보고서
- `artifacts/research-e2e-report.json` — 4개 사례 실행 결과
- `artifacts/research-e2e-problem-log.json` — 재현 가능한 문제 사례
- `artifacts/research-html-browser-qa.json` — 모바일/데스크톱 브라우저 검증
- `docs/g002-final-report-ko.md` — 상세 한국어 결과 보고
- `docs/open-source-dropbox-git-pattern-review-ko.md` — 오픈소스 방식 비교·채택 결정

## Claude Code 사용 흐름

팀원은 Git 명령을 배우지 않고 다음처럼 자연어로 요청한다.

> 이 전사로 대표 방향부터 팀장 지시, 팀원 해석, 페르소나별 리서치, 최종 보고서와 HTML까지 만들어줘.

또는 `/context-research-workflow`을 명시적으로 실행한다.

처리 단계:

1. 전사 TXT/Markdown/JSON 수집·정규화
2. 대표 방향·금지·조건 추출
3. 팀장 작업지시 분리
4. 팀원별 해석·이견·질문·접근·필요 증거 기록
5. 4개 관점의 페르소나 리서치
6. 출처·발화 ID·SHA-256 연결 검증
7. 이견·선택지·트레이드오프·미확정 항목 종합
8. 최종 Markdown/HTML 보고서 생성
9. 대표 → 팀장 → 팀원 → 페르소나 → 권고 추적 표시

근거 없는 주장은 자동으로 결론처럼 쓰지 않고 `미확정`으로 남긴다.

## 검증한 4개 사용 사례

| 사례 | 검증 포인트 |
|---|---|
| 시장 출시 | 정보가 부족한 상태에서 대표 방향과 팀원 질문을 분리하고 권고를 미확정으로 유지 |
| 팬 경험 | 실시간/비동기 방식의 이견과 접근성·모더레이션 trade-off 보존 |
| 공급사 운영 | 기존 합성 보고서의 path·excerpt·hash를 persona와 synthesis까지 연결 |
| 데이터 리스크 | private 발언 원문 제외, 값 없는 문제 기록, 법무 승인 전 no-go 유지 |

## Git 자동 동기화 검증

Dropbox처럼 느끼게 하는 정상 경로는 질문 없이 처리한다.

- local-only / remote-only / 서로 다른 파일의 병행 수정
- 자동 commit / fetch / merge / push
- remote-only 최종 ref·content convergence 측정
- transient network만 제한 재시도
- auth/policy/secret/private/path 문제는 typed blocked 처리
- 동일 파일, binary, modify/delete 충돌은 local/remote 양쪽 refs·copies·tombstone·manifest 보존
- 보존 뒤 깨진 merge 상태를 정리하며 어느 한쪽도 자동 폐기하지 않음
- Korean/Unicode, Windows reserved path, stale/concurrent lock, interruption, retry, evidence cap 시나리오

## 최종 테스트 결과

- 전체 자동 테스트: **49/49 통과**
- 리서치 E2E: **4/4 사례 통과**
- HTML browser QA: **4개 사례 × 390px/1440px = 8개 조합 통과**
- 확인 항목: 제목·section·고유 ID·내부 링크·대표/팀장/팀원/페르소나 trace·최종 결정 영역·private pattern 부재·가로 overflow 부재·print CSS·console error 없음
- deterministic ZIP: 반복 생성 byte equality·entry order·timestamp·mode·SHA-256 검증
- 독립 architect review와 executor red-team review를 반복하여 발견된 provenance·privacy·package·browser evidence 문제를 수정

이 결과는 **결정론적 파일 workflow와 안전 경계 검증**이다. 실제 Claude의 외부 리서치 품질, 법률 판단, 완전한 개인정보 탐지, 전체 WCAG 품질을 증명하지 않는다.

## 오픈소스 검토 결과

검토 대상:

- SparkleShare
- Syncthing
- git-annex assistant
- Obsidian Git
- GitJournal
- Unison

결론은 하나를 그대로 도입하는 것이 아니라 다음 hybrid를 채택하는 것이다.

- SparkleShare: Git을 숨기는 Dropbox형 UX
- Syncthing/git-annex: 충돌 양쪽을 conflict copy/variant로 보존
- 현재 PoC: secret/private/path/remote 검증, noninteractive reason code, durable evidence, merge abort

핵심 원칙은 **“Git은 숨기되 충돌과 실패의 진실은 숨기지 않는다”**이다.

## 실제 배포 전 차단 게이트

1. **Crash-safe finalization:** fsync·atomic completion·reread hash·부분 I/O 차단
2. **Hostile remote quarantine:** main repo가 받기 전 별도 object quarantine·bounded closure promotion
3. **Managed auth:** 실제 HTTPS/SSH credential, revoke/expiry, protected branch 실기
4. **Windows/macOS whole-tree:** case-fold 및 Unicode NFC/NFD collision, path length, symlink/submodule 정책을 실제 NTFS/APFS에서 검증
5. **Layered secret policy:** provider/사내 패턴·JSON/YAML·outgoing history·quarantine evidence 접근제어
6. **Watcher/installer/UI:** OS 자동 시작, file stabilization, 정확한 blocked 상태 구분, signed update
7. **Recovery quota/retention:** 자동 삭제 없이 관리자 승인형 보관 정책

## 내일 팀 시연 권장 순서

1. 시장 출시 전사를 열고 자연어 한 문장으로 전체 workflow 실행
2. 대표 방향·팀장 지시·팀원 해석이 분리되는 파일 확인
3. 팬 경험 사례에서 이견이 사라지지 않는지 비교
4. 공급사 운영 사례에서 source excerpt/hash가 최종 보고까지 이어지는지 확인
5. 데이터 리스크 사례에서 private 원문이 빠지고 no-go가 남는지 확인
6. 4개 `publish.html` 중 하나를 모바일 폭과 데스크톱으로 시연
7. 같은 파일 충돌 사례에서 어느 쪽도 삭제하지 않고 복구 evidence가 남는 것 시연
8. “팀원은 Git을 쓰지 않고, 정상은 자동 처리하며, 위험은 보존 후 관리자 상태로 전환한다”는 운영 경계 설명

## 현재 판단

- 팀 시연용·격리 pilot 자료: **사용 가능**
- 현재 SRL 볼트 hooks에 바로 적용: **금지**
- 전사 production 자동 동기화: **P0 게이트 통과 전 금지**
- 다음 개발 기준: 외부 PoC 저장소의 issue/incident log와 오픈소스 패턴 검토 문서를 기준으로 진행