Claude Code Best Practice (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

계획 후 실행 템플릿 (더 이상 '그냥 코드를 써줘' 없음)
회귀를 잡기 위한 검증 훅 패턴
포스트모텀 및 리뷰 템플릿
리팩토링 / 마이그레이션 체크리스트
Claude Code, Codex, OpenCode 전반에서 작동

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

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

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

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

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

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

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

VS Code → Cline → MCP Servers → Edit

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

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

~/.codeium/windsurf/mcp_config.json

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

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-best-practice-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/shanraisshan/claude-code-best-practice",
        "~/.claude/skills/claude-best-practice"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-best-practice-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/shanraisshan/claude-code-best-practice",
          "~/.claude/skills/claude-best-practice"
        ]
      }
    }
  }
}

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

claude mcp add claude-best-practice-skill -- git clone https://github.com/shanraisshan/claude-code-best-practice ~/.claude/skills/claude-best-practice

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

사용 사례

실전 활용법: Claude Code Best Practice

비자명한 변경에 계획 후 실행 흐름 강제

👤 에이전트가 생각 없이 뛰어드는 것에 지친 개발자 ⏱ ~30 min intermediate

언제 쓸까: 변경이 3개 이상의 파일에 걸치거나 범위가 불명확할 때.

흐름

계획

Use claude-best-practice. Write a plan for refactoring auth: scope, sequence, risks, rollback. Do not write code yet.✓ 복사됨

→ 계획 문서; 코드 없음
비판

Critique your own plan as if you were the senior reviewer. What's missing?✓ 복사됨

→ 구체적인 수정 사항이 포함된 비판
실행

Now execute step 1 of the revised plan. Stop after that step.✓ 복사됨

→ 1단계 완료; 승인 대기

결과: 충분히 생각되어 깔끔하게 완료되는 리팩토링.

함정

계획이 너무 추상적 — 계획에서 파일 수준의 세분성을 고집

에이전트의 도움으로 인시던트 후 포스트모텀 작성

👤 온콜 / SRE ⏱ ~45 min intermediate

언제 쓸까: 문제가 발생했고 보고서를 작성해야 할 때.

흐름

수집

Use the postmortem template. Pull the timeline from /logs and recent commits.✓ 복사됨

→ 타임라인 자동 구성
5 Whys

Walk through five-whys on the root cause. Distinguish proximate from contributing.✓ 복사됨

→ 계층화된 원인
조치 항목

Generate action items with owners and due dates.✓ 복사됨

→ 검토를 위해 표시된 AI 담당자 목록

결과: 비난이 아닌 다음에 도움이 되는 포스트모텀 문서.

함정

자동 배정된 담당자가 잘못됨 — 게시 전 항상 담당자 배정 검토

함께 쓰기: filesystem

프레임워크 업그레이드에 마이그레이션 체크리스트 사용

👤 주요 업그레이드(예: React 18 → 19)를 하는 개발자 ⏱ ~60 min intermediate

언제 쓸까: 마이그레이션이 많은 파일에 걸쳐 있을 때; 단계를 놓치고 싶지 않을 때.

흐름

적용

Apply the migration template to React 18→19. Customize for our codebase.✓ 복사됨

→ 맞춤화된 체크리스트
추적

Walk through the checklist, marking done/blocked for each item.✓ 복사됨

→ 진행 로그

결과: 마이그레이션 후 'X 업데이트를 잊어버렸다'는 놀라움 없음.

함정

체크리스트가 오래됨 — 주요 버전마다 업데이트; skill이 골격을 제공

조합

다른 MCP와 조합해 10배 효율

claude-best-practice-skill + everything-claude-code-skill

두 의견적 키트 결합 — 베스트 프랙티스 프롬프팅 + 리서치 우선 기본값

claude-best-practice-skill + filesystem

코드와 함께 계획과 포스트모텀 저장

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
make_plan	task description	비자명한 변경 전	token
critique_plan	plan	계획 후, 실행 전	token
postmortem_draft	logs, commits, summary	인시던트 후	token

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 계획 단계에서 선행 비용 추가, 하지만 재작업 루프 감소
금액: 무료
팁: 정말 사소한 변경에서는 계획 단계 건너뛰기

보안

권한, 시크릿, 파급범위

최소 스코프: 포스트모텀을 위한 로그/커밋 읽기 접근

자격 증명 저장: 없음

데이터 외부 송신: 없음

문제 해결

자주 발생하는 오류와 해결

계획이 너무 일반적

구체적인 레포 컨텍스트 제공; skill이 제공한 내용에 기반

팀의 기존 프로세스와 충돌

선택적으로 적용 — 포스트모텀 템플릿만으로도 높은 가치

대안

Claude Code Best Practice 다른 것과 비교

대안	언제 쓰나	단점/장점
everything-claude-code-skill	더 완전한 번들 (메모리, 보안, 본능)이 필요할 때	더 큰 학습 표면
직접 작성한 CLAUDE.md 규칙	고도로 맞춤화된 워크플로	유지보수에 더 많은 노력

Claude Code Best Practice