context-save

개요

현재 대화에서 오간 논의의 핵심을 AI 에이전트 독립적인 마크다운 파일로 .ai/99_workspace/notes/에 임시 저장하는 스킬입니다. 다음 세션의 에이전트(Claude Code, Codex, Antigravity, GitHub Copilot 등)가 파일만 읽고도 맥락을 이어갈 수 있도록 대화 재현이 아닌 상태 스냅샷을 기록합니다.

.ai/99_workspace/는 임시 작업공간이며, 주 사용 흐름은 다음과 같습니다:

저장 → 다음 세션에서 /issue-work --resume으로 자동 로드 → 흡수 후 사용자가 수동 정리.

영구 보존을 가정하지 않으며, 필요 시 정식 위치(50_adr/, 40_domain/, 90_issues/)로 사용자가 승격합니다.

언제 쓰는가

• 이슈 진행 중 특정 Task가 완전히 마무리되지 않았지만 맥락을 잠시 붙잡아두고 싶을 때.
• 이슈 등록 없이 자유롭게 논의한 내용을 다음 세션까지 이어가고 싶을 때.
• 결정은 났지만 다음 세션에 실행·검증이 남아 맥락을 넘기고 싶을 때.

관련 skill

• ai-workspace (권장): .ai/99_workspace/ 구조를 활용합니다. 없으면 필요한 디렉토리를 직접 생성합니다.
• issue-work (연동): 이슈 작업 중 실행하면 활성 이슈를 자동 감지하여 related-issue로 연결합니다. issue-work --resume은 이미 .ai/99_workspace/ 하위를 모두 읽으므로 저장된 노트는 별도 설정 없이 다음 세션에 복구됩니다.

참조 문서

• 공통 규칙: .ai/10_rules/context-loading.md — 있으면 따르며, 이미 적재되어 있으면 재로딩하지 않습니다.
• 스킬 고유 추가 참조:
  • .ai/90_issues/active/ — 활성 이슈 번호 자동 감지 (있을 경우)
  • .ai/99_workspace/notes/ — 기존 노트 파일명 충돌 확인
  • .ai/10_rules/writing-principles.md·.ai/10_rules/writing-principles-local.md — 있으면 산출물 작성 원칙으로 참조 (충돌 시 local 우선; 없으면 본문의 "산출물 접기 기준"이 기본값)

---

핵심 원칙

상태 스냅샷, 대화 재현 금지

• 누가 뭐라고 말했는지가 아니라 결론과 근거만 기록한다.
• 특정 AI 도구의 UI 용어, 세션 ID, 내부 상태에 의존하지 않는다.
• 파일 하나만 읽어도 제3자가 상황을 파악할 수 있어야 한다.

자기 완결성

• 상대 시간 금지 → 항상 절대 날짜(YYYY-MM-DD).
• 파일 경로는 repo 루트 기준 상대 경로.
• 외부 참조는 URL, 이슈/PR 번호, 커밋 해시로 명시.

이슈와 느슨한 결합

• 이슈 진행 중이어도 맥락 노트는 이슈 파일과 독립적으로 저장한다.
• 연결은 프론트매터 related-issue 필드로만 한다.
• 노트는 임시 저장 성격이므로 이슈 종료 후 정리는 사용자가 수동으로 판단한다.

---

저장 위치 및 파일 규칙

.ai/99_workspace/notes/
└── YYYY-MM-DD-<slug>.md

• 파일명 형식: YYYY-MM-DD-<slug>.md
  • 예: 2026-04-24-auth-refactor-decision.md
• slug: 주제를 요약한 kebab-case 짧은 식별자. 영문 권장, 필요 시 한글 허용.
• 충돌 처리: 같은 날 같은 slug가 이미 있으면 -2, -3 숫자 접미사를 붙인다.

---

실행 흐름

slug는 기본적으로 대화 주제에서 자동 생성합니다. 인자로 직접 지정할 수도 있습니다.

기본 (자동 생성):

사용자: /context-save

스킬:  slug 자동 생성 → `auth-refactor-decision`
       활성 이슈 #42 가 감지되었습니다. related-issue로 연결할까요? (Y/n)
사용자: Y

스킬:  현재 대화에서 배경/결정/미결/다음 액션을 추출하여 작성합니다...
       → .ai/99_workspace/notes/2026-04-24-auth-refactor-decision.md