claude-reflect
무엇인가
claude-reflect는 Claude Code 세션에서 나온 교정·긍정 피드백·명시적 선호를 수집해 규칙 파일에 영구 기억으로 반영하는 자기학습 스킬 묶음이다. 규율하는 영역은 두 갈래다. 하나는 사용자가 한 번 지적한 규칙(모델 선택, 도구 사용, 표현 방식)을 다시 지적하지 않아도 되게 만드는 기억 관리이고, 다른 하나는 반복되는 요청 패턴을 찾아 슬래시 명령 초안으로 승격하는 워크플로 재사용이다.
어떻게 동작하나
동작은 2단계다. 훅이 세션 중 교정 문장을 자동 감지해 큐에 적재하고, `/reflect` 슬래시 명령이 수동 검토 단계에서 큐를 처리한다. 감지는 정규식 실시간 매칭(`"no, use X"`, `"don't use Y"`, `"actually"`, `"that's wrong"`, `"remember:"`)과 `/reflect` 시점의 시맨틱 AI 검증을 결합하며, 각 항목에 0.60~0.95 신뢰도 점수가 붙고 정규식·시맨틱 중 높은 값이 최종 점수가 된다. 승인된 학습은 `~/.claude/CLAUDE.md`, `./CLAUDE.md`, 하위 디렉터리 `CLAUDE.md`, `.claude/commands/*.md`, 존재할 경우 `AGENTS.md`로 동기화된다.
무엇과 다른가
직접 CLAUDE.md를 손으로 편집하거나 프롬프트에 규칙을 매번 붙이는 방식과 구조가 다르다. 캡처가 훅으로 자동화되어 있고, 적용 전에 사람 검토 게이트를 통과해야 하며, 단일 파일이 아니라 여러 대상 파일에 분배 동기화된다. 정규식만 쓰지 않고 시맨틱 검증을 겹쳐 다국어 교정(예: `"no, usa Python"`)과 오탐을 처리한다. `/reflect-skills`는 세션 이력을 시맨틱 유사도로 묶어 반복 작업을 슬래시 명령 후보로 제안하고, 프로젝트별로 배치 위치를 물어 초안 파일을 생성한다.
어떻게 쓰나
설치는 마켓플레이스 등록과 플러그인 설치 두 명령으로 끝나며, 설치 후 Claude Code를 재시작해야 훅이 자동 구성되고 명령이 활성화된다. 첫 `/reflect` 실행 시 과거 세션 스캔 여부를 묻는다. `/reflect --targets`로 갱신 대상 파일을 미리 확인하고, `/reflect-skills`는 `--days`, `--all-projects`, `--dry-run` 옵션으로 분석 범위와 미리보기를 조정한다.
전제와 한계
전제는 Claude Code CLI와 Python 3.6+이며 macOS·Linux·Windows를 모두 지원한다(Windows는 WSL 불필요). 스킬 자체는 Claude Code에서 돌지만 `AGENTS.md` 동기화를 통해 Codex·Cursor·Aider·Jules·Zed·Factory가 그 결과를 읽는다. 학습 적용과 스킬 생성은 모두 사람 승인을 거쳐야 하고, 세션 이력 분석은 기간·프로젝트 범위 옵션에 따라 느려진다.