session-briefing

name	session-briefing
description	세션 브리핑 자동화 v39. 작업 완료시 결정·미결·다음을 VAULT에 저장. 프로젝트 단서 있음=프로젝트 폴더, 없음=글로벌 `_session_briefing/` 자동 폴백(질문 ✗). 터보(기본)=3줄, 풀=3블록+포인터. VAULT 세션캐시 1회 resolve·PROJECT_ROOT 세션캐시·no-op 가드 내장. 세션브리핑, 세션저장, 작업완료 자동발동. P1: 세션브리핑, 세션저장, session briefing, 작업완료, 브리핑, 세션핸드오프, 압축각, 저장각, 컨텍스트꽉, 선제저장. P2: 브리핑해줘, 저장해줘, resume, brief, save session. P3: session brief, context preservation, session continuity, session handoff. P5: md파일로, `_session_briefing/` 저장. NOT: UP수정(→up-manager), 산출물저장, 일반문서작성(→직접수행).
vault_dependency	SOFT

Session Briefing

세션 간 컨텍스트 연속성 보장. 작업 결과를 VAULT에 저장, 다음 세션에서 자동 로드. 프로젝트 단서 있음=프로젝트 폴더, 없음=글로벌 폴백.

---

⛔ 절대 규칙

#	규칙	이유
1	절대경로 하드코딩 금지 — VAULT·PROJECT_ROOT·홈경로 어떤 형태든 스킬 본문 절대경로 ✗. 오직 {VAULT} 변수로 표현	머신·사용자 변경 시 즉사 방지
2	VAULT resolve = 세션 1회 — 글로벌 CLAUDE.md MOUNT::=VAULT 세션 첫 호출에만 read, 이후 세션캐시 키 VAULT_RESOLVED 재사용	CLAUDE.md 반복 read 차단
3	세션 마운트·볼트 외부 저장 금지 — 반드시 {VAULT} 하위만	세션 종료 시 소실 방지
4	_latest.md 덮어쓰기 — append 금지 — 과거는 날짜별 사본 담당	정합성 보장
5	PROJECT_ROOT 미확정 시 질문 ✗ — 프로젝트 단서 없음 = 글로벌 {VAULT}/_session_briefing/로 직행	턴 절감. 오저장 방지는 단서 기반 추론으로 대체

자체 점검 (self-check)

스킬 수정 후: SKILL.md ≤5KB · P1 ≥5개 · 절대규칙 존재 · Gotchas ≥3행 · 본문 내 절대경로 0개 확인.

---

발동

조건	모드	행동
"압축각·저장각·컨텍스트꽉" (예약어, 최우선)	터보 즉시	조건 불문 즉시 저장. 압축 직전 안전망. no-op 가드 ✗
작업 완료	터보	자동. 3줄 요약 + 2회 저장 (본파일·_latest.md 덮어쓰기)
산출물 생성·결정 확정 (백그라운드)	사일런트 패치	_latest.md만 조용히 덮어쓰기. 날짜사본 skip. 보고 1줄("↻ _latest 갱신"). 압축 발생해도 최신 스냅샷 보존
20턴↑ AND 산출물 ≥2개 (형 기본토큰 무거움)	터보 + no-op 가드	결정·미결·다음 중 ≥1 변화시만 저장. 무변화 = 인-컨텍스트 1문단 자가요약 + 1줄 보고
"이어서" / 새 세션	로드	컨텍스트 기반 _latest.md 1회 read, 끝 (정합성 검증 ✗)
"풀 브리핑"·"상세"	풀	3블록 + 포인터 전부 + 2회 저장
"생략"	—	1회 스킵

임계치·예약어 하드넘버

항목	값	비고
턴 임계치	20턴	형 UP 기본토큰 무거움 반영. 기존 10턴에서 상향
산출물 임계치	≥2개	파일 생성·커밋·산출물 저장 2건 이상 누적 시
예약어	압축각 저장각 컨텍스트꽉 선제저장	한 단어만 떠도 즉시 저장 발동. 조건 불문
사일런트 패치 대상	_latest.md 덮어쓰기만	날짜사본·보고 전문 skip. 압축 안전망 역할

---

경로 (이원화)

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

SB_ROOT 판정 (3단계, 질문 ✗)

1. PROJECT_ROOT 세션 캐시 hit → PROJECT_SB
2. miss + 프로젝트 단서 (최근 접근·사용자 명시·@프로젝트명) → 해당 프로젝트로 캐시 갱신 → PROJECT_SB
3. 단서 없음 → GLOBAL_SB 직행

프로젝트 전환은 사용자 명시 시에만 캐시 갱신. 세션 마운트·볼트 외부 폴백 ✗.

로드 ("이어서")

컨텍스트	읽을 파일
PROJECT_ROOT 캐시 hit	{PROJECT_SB}/_latest.md
miss	{GLOBAL_SB}/_latest.md

파일명

YYMMDD_작업명.md — YYMMDD는 env date. 같은 날 동일 작업명 = 덮어쓰기. 폴더명 _session_briefing (언더스코어, 공백 없음). 없으면 쓰기 시 자동 생성.

---

콘텐츠

