vault-mount

name	vault-mount
description	옵시디언 볼트 자동 마운트 게이트키퍼. PATH_TRIGGER(`/Users/jason/`·`~/` 절대경로 hit) + 단어 트리거(마운트·볼트·이어서). 발동 시 mcp__cowork__request_cowork_directory 결정적 호출. P1: 마운트, 볼트, 이어서, vault mount, cowork mount. P2: 마운트해줘, 볼트 열어줘, 이어서 작업, resume work. NOT: UP수정(→up-manager), 스킬생성(→skill-builder), 세션브리핑(→session-briefing), 일반리서치(→research-skill).
version	v1.3
vault_dependency	required
license	Proprietary. LICENSE has complete terms.

vault-mount

옵시디언 볼트 마운트를 결정적으로 보장하는 인프라 게이트키퍼. UP §BOOTSTRAP과 함께 이중 안전장치.

WHY: 글로벌 CLAUDE.md의 MOUNT 선언(MOUNT ::= request_cowork_directory 자동 마운트)은 plugin-cache 경로에 있어 매 세션 재주입이 보장되지 않음. UP §BOOTSTRAP이 1차, 이 스킬이 2차 강제.

---

절대 규칙 (INVARIANT) — 5개

#	규칙	위반 시
0	PATH_TRIGGER (100% 강제발동) — 형 메시지에 /Users/jason/·/Users/jason/Library/CloudStorage/Dropbox/ObsidianVault·/Users/jason/ObsidianVault·~/ 등 host 절대경로 패턴이 hit 시 단어 트리거와 무관하게 즉시 본 스킬 발동. grep 우회·NOT 우회 ✗·예외 ✗. 발동 후 ② 검증 → ③ 호출 (이미 마운트면 스킵)	형이 경로를 박는 행위 = 100% 파일작업 신호. 미발동 = 본질 누락
1	볼트 경로 고정 — /Users/jason/Library/CloudStorage/Dropbox/ObsidianVault (하드코딩 ✗ 원칙의 유일 예외, 형 전용)	다른 경로로 마운트 = FAIL
2	마운트 실패 = 보고+진행 — STOP ✗. outputs/ 폴백으로 작업 계속, 1줄 경고만	작업 흐름 차단 = 형 생산성 손실
3	이미 마운트됨 = 스킵 — ls VAULT/Agent-Ops 1회 검증. 성공 = 재마운트 ✗	중복 마운트 = 형에게 권한 팝업 재노출
4	3단계 폴백 순서 강제 — ①코워크 빌트인 → ②옵시디언 MCP → ③Desktop Commander. 앞 단계 실패시만 다음	임의 폴백 = 디버깅 혼선

---

흐름 (선형 1턴)

① 트리거 감지 → ② 마운트 상태 검증 → ③ 마운트 호출 (필요시) → ④ 1줄 보고

① 트리거 감지

자동 발동 조건 (하나라도 hit):

• 🆕 PATH_TRIGGER (Rule 0·최우선·100% 강제): 메시지에 다음 경로 패턴 hit 시 즉시 발동
  • /Users/jason/ (jason 호스트 루트)
  • /Users/jason/Library/CloudStorage/Dropbox/ObsidianVault (정식 경로)
  • /Users/jason/Library/CloudStorage/Dropbox/ObsidianVault/ (정식 경로 + 슬래시)
  • /Users/jason/ObsidianVault (별칭 경로)
  • /Users/jason/ObsidianVault/ (별칭 경로 + 슬래시)
  • ~/ (jason 컨텍스트의 홈 별칭)
  • 검출 정규식 (참고): (/Users/jason/|~/)
• 세션 첫 사용자 메시지 (UP §BOOTSTRAP과 중복 방어)
• P1 트리거 단어 hit (볼트·마운트·시작·resume·이어서·경로)
• 파일 작업 직전 + 마운트 미확인 상태
• 글로벌 CLAUDE.md FS_ACCESS 룰 적용 필요시
• 볼트 경로 조회·확인 요청 ("경로 알려줘"·"볼트 어디야")

② 마운트 상태 검증 (Bash 1회)

ls /Users/jason/Library/CloudStorage/Dropbox/ObsidianVault/Agent-Ops/ 2>&1 | head -3

결과	판정	다음
디렉토리 정상 출력	already_mounted	④ 보고 1줄 ("✅ 볼트 이미 마운트됨")
No such file 또는 권한 거부	미마운트	③ 마운트 호출

또는 scripts/self_check.py 실행으로 자동화:

python3 scripts/self_check.py
# 출력: {"status": "mounted" | "not_mounted", ...}

③ 마운트 호출

mcp__cowork__request_cowork_directory(path="/Users/jason/Library/CloudStorage/Dropbox/ObsidianVault")

결과 분기:

• ✅ 성공 → ④ 보고 ("✅ 볼트 마운트 완료")
• ❌ 사용자 거부·실패 → ④ 보고 ("⚠️ 볼트 마운트 실패 — outputs 폴백 진행") + 작업 계속

④ 보고 (1줄)

