프로젝트 소개

claude-code-best-practice는 Anthropic의 Claude Code를 효과적으로 사용하는 방법을 안내하는 커뮤니티 큐레이션 가이드입니다. 이 프로젝트는 '바이브 코딩'에서 더 체계적인 '에이전틱 엔지니어링'으로 나아가기 위한 가교 역할을 하며, 튜토리얼보다는 실용적인 참조서 형태로 구성되어 있습니다. 저장소는 Claude Code의 핵심 확장성 개념을 테이블로 매핑하여 제공하며, 각 항목에는 베스트 프랙티스 문서와 저장소 내 구현 예제로 연결되는 링크가 포함되어 있습니다. 주요 다루는 개념은 다음과 같습니다: - 서브에이전트 (.claude/agents/) - 명령어 (.claude/commands/) - 스킬 (.claude/skills/, 공식 스킬 및 대규모 모노레포 참고 사항 포함) - 워크플로우 (날씨 오케스트레이터 명령어를 통해 시연) - 후크 (.claude/hooks/) - MCP 서버 (.mcp.json 및 설정) - 플러그인 및 마켓플레이스 - 설정, 권한, 모델 구성, 출력 스타일, 샌드박싱, 키바인딩 - 상태 줄 구성 - 메모리 (CLAUDE.md, 규칙, 자동 메모리) - 체크포인트, 세션 및 컨텍스트 윈도우 관리 - CLI 시작 플래그 및 환경 변수 또한 새로운 또는 인기 있는 기능을 추적하는 전용 섹션도 포함되어 있으며, 여기에는 ultrareview, devcontainers, 채널, 자동 모드, 파워업, 빠른 모드, 어드바이저, 컴퓨터 사용, 에이전트 SDK, 웹 기반 Claude Code, Slack 통합, 코드 리뷰, GitHub Actions, 원격 제어, 딥 링크, 동적 워크플로우, 에이전트 팀, 에이전트 뷰, 크로스 세션 메시징, 예약 작업, 루틴, 작업, 목표, 음성 입력, 번들 스킬, git worktree 등이 포함됩니다. 저장소는 Command → Agent → Skill 패턴을 기반으로 한 오케스트레이션 워크플로우도 제시하며, 구현 가이드, 아키텍처 다이어그램 및 데모 명령어(/weather-orchestrator)를 제공합니다. 마지막으로 Superpowers, Matt Pocock Skills, Everything Claude Code, Spec Kit, gstack, agent-skills, OpenSpec 등 인기 개발 워크플로우 컬렉션을 정리하여, 다양한 팀이 실제 프로젝트에서 Claude Code 에이전트, 명령어 및 스킬을 어떻게 구조화하는지 보여줍니다. 이를 통해 이 저장소는 Research → Plan → Execute → Review → Ship 패턴으로 수렴하는 다양한 접근 방식을 확인하고자 하는 개발자에게 유용한 색인 역할을 합니다.