/ 디렉터리 / 플레이그라운드 / Claude Code Best Practice
● 커뮤니티 shanraisshan ⚡ 바로 사용

Claude Code Best Practice

제작: shanraisshan · shanraisshan/claude-code-best-practice

즉흥적인 프롬프트에서 엔지니어링급 Claude 사용으로 이동하기 위한 실용적인 플레이북 — 계획, 검증, 훅, 포스트모텀.

claude-code-best-practice는 실제 작업에서 Claude Code를 신뢰할 수 있게 만들기 위한 큐레이션된 실천 사항과 템플릿 모음입니다. 계획 후 실행 프롬프팅, 검증 훅 패턴, 포스트모텀 형식, 리팩토링 체크리스트. '마법 자동 skill'이라기보다 규율 패키지에 가깝습니다 — 선택 사항을 적용하고, 단계를 따르고, 출력을 신뢰하세요.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

준비됨

설치

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

사용 사례

실전 활용법: Claude Code Best Practice

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

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

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

흐름
  1. 계획
    Use claude-best-practice. Write a plan for refactoring auth: scope, sequence, risks, rollback. Do not write code yet.✓ 복사됨
    → 계획 문서; 코드 없음
  2. 비판
    Critique your own plan as if you were the senior reviewer. What's missing?✓ 복사됨
    → 구체적인 수정 사항이 포함된 비판
  3. 실행
    Now execute step 1 of the revised plan. Stop after that step.✓ 복사됨
    → 1단계 완료; 승인 대기

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

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

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

👤 온콜 / SRE ⏱ ~45 min intermediate

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

흐름
  1. 수집
    Use the postmortem template. Pull the timeline from /logs and recent commits.✓ 복사됨
    → 타임라인 자동 구성
  2. 5 Whys
    Walk through five-whys on the root cause. Distinguish proximate from contributing.✓ 복사됨
    → 계층화된 원인
  3. 조치 항목
    Generate action items with owners and due dates.✓ 복사됨
    → 검토를 위해 표시된 AI 담당자 목록

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

함정
  • 자동 배정된 담당자가 잘못됨 — 게시 전 항상 담당자 배정 검토
함께 쓰기: filesystem

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

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

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

흐름
  1. 적용
    Apply the migration template to React 18→19. Customize for our codebase.✓ 복사됨
    → 맞춤화된 체크리스트
  2. 추적
    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 규칙고도로 맞춤화된 워크플로유지보수에 더 많은 노력

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기