케이스	보고 문구
이미 마운트됨	✅ 볼트 이미 마운트됨
신규 마운트 성공	✅ 볼트 마운트 완료
마운트 실패	⚠️ 볼트 마운트 실패 — outputs 폴백 진행

스킵 조건: 일반 대화·실행 보고 (FS 작업 무관시 보고 생략).

---

FS 폴백 + 파일 안전 룰

상세 프로토콜: → references/fallback-protocol.md 참조

핵심 요약 1줄: 코워크 빌트인 → 옵시디언 MCP → Desktop Commander 순서. 3단계 모두 실패 = STOP. Write 덮어쓰기 ✗ → Edit. 삭제 → _archive/.

---

자기 진단 (self-check)

# 마운트 상태 검증
python3 scripts/self_check.py

# 스킬 무결성 검증 (절대규칙 4개 + frontmatter)
python3 scripts/self_check.py --skill ./

회귀 케이스: evals/cases.json (5 시나리오)

---

Gotchas

함정	대응
매 턴 마운트 호출	② 검증 단계로 already_mounted 판정 후 스킵. 형에게 권한 팝업 반복 노출 ✗
마운트 실패 시 STOP	절대규칙 2 위반. 보고만 하고 작업 진행. outputs 폴백으로 산출
볼트 경로 다른 폴더	절대규칙 1 위반. 정확히 /Users/jason/Library/CloudStorage/Dropbox/ObsidianVault
UP §BOOTSTRAP과 중복 호출	의도된 이중 안전장치. ② 검증으로 실제 호출은 1회만 발생
옵시디언 MCP 우선 시도	폴백 순서 위반. 코워크 빌트인 먼저 (→ references/fallback-protocol.md)
볼트 검증을 mcp__obsidian__로	코워크 빌트인 ls가 가장 빠름. MCP는 빌트인 실패시만
글로벌 CLAUDE.md만 믿기	plugin-cache 경로 = 매 턴 주입 보장 ✗. 이 스킬 + UP이 진짜 강제 메커니즘
host 경로와 VM 경로 혼동	host=/Users/jason/..., VM=/sessions/{id}/mnt/.... Read/Write/Edit는 host, Bash는 VM

❌ WRONG vs ✅ CORRECT

❌ WRONG: 매 턴 request_cowork_directory 호출 (검증 단계 스킵 → 권한 팝업 반복)
✅ CORRECT: ls VAULT/Agent-Ops/ 검증 → 정상이면 already_mounted → 호출 스킵

❌ WRONG: 마운트 실패 → STOP + 사용자 보고 후 작업 중단
✅ CORRECT: 마운트 실패 → 1줄 경고 + outputs 폴백으로 작업 계속 (절대규칙 2)

❌ WRONG: 형이 "/Users/jason/Library/CloudStorage/Dropbox/ObsidianVault/" 박았는데 단어 트리거 미hit → 발동 ✗
✅ CORRECT: 경로 패턴 hit = Rule 0 PATH_TRIGGER 100% 강제발동 (단어 매칭 우회·즉시 ② 검증)

---

예시

케이스 1: 세션 첫 메시지 "이어서 하자"

hit: "이어서" (P1)
→ ② Bash: ls VAULT/Agent-Ops/ → 정상
→ ④ 보고: ✅ 볼트 이미 마운트됨

케이스 2: 파일 작업 직전 미마운트

사용자: "UP 좀 수정해줘"
→ ② Bash: ls VAULT/Agent-Ops/ → No such file
→ ③ request_cowork_directory(path="...ObsidianVault") → 성공
→ ④ 보고: ✅ 볼트 마운트 완료
→ up-manager 발동

케이스 3: 마운트 실패

hit: "볼트"
→ ② 미마운트 → ③ 호출 → 사용자 거부
→ ④ 보고: ⚠️ 볼트 마운트 실패 — outputs 폴백 진행
→ 작업 계속 (STOP ✗)

케이스 4: 경로 트리거 (v1.0 신규)

사용자: "볼트 경로 확인해줘"
hit: "경로" (P1)
→ ② 마운트 검증 → 정상
→ ④ 보고: ✅ 볼트 이미 마운트됨 — /Users/jason/Library/CloudStorage/Dropbox/ObsidianVault

케이스 5: PATH_TRIGGER 절대경로 hit (v1.2 신규·Rule 0)

사용자: "이거 처리해줘 → /Users/jason/Library/CloudStorage/Dropbox/ObsidianVault/Agent-Ops/메모.md"
hit: PATH_TRIGGER `/Users/jason/Library/CloudStorage/Dropbox/ObsidianVault/` (Rule 0·100%)
→ 단어 매칭 우회 → 즉시 ② 검증
→ 미마운트 → ③ request_cowork_directory 호출 → 성공
→ ④ 보고: ✅ 볼트 마운트 완료

케이스 6: PATH_TRIGGER ~/ 별칭 hit

사용자: "~/ObsidianVault 안에 있는 거 정리"
hit: PATH_TRIGGER `~/` (Rule 0)
→ 즉시 ② 검증
→ 정상 → ④ 보고: ✅ 볼트 이미 마운트됨

---

변경 이력

→ CHANGELOG.md 참조