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

왜 쓰나요

핵심 기능

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

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-reflect-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-reflect-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/BayramAnnakov/claude-reflect",
        "~/.claude/skills/claude-reflect"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-reflect-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/BayramAnnakov/claude-reflect",
          "~/.claude/skills/claude-reflect"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add claude-reflect-skill -- git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: claude-reflect

수동 관리 없이 CLAUDE.md 진화

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

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

사전 조건

Skill 설치 — git clone https://github.com/BayramAnnakov/claude-reflect ~/.claude/skills/claude-reflect
Reflection 활성화 — 프로젝트의 CLAUDE.md 서문에 use claude-reflect 추가

흐름

평소처럼 작업

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