save-context

활성화 조건

사용자가 직접 트리거할 때 실행한다. (예: "컨텍스트 저장해줘", "save context", "/save-context")

워크플로우

Step 1. 데이터 수집

아래 명령을 실행하여 원시 데이터를 수집한다.

git branch --show-current
git log --oneline -20
pwd

Step 2. 판단 기준 적용

.claude/skills/save-context/references/guide.md를 읽고, 대화 내용에서 아래를 분류한다.

반드시 저장할 것:

• 의사결정과 그 이유 (왜 A를 선택하고 B를 기각했는지)
• 암묵적 맥락 (코드에 드러나지 않는 배경)
• 미완료 작업의 구체적 현재 상태와 다음 단계
• 발견한 함정/이슈 (다음 세션에서 시간을 절약할 수 있는 정보)
• 사용자의 명시적 요구사항
• 실패한 접근과 교훈

저장하지 않을 것:

• 코드 자체 내용 (git diff로 확인 가능 → 파일 경로 + 변경 의도만)
• 일반적인 기술 지식 (Claude가 이미 아는 것)
• 대화의 시행착오 과정 (최종 결정만)
• 디버깅 로그/스택 트레이스 (원인과 해결책만)

Step 3. 문서 작성

1. .claude/skills/save-context/references/example.md를 읽어 깊이/톤/구체성 수준 확인
2. .claude/skills/save-context/TEMPLATE.md에 맞춰 작성
3. 예시와 동일한 수준의 구체성으로 각 섹션 작성

Step 4. 자가 검증

작성 후 아래 체크리스트로 검증한다. 미충족 항목이 있으면 보완 후 저장한다.

• 작업 요약: 한 줄로 "무엇을 했고 핵심 결과물이 뭔지" 파악 가능한가
• 배경 및 목표: "왜 이 작업을 시작했는가"가 명확한가 (트리거 + 문제 + 기대 결과)
• 완료 태스크: 각 항목이 독립적으로 검증 가능한가 ("~에 대해 작업함" 금지)
• 남은 태스크: 다음 세션이 질문 없이 바로 시작할 수 있을 만큼 구체적인가
• 주요 결정: 트레이드오프가 있었던 선택만 기록했는가 (뻔한 선택 제외)
• 이슈/주의사항: 다음 세션에서 시간을 절약할 수 있는 정보만 포함했는가
• 파일 변경: "무엇을 했다"가 아닌 "왜/무슨 목적으로 변경했다"로 기술했는가
• 불필요 정보 제거: 코드 내용, 일반 기술 지식, 디버깅 로그가 포함되지 않았는가

Step 5. 저장 및 초기화

파일을 옵시디언 볼트에 저장한다.

저장 정보

• 경로: /Users/woogy/Desktop/보관함/obsidian/claude-session-memory/{지금 프로젝트명}
• 파일명: yyyy.mm.dd | hh:mm.md (현재 시각 기준, 24시간제)

작성 규칙

• 구체적으로 작성: "작업 진행함" 금지. 반드시 대상 + 행동 + 결과 포함
• 예시 수준 일치: references/example.md의 각 섹션과 동일한 깊이와 분량으로 작성
• 코드 대신 의도: 코드 내용이 아닌 변경 의도와 배경을 기록
• 결정은 대안과 함께: "X로 결정" 뿐 아니라 "Y를 기각한 이유"까지 포함
• 남은 태스크는 실행 가능하게: "이어서 진행"이 아닌 "구체적으로 무엇을 어떻게" 기술