cleanse-memory

description	Use when Ground Truth alignment finds memory contamination and the user explicitly requests scoped cleanup with /cleanse.
name	cleanse-memory

cleanse-memory Skill

Quick Reference

• Use when: GT 소스 대비 메모리 오염 의심 시 — /cleanse <gt-id> 또는 /cleanse --all
• 트리거: 사용자 명시 호출만 (자동 sweep 없음)
• 삭제 정책: HITL 확정 후 영구 삭제 + .hxsk/.purge-log.tsv append
• 우회: HXSK_CONTRADICTION_CHECK=0으로 신규 저장 시 contradiction check 비활성화
• audit: .purge-log.tsv (git 추적) + git history로 삭제 이력 복구 가능

---

명령 형식

/cleanse <gt-source-id>       # 특정 GT 소스 scope 내 메모리만 검사
/cleanse --all                 # sources.yaml 내 모든 GT 소스 순회
/cleanse --dry-run <gt-id>    # 삭제 없이 후보 목록만 출력

gt-source-id는 .hxsk/ground-truth/sources.yaml의 id 필드값.

예시: /cleanse hxsk-spec, /cleanse anthropic-sdk-docs

---

처리 흐름

Step 1: GT 소스 로드

cat .hxsk/ground-truth/sources.yaml

• <gt-id>에 해당하는 항목의 scope, authority, type, path/url 추출
• type: docs이고 url: ""이면 → HITL 재질문: "GT URL을 입력해주세요. 없으면 Skip."
• scope: []이면 → HITL 재질문: "scope가 비어있습니다. 적용 범위를 지정해주세요."

Step 2: scope 내 메모리 검색 (≤20개 제한)

bash .hxsk/hooks/md-recall-memory.sh "<scope_tag>" "." 20 full 1

• scope 태그를 순서대로 검색하여 관련 메모리 파일 수집
• 중복 제거 후 최대 20개

Step 3: 인라인 Claude 판단 (각 메모리 파일)

각 파일에 대해 GT 사실과 비교:

• 일치 (no conflict): 패스 → 다음 파일
• 모순 의심 (contradiction suspected): HITL → 4지 선택

HITL 선택지:

[D] 삭제     — 확실한 오염, 영구 삭제 + purge-log 기록
[K] 보관     — 다른 scope로 이동 또는 태그 분리 후 보존
[G] GT 오류  — 이 메모리가 맞고 GT가 오류, Skip (메모리 유지)
[S] Skip     — 판단 보류, 이번 sweep에서 제외

Step 4: 삭제 확정 시 처리

# 1. 파일 삭제
rm "<memory_filepath>"

# 2. purge-log.tsv append
echo "$(date -u +%Y-%m-%dT%H:%M:%SZ)\t<memory_id>\t<reason>\t<gt-id>\t<summary_≤200chars>\t<hitl_choice>" \
  >> .hxsk/.purge-log.tsv

# 3. 관련 메모리의 contradicted_by 갱신 (있는 경우)
# related 파일 목록 조회 후 해당 파일의 contradicted_by 배열에 삭제된 파일명 추가

purge-log 컬럼 형식:

컬럼	설명
deleted_at	ISO-8601 UTC
memory_id	파일 basename
reason	1줄 삭제 사유 (≤80자)
gt_source	GT id (sources.yaml id 값)
original_summary	contextual_description ≤200자
hitl_decision	D / K / G / S

Step 5: 정화 보고서 출력

🔍 Cleanse Report: <gt-id>
  검사: N건 | 삭제: M건 | 보관: K건 | Skip: S건
  purge-log: .hxsk/.purge-log.tsv (M행 추가)

---

Scope 경계 규칙

• scope 외 메모리는 절대 삭제 금지
• --all 모드도 각 GT의 scope 경계 준수 (GT별 독립 sweep)
• scope가 겹치는 GT 여러 개 있을 경우, 첫 번째 GT 기준 판단 후 나머지 GT에 동일 결정 전파

---

제약 조건

• type: docs이고 url: ""인 GT → 자동 fetch 금지, HITL로 URL 요청
• scope 외 파일 삭제 금지 — scope 경계 위반 시 즉시 중단
• purge-log.tsv를 gitignore 대상으로 만들지 말 것 (audit trail은 git 추적 필수)
• --dry-run 시 실제 삭제·purge-log 기록 금지, 후보 목록과 예상 삭제 수만 출력

---

Iron Laws

• NO CLEANSE WITHOUT GT SOURCE LOAD FIRST
• NO DELETE WITHOUT HITL CONFIRMATION FIRST
• NO PURGE-LOG SKIP ON DELETE
• NO SCOPE BOUNDARY VIOLATION

---

관련 파일

• .hxsk/ground-truth/sources.yaml — GT 소스 카탈로그
• .hxsk/.purge-log.tsv — 삭제 audit trail (git 추적)
• .hxsk/hooks/md-recall-memory.sh — 메모리 검색 (provenance 우선순위 적용)
• .hxsk/hooks/md-store-memory.sh — 저장 시 contradiction check (ADR-007)
• .hxsk/adapters/hitl/ — HITL 어댑터 (하네스별)