| name | session-skill |
| description | 세션 컨텍스트 연속성 엔진. SAVE·LOAD 2모드. 작업완료·예약어 자동저장, 도메인키워드·이어서 hit 시 자동 로드. v39 흡수. 단서없음=글로벌폴백. 23개 도메인 풀매핑 references/domain-keyword-map.md. P1: 세션스킬, session skill, 세션브리핑, 세션저장, 세션로드, 압축각, 저장각, 컨텍스트꽉, 선제저장, 이어서, 계속, 재개, 사공이호, MAD POP, MADVERSE, KISAS, KIMLEECHOI, C8, Cre8orClub, 중국런칭, 합자, BEK, BMA, K-Channel, K-Pop 캠프, K-note, 자벌레, 인천 상상플랫폼, Oxford AI, 타운홀, Ratel, Acuvue, Jarvis, 정책기획, 선거예측, 남양주, 서울교육감, 우정회장, 펑위궈, 胡世辉, PDK. P2: 저장, 브리핑, 이어서, 계속, save, resume. P3: session brief, auto-load. P5: .md로. NOT: UP(→up-manager), GRAPH(→project-updater). |
| vault_dependency | SOFT |
Session Skill — 통합 세션 컨텍스트 엔진
세션 간 컨텍스트 연속성 1턴 완결. 저장(SAVE)·로드(LOAD) 2모드 통합 단일 스킬.
v39 session-briefing 헤리티지(VAULT 캐시·PROJECT_ROOT 캐시·no-op 가드·2회 병렬 저장·예약어 즉시저장) 전부 흡수.
신규 — LOAD 모드(도메인·이어서 키워드 자동 발동), 강함 트리거, 듀얼 모드 게이트, project-updater 보조 연계.
Skill Boundaries
- 하는 것 — 세션 결정·미결·다음 자동 저장(SAVE) · 직전 브리핑 자동 로드(LOAD) · 프로젝트 캐시 관리 ·
_latest.md 갱신 · LOAD 시 GRAPH.md 보조 read
- 안 하는 것 — UP 편집(→ up-manager) · 프로젝트 GRAPH 생성·수정(→ project-updater) · 산출물 자체 저장(형 직접 또는 도메인 스킬) · 일반 문서 작성
When to Use
| 모드 | 발동 시점 |
|---|
| SAVE | 작업 완료 직후·산출물 생성 직후·결정 확정 시·압축각/저장각 예약어 hit·20턴+산출물 2건 누적 |
| LOAD | 새 세션 진입 직후·"이어서·계속·재개" hit·도메인 키워드 hit(사공이호·MAD POP·KISAS·KIMLEECHOI·C8·중국런칭·합자 등) |
안 쓸 때 — 단답·일상대화·1회성 질문. SAVE는 no-op 가드로 변화 없으면 스킵. LOAD는 도메인·트리거 부재 시 작동 ✗.
Prerequisites
| # | 체크 | 미충족 시 |
|---|
| 1 | VAULT mount 존재 (글로벌 CLAUDE.md MOUNT::=VAULT 세션 1회 resolve·캐시 키 VAULT_RESOLVED) | 마운트 없음 = 1줄 경고 후 outputs 폴백. STOP ✗ |
| 2 | PROJECT_ROOT 세션 캐시 확인 (PROJECT_ROOT_RESOLVED) | 미확정 + 단서 없음 → 글로벌 {VAULT}/_session_briefing/ 직행. 질문 ✗ |
| 3 | LOAD 모드 진입 시 직전 _latest.md 존재 확인 | 없음 = "직전 브리핑 ✗·새 작업 시작" 1줄 |
| 4 | 도메인 키워드 trigger hit 시 해당 도메인 폴더 우선 | china/kisas 등 도메인 폴더 부재 시 글로벌 폴백 |
| 5 | LOAD 시 {PROJECT_ROOT}/GRAPH.md 존재 시 같이 1회 read | 부재 시 스킵·경고 ✗ |
⛔ 절대 규칙 (8)
| # | 규칙 | 이유 |
|---|
| 1 | 절대경로 하드코딩 ✗ — VAULT·PROJECT_ROOT·홈경로 어떤 형태든 본문 절대경로 금지. {VAULT} 변수만 | 머신·사용자 변경 즉사 방지 |
| 2 | VAULT resolve = 세션 1회 — VAULT_RESOLVED 캐시 재사용 | CLAUDE.md 반복 read 차단 |
| 3 | {VAULT} 하위만 저장 — 세션 마운트·외부 저장 ✗ | 세션 종료 시 소실 방지 |
| 4 | _latest.md 덮어쓰기·append ✗ — 과거는 날짜별 사본 담당 | 정합성 보장 |
| 5 | PROJECT_ROOT 미확정 시 질문 ✗ — 단서 없음 = 글로벌 폴백 직행 | 턴 절감 |
| 6 | LOAD = 1회 read·검증 ✗ — _latest.md 단일 read로 끝(+GRAPH 보조 1회) | I/O 단일화 |
| 7 | SAVE 2회 병렬 — 날짜별 사본 + _latest.md 동시 write | 누적 ✗·역추적 앵커 보존 |
| 8 | no-op 가드 — 20턴+산출물 2건 도달 시 변화 없으면 SAVE 스킵·인-컨텍스트 1문단 자가요약 | 무의미 저장 차단 |
자체 점검 (self-check)
스킬 수정 후: SKILL.md ≤8KB · P1 ≥10개 · 절대규칙 ≥7개 · Gotchas ≥5행 · 본문 내 절대경로 0개 · LOAD/SAVE 양 모드 명시 확인.
모드 1 — SAVE (저장)
발동 조건
| 조건 | 모드 | 행동 |
|---|
| "압축각·저장각·컨텍스트꽉·선제저장" (예약어·최우선) | 터보 즉시 | 조건 불문 즉시 저장. no-op 가드 ✗ |
| 작업 완료 | 터보 | 자동. 3줄 요약 + 2회 저장(본파일·_latest 덮어쓰기) |
| 산출물 생성·결정 확정 (백그라운드) | 사일런트 패치 | _latest.md만 조용히 덮어쓰기. 보고 1줄 "↻ _latest 갱신" |
| 20턴+산출물 ≥2개 + 변화 ≥1 | 터보 + no-op 가드 | 결정·미결·다음 변화 시만 저장 |
| "풀 브리핑·상세" | 풀 | 3블록 + 포인터 + 2회 저장 |
| "생략" | — | 1회 스킵 |
임계치·예약어
| 항목 | 값 |
|---|
| 턴 임계치 | 20턴 (형 UP 기본토큰 무거움 반영) |
| 산출물 임계치 | ≥2건 (파일생성·커밋·산출물 저장 누적) |
| 예약어 | 압축각 저장각 컨텍스트꽉 선제저장 — 단어 hit 시 조건 불문 즉시 저장 |
| 사일런트 패치 대상 | _latest.md 덮어쓰기만. 날짜사본·보고 전문 skip |
콘텐츠 — 터보 (디폴트·3줄)
- 결정: [확정된 핵심 1~2개 / 한 줄]
- 미결: [보류 + 사유 / 한 줄. 없으면 "없음"]
- 다음: [다음 세션 첫 행동 + → 파일경로 / 한 줄]
포인터(→ path)는 다음액션에만 필수.
콘텐츠 — 풀 (명시 요청·3블록 + 포인터)
- 결정사항 +
→ 관련 파일
- 미결 + 사유 + 외부 대기 +
→ 관련 파일
- 다음액션 +
→ 관련 파일
저장 — 2회 병렬
날짜별 사본 + _latest.md 동시 write(병렬 tool call). 누적 ✗.
모드 2 — LOAD (자동 로드 — 신규)
발동 조건 (강함 트리거)
| 조건 | 행동 |
|---|
| 새 세션 진입 + 도메인 키워드 hit | 해당 도메인 _latest.md 자동 read + GRAPH.md(있으면) + 1줄 컨텍스트 인사 |
| "이어서·계속·재개·다시 시작·이전 작업" (한국어 컨티뉴) | 가장 최근 _latest.md 자동 read |
| 명시 호출 ("로드해줘·브리핑 보여줘") | 풀 로드 + 3블록 컨텍스트 박스 |
| 키워드·컨티뉴 부재 + 단답 | 작동 ✗ (노이즈 차단) |
도메인 키워드 매핑 (요약 — 풀버전 references/domain-keyword-map.md)
볼트 전수 스캔(2026-05-24) 기반 30+ 프로젝트·핵심 인물·고유명사 매핑.
| # | 도메인 | 핵심 키워드 | 폴더 |
|---|
| D1 | 중국 런칭/Mad Pop/사공이호 | 사공이호·MAD POP·MADVERSE·MBMG·합자·MOU·우정·胡世辉·펑위궈·양란·阳光七星·太美 | 01 사공이호/, 01 Mad Pop @중국/ |
| D2 | C8/Cre8orClub | C8·Cre8orClub·BP·KB BOT·런칭 마케팅·앱·청사진·로드맵 | 00 C8 * 시리즈 |
| D3 | KISAS 전체 | KISAS·Cre8orClub-KISAS·IP·캠프·유학원·플랫폼·두나무·케이팝커버댄스·홀딩스·SBT | 01 KISAS * 시리즈 |
| D4 | KIMLEECHOI C-level | KIMLEECHOI·김이최·변형 75개·7축·김형석 | 01 사공이호/_C level_meeting/ |
| D5 | K-Channel/BEK/BMA | K-Channel·BEK·BMA·주식양수도 | 01 BEK_BMA/, 01 K Channel 82/ |
| D6 | K-Pop 캠프/컨버전스파크/K-note | K-Pop·K-Pop_Camp_by_PDK·컨버전스파크·화성·노느니 라텔·K-note | 01 K-Pop *, 01 K-note @중국/ |
| D7 | 자벌레/인천 상상플랫폼 | 자벌레·리와일딩·ARTFIRM·인천·상상플랫폼·270m·관객IP | 01 자벌레*, 01 인천 상상플랫폼/ |
| D8 | Oxford AI | Oxford·옥스퍼드·AI 컨퍼런스 | 01 Oxford AI 컨퍼런스/ |
| D9 | Ratel 타운홀 | Ratel·라텔·타운홀·townhall·CEO 타운홀·keynote 2026 | 00 Ratel 타운홀/ |
| D10 | Acuvue/JNJ | acuvue·아큐브·JNJ·weekly monitoring·dailyscrum | _acuvue management/ |
| D11 | Jarvis 0.1 | Jarvis·자비스 0.1·5레이어 에이전트·시스템 아키텍처 | 00 Jarvis 0.1/ |
| D12 | Management | 구조조정·기획팀 운영·리더쉽 | 00 Management/ |
| D13 | 스파인/시간분할 무한연결망 | 스파인·시간분할·무한연결망 | 00 스파인 통합/, 00 시간분할 무한연결망 모델/ |
| D14 | PD.K 통화/고삼석 | PD.K·피디님·고삼석·통화정리 | 01 PD.K_common/ |
| D15 | 정책기획(지자체) | 정책기획·강남구·경기도·경상남도·부산·서울·인천·화성 정책 |
인물 키워드: 우정회장·펑위궈·양란·胡世辉·吴征·Bruno Wu(→D1) · 김형석·이승규·최남희·PDK·피디님·박사님(→D1·D3·D4) · 고삼석(→D14)
도메인 폴더 부재 시 → 글로벌 폴백 + 1줄 안내. 확장 룰 — 형이 새 도메인 진입 시 references/domain-keyword-map.md에 1행 추가(스킬 재패키징 불필요).
LOAD 출력 포맷
↻ 로드: [도메인명] · 직전 [작업명] (YYMMDD)
- 결정: [요약]
- 미결: [요약]
- 다음: [요약 + 포인터]
1줄 인사형(터보)·풀모드(명시) 2가지. 디폴트 = 1줄.
project-updater 연계 (보조)
LOAD 진입 시 {PROJECT_ROOT}/GRAPH.md 존재 hit → 1회 read 후 인-메모리 컨텍스트로 통합. 별도 출력 ✗. GRAPH.md 갱신·생성은 본 스킬 ✗·project-updater에 위임.
경로 (이원화)
VAULT = 글로벌 CLAUDE.md `MOUNT::=VAULT` resolve (세션 1회·캐시)
PROJECT_ROOT = {VAULT} 하위 프로젝트 폴더 (세션 캐시)
GLOBAL_SB = {VAULT}/_session_briefing/
PROJECT_SB = {PROJECT_ROOT}/_session_briefing/
PATH = {SB_ROOT}/YYMMDD_작업명.md
LATEST = {SB_ROOT}/_latest.md
GRAPH = {PROJECT_ROOT}/GRAPH.md (LOAD 보조 read 대상·optional)
SB_ROOT 판정 (3단계·질문 ✗)
- PROJECT_ROOT 세션 캐시 hit →
PROJECT_SB
- miss + 프로젝트 단서(최근 접근·사용자 명시·@프로젝트명·도메인 키워드) → 해당 프로젝트로 캐시 갱신 →
PROJECT_SB
- 단서 없음 →
GLOBAL_SB 직행
파일명
YYMMDD_작업명.md — YYMMDD = env date. 같은 날 동일 작업명 = 덮어쓰기. 폴더명 _session_briefing(언더스코어).
Output Path
| 산출물 | 경로 | 비고 |
|---|
| 날짜별 사본 | {SB_ROOT}/YYMMDD_작업명.md | 역추적 앵커. 누적 |
| _latest 스냅샷 | {SB_ROOT}/_latest.md | 덮어쓰기 전용. LOAD 진입점 |
| LOAD 컨텍스트 (인-메모리) | (출력 1줄 또는 풀모드 3블록) | 파일 ✗ |
Reference Index
| 파일 | 내용 | 언제 |
|---|
references/domain-keyword-map.md | 도메인 키워드 → 폴더 매핑 풀버전·확장 가능 | LOAD 모드·도메인 추가 시 |
references/save-template.md | 터보/풀 저장 콘텐츠 템플릿 | 신규 SAVE 작성 시 |
references/no-op-guard.md | no-op 가드 판정 알고리즘 풀버전 | 20턴+산출물 2건 도달 시 |
문서화 전환 게이트
| 모드 | 동작 |
|---|
| 터보 (기본) | 게이트 스킵 |
| 풀 | 3조건(핵심방향 동의·수정요청 없음·재검토 신호 없음) ALL → "문서로 옮길까요?" |
| "써줘/저장해" | 즉시 실행 |
속도 규칙
| 규칙 | 효과 |
|---|
| 터보 기본 (3줄) | 추론 토큰 -60~70% |
| VAULT 세션캐시 1회 resolve | CLAUDE.md read -90% |
| PROJECT_ROOT 세션캐시 | 판정 -90% |
| 단서 없음 → 글로벌 폴백 (질문 ✗) | 대화 턴 -1 |
| 20턴+산출물 2건 no-op 가드 | 저장 -20~40% |
| 사일런트 패치 (_latest만) | 보고 턴 -1 |
| 예약어 즉시 저장 | 압축 직전 안전망 |
LOAD = _latest.md 1회 read | I/O 단일화 |
| 도메인 키워드 자동 매핑 | 마운트·search 턴 -2~3 |
| GRAPH.md 보조 read 1회 | 프로젝트 컨텍스트 자동 |
| 2회 병렬 저장 (본파일+latest) | 저장 턴 -1 |
| 같은 날 덮어쓰기 | list 호출 -1 |
§INV FINAL_RENDER_GATE (산출물 본질 보호 — 분리형)
| 항목 | 정의 |
|---|
| SCOPE | 외부 노출 산출물에만 적용 |
| INTERNAL | 내부 라벨(터보·풀·SAVE·LOAD·도메인키워드) 작업용 유지 OK |
| RULE | 외부 노출 시점 = 평문. 작업 라벨 ZERO |
| ALLOW | 업계 전문용어·고유명사(프로젝트명·도메인명)·법조문 |
| SELF_CHECK | VAULT 저장 직전 본문만 평문 스캔. 1개라도 발견 = 차단·재작성 |
예시
| 상황 | 모드 | 단서 | 동작 |
|---|
| 프로젝트 A 작업 완료 | SAVE 터보 | 캐시 hit | {PROJECT_SB}/에 3줄 저장 |
| 스킬 정비·일반 대화 종료 | SAVE 터보 | 단서 없음 | {GLOBAL_SB}/ 글로벌 폴백 |
| "이어서" + 사공이호 컨텍스트 | LOAD | 도메인 키워드 hit | 01 사공이호/.../_latest.md 1회 read + GRAPH 있으면 같이 + 1줄 인사 |
| 새 세션 + "MAD POP" 한 마디 | LOAD | 도메인 키워드 | 자동 로드·1줄 |
| "압축각" 한 단어 | SAVE 즉시 | 예약어 hit | 조건 불문 즉시 터보 저장 |
| 산출물 1개 생성 완료 | 사일런트 패치 | 백그라운드 | _latest.md만 갱신·"↻" 1줄 |
| 20턴+산출물 2건 도달·변화 없음 | no-op | — | 저장 스킵·1문단 자가요약 |
| 단답 "지금 몇 시야" | 작동 ✗ | 도메인·컨티뉴 부재 | LOAD·SAVE 둘 다 발동 ✗ |
Next Phase
본 스킬 작업 후 자연스러운 흐름:
- 새 세션 시작 → 자동 LOAD 발동(도메인 키워드 또는 "이어서" hit 시)
- 장기 컨텍스트 관리 →
consolidate-memory(메모리 정리)
- 프로젝트 GRAPH 갱신·생성 →
project-updater
- UP 변경 필요 감지 →
up-manager
Failure Modes (Gotchas)
| 함정 | 대응 |
|---|
_latest.md에 append | 반드시 덮어쓰기. 과거는 날짜별 사본 담당 |
| 세션 마운트 경로에 저장 | {VAULT} 하위만 |
| VAULT·홈경로 하드코딩 | 절대경로 금지. {VAULT} 변수만. resolve = 글로벌 CLAUDE.md 유일 |
| PROJECT_ROOT 미확정 시 질문 반복 | 단서 없음 = 글로벌 폴백·질문 ✗ |
글로벌 _latest.md 잦은 덮어쓰기로 컨텍스트 오염 | 날짜별 사본이 역추적 앵커. _latest는 최신 인덱스만 |
| no-op 가드 오판 | 표현만 다르고 실질 변화 없으면 스킵 |
| 폴더명 공백 | _session_briefing 언더스코어 고정 |
| CLAUDE.md 매 호출 read | VAULT_RESOLVED 세션캐시 키 우선 확인 |
| 예약어("압축각") 놓침 | 조사·어미·농담·인용 전부 hit |
| 사일런트 패치가 날짜사본까지 생성 | 백그라운드 모드는 _latest.md만 |
| 20턴 카운팅 기준 모호 | 사용자↔Claude 왕복 1쌍 = 1턴 |
| LOAD 모드 단답·일상대화에서 노이즈 발동 | 도메인 키워드·컨티뉴 단어 부재 시 LOAD ✗ 강제 |
| 도메인 키워드 hit인데 폴더 없음 | 글로벌 폴백 + 1줄 안내. 자동 폴더 생성 ✗ |
| 새 세션 인사 출력 길어짐 | LOAD 디폴트 = 1줄. 풀모드는 명시 호출 시만 |
| SAVE·LOAD 동시 발동 충돌 | LOAD 먼저 → 작업 → 종료 시 SAVE. 진입 직후 동시 발동 ✗ |
| session-briefing 잔존 시 충돌 | session-skill 활성화 전 session-briefing 폴더 archive 이동 또는 제거. P1 트리거 중복 시 신규(session-skill) 우선 |
| GRAPH.md 보조 read 과사용 | LOAD 시 1회만. 작업 중 반복 read ✗ |
❌ WRONG vs ✅ CORRECT
❌ WRONG: 새 세션 진입 즉시 무조건 _latest.md 로드 → 단답에도 컨텍스트 박스 출력
✅ CORRECT: 도메인 키워드 또는 "이어서·계속·재개" hit 시만 LOAD. 단답·일상대화 ✗
❌ WRONG: SAVE 시 매번 _latest.md만 갱신 → 역추적 불가
✅ CORRECT: 날짜별 사본 + _latest.md 2회 병렬. 사본 = 앵커·latest = 최신 인덱스
❌ WRONG: PROJECT_ROOT 미확정 시 "어느 프로젝트에 저장할까요" 질문
✅ CORRECT: 단서 없음 = 글로벌 폴백 직행. 질문 ✗
❌ WRONG: 도메인 키워드 hit 시 풀모드 3블록 컨텍스트 박스 자동 출력
✅ CORRECT: LOAD 디폴트 = 1줄 인사. 풀모드는 "로드해줘·브리핑 보여줘" 명시 시만
❌ WRONG: session-briefing과 session-skill 동시 활성화 → 트리거 중복 발동
✅ CORRECT: 통합 전 session-briefing 폴더 archive 이동 또는 disable. session-skill 단일 운영
❌ WRONG: session-skill에 GRAPH.md 생성·수정 로직 흡수 → 비대화·트리거 충돌
✅ CORRECT: GRAPH.md = project-updater 책임. session-skill은 LOAD 시 보조 read만
§H. 헤리티지
- v39 (session-briefing 2026-04-25) — 이원화 저장·질문 턴 제거·VAULT 세션캐시·폴더명 공백 제거·2회 병렬 저장·절대경로 금지·rationale.md 포인터 제거·세션핸드오프 P1 추가
- v1.0 (session-skill 2026-05-24) — session-briefing v39 헤리티지 100% 흡수 + LOAD 모드 신설(도메인 키워드 자동 매핑·"이어서·계속·재개" 강함 트리거·1줄 인사 디폴트) + 9룰 7섹션 골격 강제(Boundaries·WhenToUse·Prereq·OutputPath·RefIndex·NextPhase·FailureModes) + session-briefing 폐기 게이트(중복 발동 차단) + project-updater 연계 보조 read(통합 ✗·연계 ○)
v1.0 변이 동기 — 형 진단: "session-briefing(저장)·session-bridge(자동 로드) 통합해서 session-skill로 일원화". session-bridge 별도 신설 대신 SAVE 스킬 안에 LOAD 모드 흡수해 단일 스킬 운영. 도메인 키워드 자동 매핑은 형 작업 패턴(중국런칭 28회·KIMLEECHOI 9회·KISAS 12회 회귀) 직격 처방. project-updater 통합은 책임 본질 분리(세션 휘발 vs 프로젝트 영속)로 거부 — 보조 read만 연계.
