claude-reflect (Claude Skill) — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

암묵적 수정 감지 ("실제로, 이 방법으로 해") 및 긍정 신호
규칙 추가 초안 작성; CLAUDE.md에 반영 전 승인
동일한 규칙이 비 Claude 도구를 위한 AGENTS.md에도 반영
주기적 통합으로 모순되거나 오래된 규칙 제거
diff 기반 업데이트로 git 히스토리 가독성 유지

라이브 데모

실제 사용 모습

준비됨

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: claude-reflect

수동 관리 없이 CLAUDE.md 진화

👤 문서 파일 유지를 싫어하는 솔로 개발자 ⏱ ~5 min beginner

언제 쓸까: CLAUDE.md가 쓰기 부담 없이 선호도를 따라가길 원할 때.

흐름

평소처럼 작업

Just code with Claude as usual. Correct it when wrong, praise it when right.✓ 복사됨

→ Skill이 조용히 캡처 — 눈치채지 못함
하루 마무리 검토

Use claude-reflect. Show me today's drafted rule additions. Approve or skip each.✓ 복사됨

→ 출처(어떤 세션, 어떤 prompt)가 있는 5–10개 후보 규칙
diff 커밋

Apply approved rules and commit CLAUDE.md.✓ 복사됨

→ 깔끔한 git diff; 이제 규칙 적용됨

결과: 수동 유지 부담 없이 함께 성장하는 CLAUDE.md.

함정

Skill이 일회성 컨텍스트를 지속적인 규칙으로 캡처 — 항상 일일 후보를 검토; 상황적인 것은 거부

함께 쓰기: filesystem

집단적 수정으로 팀 전체 AI 관례 구축

👤 AI 워크플로우를 표준화하는 기술 리더 ⏱ ~60 min intermediate

언제 쓸까: 여러 개발자가 Claude에게 비슷한 것들을 수정하는데, 공유 규칙 세트를 원할 때.

흐름

개발자별 초안 수집

Each dev runs claude-reflect daily and pushes their candidate rules to a shared review branch.✓ 복사됨

→ N개의 초안이 대기 중인 브랜치
세션 병합

Use claude-reflect consolidate. Find rules captured by ≥2 people; promote those to AGENTS.md.✓ 복사됨

→ 공통 근거 규칙 세트
배포

Merge to main. New AGENTS.md applies to everyone.✓ 복사됨

→ 팀이 동일한 기준선 사용; 개발자별 로컬 규칙은 유지

결과: 프로세스 위원회 없는 바텀업 표준화.

함정

목소리 큰 개발자가 지배; 조용한 개발자의 패턴 누락 — 모든 사람이 skill을 실행하도록; 파일 편집이 아닌 반성 이벤트로 가중치 부여

함께 쓰기: github

CLAUDE.md의 오래된 규칙 감사 및 정리

👤 오랫동안 CLAUDE.md를 사용한 분 ⏱ ~25 min intermediate

언제 쓸까: CLAUDE.md가 이제 600줄이 되고 Claude의 컨텍스트가 비대해졌을 때.

흐름

관련성 점수화

Use claude-reflect. Score each rule by recency-of-last-application and current-codebase-fit.✓ 복사됨

→ 규칙별 점수
삭제 제안

Suggest 30 rules to remove (stale or obsolete).✓ 복사됨

→ 근거가 있는 제거 목록
diff + 커밋

Apply approved removals; commit with message 'reflect: prune stale rules'.✓ 복사됨

→ 더 슬림해진 CLAUDE.md

결과: 훑지 않고 실제로 읽히는 CLAUDE.md.

함정

Claude가 규칙을 준수했기 때문에 적용되지 않은 규칙을 정리 — 의심스러우면 유지 — 하지만 '마지막 검증' 태그를 붙여서 다음 분기에 재확인

조합

다른 MCP와 조합해 10배 효율

claude-reflect-skill + pro-workflow-skill

명시적 캡처에는 pro-workflow, 수동적에는 claude-reflect — 두 채널 학습

Use pro-workflow when you say 'remember this'; let claude-reflect catch the rest in the background.✓ 복사됨

claude-reflect-skill + github

PR을 통한 검토 가능한 규칙 변경

Each Friday, claude-reflect opens a PR with proposed CLAUDE.md edits for human review.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
watch_session	—	항상 켜져 있는 백그라운드 프로세스
review_candidates	since?	일/주 단위 승인 루프
consolidate	scope?	주기적 중복 제거 / 모순 해결
score_rules	—	정리 전 감사
apply_to_files	approved_ids[], files[]	승인된 후보를 CLAUDE.md / AGENTS.md에 반영

비용 및 제한

운영 비용

API 쿼터: 없음 — 로컬
호출당 토큰: 백그라운드 캡처는 무료; 검토/통합은 설정된 경우 로컬 LLM 사용
금액: 무료
팁: 후보를 보수적으로 승인 — 품질 > 수량

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-write

자격 증명 저장: Skill 상태는 .claude/reflect/에; 공유하려면 저장소에 커밋

데이터 외부 송신: 기본적으로 없음

반성 로그에 민감한 코드 스니펫이 포함될 수 있음 — 원시 로그는 gitignore; 정제된 규칙만 커밋

문제 해결

자주 발생하는 오류와 해결

후보가 캡처되지 않음

CLAUDE.md 서문에 skill이 호출됐는지 확인; .claude/reflect/log에서 항목 확인

후보가 노이즈

트리거 민감도 조정; 일반 채팅이 아닌 명시적 수정에서만 캡처

AGENTS.md가 CLAUDE.md에서 벗어남

주기적으로 통합 실행; 도구는 동기화 유지를 설계됐지만 수동 편집으로 벗어남

승인 prompt가 압도적

매일 --limit 5로 실행; 한 번에 50개 하는 대신 습관 만들기

대안

claude-reflect 다른 것과 비교

대안	언제 쓰나	단점/장점
pro-workflow-skill	명시적 캡처와 worktree 오케스트레이션을 선호할 때	더 수동적; 병렬 작업에 더 강력
Manual CLAUDE.md curation	스스로 규칙을 작성할 의지가 있을 때	자주 방치됨; 의지력에 의존

claude-reflect