vault

name	vault
description	Save the current conversation result, analysis, or artifact to the personal vault as a self-contained HTML file. Trigger when user says "vault에 저장", "이거 남겨줘", "아카이브해줘", "save to vault", "vault에 남겨줘", or similar. Also proactively suggest saving when a significant deliverable has just been completed (HTML app, structured analysis, research result, working tool).

Vault Skill

Save conversation outputs to the vault directory ($VAULT_PATH) as self-contained HTML files.

VAULT_PATH

The vault directory is given by the $VAULT_PATH environment variable, set per-machine in machine-local config (e.g. the env block of ~/.claude/settings.json) — never hardcode a personal path in this repo. Before anything else, resolve it once (printf '%s' "$VAULT_PATH") and use that absolute path for every file operation below. If it is unset or empty, stop and ask the user to set VAULT_PATH — do not guess a path.

When to proactively suggest

Offer "이거 vault에 저장할까요?" when:

• A complete, interactive HTML app was just built
• A structured analysis or research result reached a natural conclusion
• A significant artifact was produced that has standalone value

Wait for user confirmation before saving.

File naming

Format: YYYY-MM-DD-<slug>.html

• Date: today's date (use current date from context)
• Slug: 2–5 word kebab-case summary, Korean or English
• Examples: 2026-05-22-claude-api-caching.html, 2026-05-22-tmux-단축키-정리.html

Layout patterns — memory에 산다

누적 레이아웃 패턴은 이 레포가 아니라 memory 파일 reference_vault_patterns.md 에 있다(비공개 개인 repo의 memory/ — 공개 레포 검열 부담 없음). 2026-06-18 이후 2층 구조다: §A Primitives(재사용 장치 P#) + §B Playbooks(콘텐츠타입별 조합). blind grep으로 긁지 말 것 — 예전 키워드 grep은 파일 40%를 덤프했다. 위치는 glob으로 찾는다:

ls ~/*/memory/reference_vault_patterns.md

파일이 없으면 패턴 없이 진행한다(차단 아님).

HTML creation (per-entry)

Each individual entry HTML must be fully self-contained — no external CDN, no imports.

• Before building, open the patterns memory (위 섹션) and read §0 — Index first: find the playbook (B1–B13) matching the content type, then expand the P# primitives that playbook references in §A. Reuse that composition. (Index lookup, not keyword grep.)
• Let content type drive structure: analysis → article layout, mini-app → interactive UI, summary → clean card
• Style freely with inline CSS. Choose typography, colors, layout that best fit the content.
• Must include a descriptive <title> tag (shown in browser tab)
• Must be readable and useful when opened standalone in a browser

Steps to execute

1. Determine slug from conversation context
2. Write HTML to $VAULT_PATH/YYYY-MM-DD-<slug>.html
3. Commit — stage only the single file you produced (never git add . / git add -A; the directory may contain unrelated in-flight HTML from other sessions):

   cd "$VAULT_PATH" && \
     git add YYYY-MM-DD-<slug>.html && \
     git commit -m "vault: <slug>"
   

4. 검증 게이트 3개를 통과 (see "검증 게이트" below) — 통과 전엔 작업을 "완료"로 보지 않는다

Listing — Caddy autoindex (no index to maintain)

손으로 유지하던 index.html은 폐기됐다. vault 디렉토리는 일반 웹 서버(Caddy file_server browse)의 자동 디렉토리 리스팅으로 노출된다 (apps/vault-server/Caddyfile). 파일을 추가/삭제하면 즉시 반영되고 stale이 불가능하다 — 갱신할 인덱스 파일이 없다.

리스팅이 보여주는 유일한 신호는 파일명(YYYY-MM-DD-<slug>.html)이다. 따라서 slug를 내용이 한눈에 잡히도록 서술적으로 짓는다 (날짜 프리픽스가 자동 역순 정렬을 만든다). type/tag 같은 별도 메타데이터는 더 이상 어디에도 쓰이지 않으므로 결정하지 않는다.

검증 게이트 (저장·커밋 후 필수)

작업을 "완료"로 간주하기 전에 아래 3개 게이트를 순서대로 통과시킨다. 통과 못 하면 고치고 다시 본다.

Gate 1 — 보안 (공개 누수 차단)

• 스테이징 범위: vault 커밋에 의도한 1개 파일(YYYY-MM-DD-<slug>.html)만 들어갔는지 git -C "$VAULT_PATH" show --stat HEAD로 확인 — 다른 세션의 in-flight HTML 혼입 방지.
• entry 본문·패턴 memory의 개인 콘텐츠는 OK(둘 다 비공개) — 누수 경계는 이 SKILL.md(공개 dotfiles)뿐이다. SKILL을 고칠 때 예시·기본값에 개인 구체값(종목·지역·금액·제품명·프로젝트 주제)을 박지 않는다.

Gate 2 — 연결성 & 회고

• 이 entry가 기존 vault 문서와 이어지나? 같은 주제·시리즈·후속이면 footer cross-link, 또는 -plan/-shortlist 같은 페어링을 건다. 거의-중복이면 새 파일 말고 원본에 addendum(앞 룰).
• 여러 문서를 가로지르는 메타 인사이트가 보이면, 그것 자체를 새 entry나 패턴 memory 교훈(레이아웃 한정)으로 남길지 판단한다.

Gate 3 — 내용 검토 & 스킬 개선

• 저장한 HTML을 다시 보고: 구조가 즉시 명확한가? 시각 스타일이 콘텐츠 타입에 맞나? 독자가 헷갈리거나 빠진 부분은? 다음엔 무엇을 다르게?
• 재사용 가능한 일반화 인사이트가 나오면 패턴 memory(reference_vault_patterns.md)에 append하되 구조를 지킨다: 새 장치면 §A에 P#로, 새 콘텐츠타입 조합이면 §B에 playbook으로(+§0 index 한 줄), 기존 것의 변종이면 해당 항목에 1줄. 절대 새 N=1 recipe를 바닥에 쌓지 말 것 — 그게 51K 비대화의 원인이었다(2026-06-18 zero-base 재설계). 레이아웃 규칙만(개인 구체값 금지). SKILL.md에 inline 금지(progressive disclosure). 사소한 관찰은 skip.
• 이번 작업이 스킬 자체의 개선 기회를 드러냈나? (반복되는 수작업, 빠진 content-type 패턴, 더 나은 검증 절차 등) → 절차 개선은 SKILL.md에, 레이아웃 개선은 패턴 memory에 반영을 제안한다.