단원 — Anthropic 공식 플러그인 (claude-md-improver + /revise-claude-md)
Lesson (강의 단원)lecturedraftTue May 12

단원 — Anthropic 공식 플러그인 (claude-md-improver + /revise-claude-md)

별칭: claude-md-management · claude-md-improver · revise-claude-md · anthropic-official-plugin

#official-plugin#anthropic#isabella-he#self-evolving#automation

요약

entity/isabella-he (Anthropic) 작성 — anthropics/claude-plugins-official/plugins/claude-md-management 공식 플러그인. claude-md-improver 스킬 (5 단계 감사) + /revise-claude-md 명령 (6 단계 학습 캡처) 의 상호 보완 으로 CLAUDE.md 자가 진화 루프 구현.

두 도구 비교

claude-md-improver (skill)/revise-claude-md (command)
목적CLAUDE.md ↔ 코드베이스 정렬세션 학습 캡처
트리거코드베이스 변경 시세션 종료 시
사용 시기주기 유지보수누락 컨텍스트 발견 시

claude-md-improver — 5 단계

Phase 1 — Discovery: 저장소 모든 CLAUDE.md 탐색 (루트·local·전역·모노레포·중첩) 최대 50 개.

Phase 2 — Assessment: 6 기준 가중 평가

  1. 빌드·테스트·배포 명령
  2. 아키텍처 명확성
  3. 숨겨진 패턴
  4. 간결성 (200 줄)
  5. 현행성
  6. 실행 가능성

등급: A 90100 / B 7089 / C 5069 / D 3049 / F 0~29.

Phase 3 — Report: 점수 전에 보고서 출력 (평균·업데이트 필요 수·기준별 점수·문제점·권장). 승인 없이 변경 ❌.

Phase 4 — Updates: 실제 정보만 (명령어·비명백 패턴·테스트 접근). diff 형식 + 이유.

Phase 5 — Apply: 승인 후 Edit 적용.

/revise-claude-md — 6 단계

  1. Reflect — 누락 컨텍스트 식별
  2. Locate — CLAUDE.md · .claude.local.md 찾기
  3. Categorize — 팀 공유 vs 개인
  4. Draft — 간결한 한 줄 추가
  5. Preview — 변경 + 이유
  6. Apply — 승인 → 편집

★ 상호 보완 워크플로우

매 세션 종료     → /revise-claude-md (학습 캡처)
매 월 1 회      → claude-md-improver (감사·리팩토링)

★ Boris Cherny 의 직접 근거 — Compounding Engineering

Boris: "Anytime we see Claude do something incorrectly we add it to the CLAUDE.md, so Claude knows not to do it next time."

→ 이 수동 워크플로우 가 /revise-claude-md 로 완전 자동화.

시연 결과 — 4 파일 평균 80 점 (B)

case/claudemd-improver-demo-4files 참조. P0 = 루트 CLAUDE.md 우선.

강의 활용

  • Ch8 — 본 단원 전체 활용. 두 도구 + 5/6 단계 + 시연 + Boris 근거.
  • Ch9 §9.2 — 30 일 워크플로우의 Week 3·4.