터보 (기본) — 3줄

- 결정: [확정된 핵심 1~2개 / 한 줄]
- 미결: [보류 + 사유 / 한 줄. 없으면 "없음"]
- 다음: [다음 세션 첫 행동 + → 파일경로 / 한 줄]

포인터(→ path)는 다음액션에만 필수. 결정·미결은 변경 파일 있을 때만.

풀 (명시 요청) — 3블록 + 포인터

1. 결정사항 + → 관련 파일
2. 미결 + 사유 + 외부 대기 + → 관련 파일
3. 다음액션 + → 관련 파일

저장 = 2회 병렬

날짜별 사본 + _latest.md 동시 write (병렬 tool call). 누적 ✗. 터보에서도 날짜별 사본 필수(역추적 앵커).

---

문서화 전환 게이트

모드	동작
터보 (기본)	게이트 스킵
풀	3조건(핵심방향 동의·수정요청 없음·재검토 신호 없음) ALL → "문서로 옮길까요?"
"써줘/저장해"	즉시 실행

---

속도 규칙

규칙	효과
터보 기본 (3줄)	추론 토큰 -60~70%
VAULT 세션캐시 1회 resolve	CLAUDE.md read -90%
PROJECT_ROOT 세션캐시	판정 -90%
단서 없음 → 글로벌 폴백 (질문 ✗)	대화 턴 -1
20턴+산출물2개 no-op 가드	저장 -20~40%
사일런트 패치 (_latest만)	보고 턴 -1
예약어 즉시 저장	압축 직전 안전망
터보 시 게이트 스킵	대화 턴 -1~2
로드 = _latest.md 1회 read (검증 ✗)	I/O 단일화
YYMMDD = env date	bash 호출 -1
디렉토리 존재 확인 생략 (쓰기 실패 시 create)	MCP 호출 -1
저장 2회 병렬 (본파일+latest)	저장 턴 -1
같은 날 덮어쓰기	list 호출 -1

---

예시

상황	단서	저장 위치
프로젝트 A에서 작업 완료	캐시 hit	{VAULT}/프로젝트A/_session_briefing/
스킬 정비·일반 대화	단서 없음	{VAULT}/_session_briefing/ (글로벌)
"이어서" (프로젝트 컨텍스트)	캐시 hit	{PROJECT_SB}/_latest.md 1회 read
"이어서" (새 세션, 단서 없음)	miss	{GLOBAL_SB}/_latest.md 1회 read
20턴+산출물2개 도달, 변화 없음	—	저장 스킵 → 1문단 자가요약
"압축각" 한 단어	예약어 hit	조건 불문 즉시 터보저장
산출물 1개 생성 완료	백그라운드	_latest.md 조용히 갱신 ("↻" 1줄만)

---

§INV FINAL_RENDER_GATE (산출물 본질 보호 — 분리형)

항목	정의
SCOPE	사용자에게 전달되는 최종 산출물에만 적용
INTERNAL	내부 처리 라벨(축·층·Phase·모드 등)은 작업용으로 유지 OK
RULE	외부 노출 시점 → 산출물·대화 = 인간 언어. 작업 라벨 ZERO. (1만 페이지 1단어 = FAIL)
판정	"이 단어, 이 대화 밖 사람이 사전 없이 읽을 수 있나?" NO → 작업 라벨 → 금지
ALLOW	업계 전문용어 · 고유명사(프로젝트명·세션명) · 법조문
CONVERT	라벨 발견 → 실명·평문 풀어쓰기. 예) 내부 3블록 구조 라벨은 작업용으로 유지. 사용자 노출 .md 본문(결정·미결·다음)은 평문
SELF_CHECK	VAULT 저장 직전(내부 처리 라벨 보존, 본문만 평문)에서 자체 스캔. 1개라도 발견 = 차단·재작성

---

Gotchas

함정	대응
_latest.md에 append	반드시 덮어쓰기. 과거는 날짜별 사본 담당
세션 마운트 경로에 저장	{VAULT} 하위만
VAULT·홈경로 하드코딩	절대경로 금지. {VAULT} 변수로만 표현. resolve는 글로벌 CLAUDE.md 유일
PROJECT_ROOT 미확정 시 질문 반복	단서 없음 = 글로벌 폴백. 질문 ✗
글로벌 _latest.md 잦은 덮어쓰기로 컨텍스트 오염	날짜별 사본이 역추적 앵커. _latest는 최신 인덱스 역할만
no-op 가드 오판	표현만 다르고 실질 변화 없으면 스킵
폴더명 공백	_session_briefing 언더스코어 고정 (bash 따옴표 불필요)
CLAUDE.md 매 호출 read	VAULT_RESOLVED 세션캐시 키 우선 확인
예약어("압축각") 놓침	조사·어미·농담·인용 전부 hit. "압축각이네" "저장각인가?" 모두 즉시 발동
사일런트 패치가 날짜사본까지 생성	백그라운드 모드는 _latest.md만. 날짜사본·3블록 보고 전부 skip
20턴 카운팅 기준 모호	사용자↔Claude 왕복 1쌍 = 1턴. 산출물=파일생성/커밋/최종딜리버리 중 택일