retrospectlisted

# 회고(retrospect) — out-of-band 자기개선 제안 **제안만 한다. 규칙·메모리 파일을 직접 수정하지 않는다.** 산출물은 보고서 1장. 적용은 사용자가 나중에 지시. ## 절차 1. **스캔 실행 (기계):** `node "${CLAUDE_PLUGIN_ROOT}/skills/retrospect/retrospect-scan.mjs" "$(pwd)"` → findings JSON. (스크립트가 스코프·샘플·JSON 정밀 grep·빈도·**시크릿 값 마스킹**을 처리 — 단, 마스킹은 `.env` 값과 고엔트로피 토큰 모양 문자열만 가린다. 모든 형태의 시크릿을 보장하진 않으므로, 혹시라도 토큰 모양 문자열이 findings에 남아 보이면 절대 그대로 인용하지 말 것.) **커버리지를 먼저 읽는다 — 층이 둘이다:** 부모 세션은 `meta.coverage`·`meta.sessionsSkipped`, **게이트(검토 담당) 층은 `meta.agentCoverage`·`meta.agentFilesScanned`·`meta.agentFilesWithSignal`·`meta.agentFilesSkipped`**를 확인한다. 🛑 **두 숫자를 합쳐 말하지 않는다** — 2026-07-30 회고가 "4/4 전부 읽음"으로 보고했는데 그건 ��모 층만 센 것이었고 게이트 층 17개(8.4MB)는 스캐너가 열지도 않아 바이트로는 44%였다. 게이트 층은 v0.41.1부터 스캐너가 직접 읽는다(값싼 선별: 안전훅 차단 흔적이 있는 파일만 파싱). **파일당 4MB를 넘는 세션(사유 `file-cap-partial`)은 v0.42부터 통째 스킵이 아니라 부분 판독이다** — 안전훅 차단(near-miss)**만** 자동으로 건져내고, 게이트 저발동(gate-gap)과 사용자 교정은 **못 본다**(그 둘은 세션 전체 상태에 기대서, 잘라 읽으면 없는 구멍을 만들어낸다). 부분 판독한 세션 수는 `meta.sessionsPartiallyRead`에 따로 나오고 `meta.sessionsScanned`에는 안 들어간다. 세션 수 상한(30)에 걸린 것(`session-cap`)은 여전히 통째로 안 읽는다. 건너뛰거나 부분만 읽은 게 있으면: - **보고서 첫머리에 커버리지를 밝힌다** — "48개 중 10개만 읽음" 같은 사실을 숨기면 "그 외엔 아무것도 없었다"로 읽힌다. - 큰 세션부터 **Read로 직접 읽어** 메꾼다(목록은 크기 내림차순). **`file-cap-partial`인 세션은 near-miss가 이미 집계됐으니 메꿀 몫은 게이트 저발동·사용자 교정 두 가지뿐이다**(중복 백필 금지). 게이트 본문은 부모 트랜스크립트가 아니라 `<세션>/subagents/agent-*.jsonl`에 있다(백그라운드 게이트는 부모에 실행 안내만 남는다). 스캐너는 이 층에서 **near-miss(안전장치가 실제로 되돌린 기록)만** 자동 집계한다 — 게이트 판정·지적 내용을 보려면 그 파일을 직접 읽어야