CLAUDE.md 점진적 공개 최적화기

무엇을 해주나

비대해진 CLAUDE.md를 줄 수 줄이기가 아니라 정보 효율 기준으로 재구조화합니다.

• 핫스팟 측정 우선: /context 비중, 섹션별 바이트 표, 초대형 라인 분포, 소비 도구의 잘림 한계(예: Codex project_doc_max_bytes 기본 32KiB)를 먼저 측정합니다.
• 신호 분류(트리아지): "이걸 지우면 Claude가 실수하나?"라는 기준으로 신호/반신호를 나누고, 반신호(추론 가능·상식·중복)는 사용자 확인 후에만 삭제합니다.
• 원문 그대로 이동: Level 2로 옮길 때 압축·재작성 금지. 다중 섹션은 scripts/sink_sections.py로 기계적으로 이동 후 전체 문자열 검증, 실패 시 자동 롤백.
• 캐리어 선택 매트릭스: 상시 규칙 / reference / Skill / Hook(차단형·주입형) / .claude/rules/ 중 어디에 둘지 판단표 제공.
• 3단 검증: 참조 파일 존재(5a), 내용 완결성(5b, 독립 서브에이전트 감사 기본), 줄 수는 검증 기준에서 제외(5c).
• 검증 도구 자체의 함정 문서화: grep -F가 여러 줄 원문에서 '행 단위 OR'로 퇴화해 손실을 통과시키는 문제, symlink·정규식 메타문자·bash/zsh 차이까지 실측 기반으로 다룹니다.

이런 분께 추천

• CLAUDE.md가 수만 자로 커져 Claude가 규칙을 자꾸 무시하는 팀/개인
• 규칙 문서를 정리하면서 중요한 정보를 잃고 싶지 않은 사람
• 전역 ~/.claude/CLAUDE.md와 프로젝트별 문서의 역할이 뒤섞여 있는 경우
• Codex 등 다른 도구가 같은 문서를 읽어 조용히 잘려나가는지 확인하고 싶은 경우

활용 예시

1. "내 CLAUDE.md 너무 긴 것 같아" → 스킬이 먼저 "줄 수는 목표가 아니다"로 프레임을 바꾸고, 섹션별 바이트 표를 뽑아 가장 큰 기여자부터 처리합니다.
2. 168KB 전역 문서 정리 → 세션 시작 컨텍스트의 69%를 차지하는 핫스팟을 찾아, 저빈도 SOP 10개 섹션을 ~/.claude/references/로 원문 그대로 이관하고 트리거 조건이 붙은 인덱스를 앞·뒤에 배치.
3. 가짜 포인터 점검 → "자세한 내용은 anti-patterns.md 참조"라고 써 있지만 실제로 그 내용이 없는 링크를 특이 문자열 grep + python 전체 문자열 대조로 잡아냅니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 daymade-claude-code/claude-md-progressive-disclosurer 폴더를 내 ~/.claude/skills/claude-md-progressive-disclosurer/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.