정의

CLAUDE.md 가 사용자 수동 갱신 없이도 스스로 진화 하는 자동화 루프 — Anthropic 공식 플러그인 claude-md-management 의 2 도구로 구현.

두 도구의 자가 진화 루프

┌─────────────────────────────────────────────────────┐
│ 1. 세션 시작                                          │
│    └─ CLAUDE.md 자동 로드                             │
│                                                     │
│ 2. 세션 진행 — Claude 가 실수 / 학습 / 패턴 발견          │
│                                                     │
│ 3. 세션 종료 시:                                      │
│    /revise-claude-md 실행                            │
│    └─ Reflect → Locate → Categorize                 │
│       → Draft → Preview → Apply                     │
│    └─ CLAUDE.md 에 *학습 내용 한 줄* 추가              │
│                                                     │
│ 4. 매월 1회:                                          │
│    claude-md-improver 실행                           │
│    └─ Discovery → Assessment → Report               │
│       → Updates → Apply                             │
│    └─ 6 기준 평가 + 점수 + 리팩토링                    │
│                                                     │
│ 5. → 1 로 순환 (자가 진화)                            │
└─────────────────────────────────────────────────────┘

★ 두 도구의 역할 분리

→ 상호 보완 — 한 도구만으로는 자가 진화 불완전.

★ Karpathy 의 High ROI 워크플로우 의 자동화

Karpathy 의 핵심 명제:

"Claude 가 실수했을 때 그 자리에서 바로 '이 실수 다시 안 하게 CLAUDE.md 에 반영해' 라고 무조건 말하세요."

→ 이 수동 워크플로우 가 /revise-claude-md 로 완전 자동화. → CLAUDE.md = 살아 있는 문서 로 진화.

★ 실제 진화 곡선 (4 파일 시연 결과)

case/claudemd-improver-demo-4files 의 평균 80 점 (B):

• 루트 78 (B−) → 진화 후 예상 90+ (A)
• Supabase 76 (B−) → 진화 후 예상 85+ (B+)

→ 자가 진화 루프 1 회 적용 시 평균 10 점 상승 가능.

강의 활용

• Ch8 — 공식 플러그인 2 도구 의 상호 보완 워크플로우.
• Ch9 §9.2 — 30 일 처방의 Week 3 (자동화) + Week 4 (감사).
• [[synthesis_horim_4-pillars-applied-to-returning-dev]] — 돌아온 개발자가 CLAUDE.md 가 스스로 진화하게 만드는 30 일 처방.