TRENDSHIFT #8 딥다이브 · 2026-04-02 분석
everything-claude-code 딥다이브
— Claude Code를 "슈퍼 AI 개발팀"으로 업그레이드하는 올인원 시스템
Claude Code를 맨손으로 쓰는 것과, 이 시스템을 적용한 후 쓰는 것은 완전히 다른 경험입니다. everything-claude-code는 67개 전문 에이전트, 271개 워크플로우 스킬, 114개 규칙 파일, 훅 자동화, MCP 통합을 하나의 패키지로 제공하는 AI 에이전트 하니스 최적화 시스템입니다. 저자(Affaan Mustafa)가 10개월+ 프로덕션 사용하며 발전시킨 실전 도구입니다. (저장소: affaan-m/ECC · ⭐131k+ · MIT)
1프로젝트 한줄 요약
everything-claude-code가 정확히 무엇을 하는가
everything-claude-code는 Claude Code, Cursor, OpenCode, Codex 등 AI 에이전트 하니스의 성능을 극대화하는 올인원 최적화 시스템입니다. 67개 전문 에이전트, 271개 워크플로우 스킬, 114개 규칙 파일, 훅 자동화, MCP 통합을 제공합니다.
한 컷 비유
"AI 개발 도구에 '전문가 팀 카드팩'을 장착하는 것"
Claude Code 혼자 일하면 뛰어난 개발자 1명입니다. everything-claude-code를 설치하면 그 순간부터 기획자(Planner), 설계자(Architect), TDD 가이드, 보안 검토자, 코드 리뷰어가 모두 팀에 합류합니다.
단순한 프롬프트 모음이 아닙니다. 에이전트 하니스 전체를 체계적으로 최적화하는 시스템입니다. 회사에서 팀장(Planner)이 일을 받으면 각 분야 전문가에게 나눠 맡기는 것과 같은 원리입니다.
2왜 주목받는가
트렌딩 이유와 경쟁 제품 대비 장점
| 요인 | 설명 |
| 바이브코딩 대유행 | 2026년 AI 코딩이 메인스트림이 되면서, "AI를 잘 쓰는 방법"에 대한 수요 폭증 |
| 실전 검증 | 저자(Affaan Mustafa)가 10개월+ 프로덕션 사용하며 발전시킨 실전 도구 |
| 규모의 경제 | 271개 스킬, 67개 에이전트 — 혼자 만들기엔 수개월 걸릴 분량을 무료 제공 |
| 멀티 플랫폼 | Claude Code뿐 아니라 Cursor, Codex, OpenCode 등 10개+ IDE 지원 |
| 다국어 문서 | 한국어(ko-KR) 포함 12개 언어 문서 제공 — 글로벌 접근성 |
기존 방식의 문제
설정 없는 "맨손" 에이전트 사용
Claude Code를 기본 상태로 쓰면 역할 분리 없이 모든 것을 혼자 처리합니다. 언어별 코딩 컨벤션, 보안 규칙, 훅 자동화가 없어서 코드 품질이 들쑥날쑥하고, 반복 작업도 수동으로 처리해야 합니다.
everything-claude-code의 해법
계층적 위임 모델 + 규칙 자동 적용
67개 전문 에이전트가 역할에 따라 자동 라우팅됩니다. 114개 규칙 파일이 항상 적용되고, 훅 시스템이 도구 실행 전후에 자동으로 검증·포맷팅을 수행합니다. 약 180개 테스트 파일로 안정성을 보장합니다.
| 비교 대상 | everything-claude-code의 차별점 |
| Claude Code 기본 설정 | 67개 전문 에이전트 + 271개 스킬로 능력치 대폭 확장 |
| awesome-claude-code (hesreallyhim) | 단순 링크 모음 vs 실제 동작하는 시스템 |
| oh-my-codex (Yeachan-Heo) | Codex 특화 vs 10개+ IDE 크로스플랫폼 |
| obra/superpowers | 프레임워크 vs 바로 쓸 수 있는 완성형 설정 |
| 개인 CLAUDE.md | 개인 설정 vs 20개+ 언어 생태계 전체를 커버하는 체계적 규칙 |
3기술 스택 전체 지도
런타임, 지원 언어, 지원 IDE
┌─────────────────────────────────────────────┐
│ everything-claude-code │
├─────────────────────────────────────────────┤
│ Runtime: Node.js 18+ │
│ Package Manager: Yarn 4.9.2 │
│ (npm, pnpm, bun 자동 감지 지원) │
├─────────────────────────────────────────────┤
│ Dependencies: │
│ ├── @iarna/toml → TOML 파싱 │
│ ├── ajv → JSON Schema 검증 │
│ └── sql.js → SQLite (상태 저장) │
├─────────────────────────────────────────────┤
│ Dev Tools: │
│ ├── ESLint → 코드 린팅 │
│ ├── Prettier → 코드 포맷팅 │
│ ├── c8 → 코드 커버리지 (80%+) │
│ └── commitlint → 커밋 메시지 검증 │
└─────────────────────────────────────────────┘
지원 언어 생태계 (20개+)
| 언어 | 규칙 | 전용 에이전트 | 전용 스킬 예시 |
| TypeScript/JS | 있음 | typescript-reviewer | nextjs-turbopack, frontend-patterns |
| Python | 있음 | python-reviewer | django-patterns, pytorch-patterns |
| Go | 있음 | go-reviewer, go-build-resolver | golang-testing |
| Java | 있음 | java-reviewer, java-build-resolver | springboot-patterns |
| Rust | 있음 | rust-reviewer | rust-testing |
| Swift | 있음 | - | swiftui-patterns |
지원 IDE/도구 (10개+)
Claude Code (.claude/) ←── 주력
Cursor (.cursor/) ←── DRY 어댑터 패턴
OpenCode (.opencode/) ←── 31개 명령어 심
Codex (.codex/) ←── macOS + CLI
Gemini (.gemini/) ←── 신규
Trae (.trae/) ←── 신규
Kiro (.kiro/) ←── 신규
Zed (.zed/) ←── 신규
Qwen (.qwen/) ←── 신규
CodeBuddy (.codebuddy/) ←── 신규
4아키텍처 심화 분석
계층적 위임 모델과 4가지 핵심 패턴
┌──────────────────────────────────────────────────────────────┐
│ 사용자 (개발자) │
│ "기능 만들어줘" / "/plan" / "/tdd" │
└──────────────┬───────────────────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────┐
│ AI IDE (Claude Code 등) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ .claude/ │ │ .cursor/ │ │ .codex/ │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ └──────────────┼─────────────┘ │
│ ▼ │
│ ┌─────────────────────────┐ │
│ │ Rules 레이어 (114+) │ ← 항상 적용되는 규칙 │
│ │ common/ + language/ │ │
│ └────────────┬────────────┘ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ Commands (92개 슬래시) │ │
│ │ /plan /tdd /security-scan ... │ │
│ └────────────────┬────────────────────┘ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ Agents (67개 전문 에이전트) │ │
│ │ Planner · Architect · TDD · Sec │ │
│ └────────────────┬────────────────────┘ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ Skills (271개 워크플로우) │ │
│ │ backend/ frontend/ testing/ ... │ │
│ └────────────────┬────────────────────┘ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ Hooks (이벤트 자동화) │ │
│ │ PreToolUse → PostToolUse → Stop │ │
│ └────────────────┬────────────────────┘ │
│ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ MCP 서버 (32개 통합) │ │
│ │ GitHub / Supabase / Vercel / ... │ │
│ └─────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
핵심 설계 패턴
패턴 1: 계층적 위임 모델 (Hierarchical Delegation)
사용자 요청: "결제 시스템 만들어줘"
│
▼
Planner (기획) → "이 기능은 3단계로 나눠야 해"
│
├──→ Architect (설계): "DB 스키마 + API 설계"
├──→ TDD-Guide (테스트 먼저): "테스트 케이스 작성"
├──→ Security-Reviewer (보안): "결제 데이터 암호화 확인"
└──→ Code-Reviewer (최종): "코드 품질 검증"
패턴 2: 규칙의 3계층 레이어링
CSS의 specificity(구체성)와 같은 개념입니다. 더 구체적인 규칙이 일반 규칙을 덮어씁니다.
┌──────────────────────────────────┐
│ Level 3: 프로젝트 레벨 오버라이드 │ ← 가장 우선
│ (CLAUDE.md에서 직접 설정) │
├──────────────────────────────────┤
│ Level 2: 언어별 규칙 │ ← 중간 우선
│ (rules/typescript/, python/ 등) │
├──────────────────────────────────┤
│ Level 1: 공통 규칙 │ ← 기본
│ (rules/common/) │
└──────────────────────────────────┘
패턴 3: 이벤트 기반 훅 파이프라인
공항 보안검색과 비슷합니다. 비행기 타기 전(PreToolUse)에 검사하고, 도착 후(PostToolUse)에 기록합니다.
| 훅 타입 | 실행 시점 | 활용 예 |
| PreToolUse | 도구 실행 직전 | 시크릿 감지, git 보안 체크 |
| PostToolUse | 도구 실행 직후 | 자동 포맷팅, 감사 로그 |
| SessionStart | 세션 시작 | 컨텍스트 로드, 패키지 매니저 감지 |
| PreCompact | 컨텍스트 압축 전 | 세션 상태 저장 |
| Stop | 응답 종료 | 배치 포맷팅, 메모리 영속화 |
패턴 4: 토큰 최적화 전략
┌─────────────────────────────────────┐
│ 토큰 비용 최적화 전략 │
├─────────────────────────────────────┤
│ 80%+ 작업 → Sonnet (60% 저렴) │
│ 복잡한 추론 → Opus │
│ 단순 작업 → Haiku │
├─────────────────────────────────────┤
│ Extended Thinking: 10,000 토큰 제한│
│ Context 압축: 50% 용량에서 트리거 │
│ 시스템 프롬프트 슬리밍 │
└─────────────────────────────────────┘
5디렉토리 구조 해부
회사 조직도처럼 읽는 디렉토리
everything-claude-code/
├── agents/ # 67개 전문 에이전트 정의
│ ├── planner.md # 기능 분해 전문가
│ ├── architect.md # 시스템 설계자
│ ├── tdd-guide.md # TDD 가이드
│ ├── code-reviewer.md # 코드 리뷰어
│ ├── security-reviewer.md # 보안 검토자
│ ├── chief-of-staff.md # 오케스트레이터
│ └── ... (61개 더)
│
├── skills/ # 271개 워크플로우 스킬
│ ├── backend-patterns/ # RESTful API, 레이어드 아키텍처
│ ├── frontend-patterns/ # 프론트엔드 패턴
│ ├── nextjs-turbopack/ # Next.js + Turbopack
│ ├── django-patterns/ # Django 패턴
│ ├── security-scan/ # AgentShield (912 규칙)
│ └── [200+ 추가 스킬...]
│
├── rules/ # 114개 규칙 파일 / 20개 언어 디렉토리
│ ├── common/ # 공통 규칙
│ │ ├── coding-style.md
│ │ ├── git-workflow.md
│ │ └── security.md
│ └── [20개 언어별 규칙 디렉토리...]
│
├── hooks/ # 이벤트 자동화
│ └── hooks.json
│
├── commands/ # 92개 슬래시 명령어
├── mcp-configs/ # 32개 MCP 서버 설정
├── scripts/ # 설치 스크립트
│ ├── install-plan.js
│ └── install-apply.js
│
├── tests/ # 약 180개 테스트 파일
├── docs/ # 문서 (12개 언어)
│ ├── ko-KR/ # 한국어 문서
│ └── token-optimization.md
│
├── .claude/ # Claude Code 전용 설정
├── .cursor/ # Cursor 전용 설정
└── package.json + yarn.lock
디렉토리별 역할 요약
agents = 직무기술서 / skills = 업무 매뉴얼 / rules = 사내 규정집
agents/는 AI가 맡는 "직무"를 정의합니다. skills/는 특정 기술의 베스트 프랙티스입니다. rules/는 항상 지켜야 할 규칙이고, hooks/는 자동으로 실행되는 검사/작업(보안 검색대), commands/는 리모컨 버튼입니다.
6학습 포인트 (기술별)
이 레포에서 무엇을 배울 수 있는가
6-1. 에이전트 설계 패턴
AI 에이전트를 어떻게 전문화하고 협업시키는지 배울 수 있습니다. agents/planner.md 구조를 분석하면 에이전트 역할 정의 방법을 이해할 수 있습니다.
6-2. 스킬 시스템 설계
스킬은 "프롬프트의 모듈화"입니다. 거대한 하나의 프롬프트 대신, 상황에 맞는 작은 모듈을 조합합니다.
# skills/backend-patterns/SKILL.md 구조 예시
---
tags: [backend, api, architecture]
version: 1.0
when: "사용자가 API 설계를 언급하거나 백엔드 패턴을 요청할 때"
models: haiku, sonnet, opus
---
## 핵심 패턴
[RESTful API 설계, 레이어드 아키텍처, 캐싱 전략...]
## 흔한 실수
[안티 패턴 목록]
6-3. 훅(Hook) 자동화
이벤트 기반으로 AI 도구의 동작을 제어하는 방법입니다.
// hooks.json 예시
{
"hooks": [
{
"type": "PreToolUse",
"matcher": ["Bash", "Write"],
"command": "node scripts/validate-commit.js",
"timeout": 5000,
"description": "커밋 전 자동 검증"
}
]
}
6-4. 규칙 레이어링
범용 규칙과 언어별 규칙을 어떻게 체계적으로 관리하는지 배울 수 있습니다.
rules/common/coding-style.md ← "함수명은 동사로 시작" (모든 언어)
rules/python/coding-style.md ← "snake_case 사용" (Python만)
rules/typescript/coding-style.md ← "camelCase 사용" (TypeScript만)
6-5. 설치 아키텍처 (Selective Install)
SQLite로 설치 상태를 추적하여 증분 업데이트가 가능합니다. 프로필 → 모듈 → 컴포넌트의 3계층 구조로 필요한 것만 설치합니다.
6-6. 보안 통합 (AgentShield)
912개 보안 규칙, 1,282개 보안 테스트, 98% 커버리지. 시크릿 감지(pre-commit), 입력 검증 강제, 의료/무역 컴플라이언스 전용 스킬까지 내장되어 있습니다.
7시스템 요구사항
선택적 설치로 가볍게 시작 가능
| 항목 | 최소 요구사항 |
| Node.js | 18 이상 |
| 패키지 매니저 | npm, yarn, pnpm, bun 중 하나 (자동 감지) |
| OS | Windows, macOS, Linux |
| AI IDE | Claude Code, Cursor, OpenCode, Codex 중 하나 |
| 디스크 | ~100MB (전체 설치 시) |
8직접 해볼 수 있는 실습 과제
난이도별 실습
LEVEL 1 · 초급
기본 설치 및 체험 ⏱ 30분
git clone https://github.com/affaan-m/ECC.git
./install.sh typescript python
# Claude Code에서 /plan 명령어 사용
# "결제 시스템 만들어줘" → Planner 에이전트 관찰
LEVEL 2 · 중급
나만의 에이전트 만들기 ⏱ 1시간
agents/ 디렉토리의 기존 에이전트 정의 파일을 읽고, 같은 형식으로 agents/korean-reviewer.md 같은 커스텀 에이전트를 작성해보세요.
Role: 한국어 코드 리뷰 전문가 / 변수명·함수명의 한글 주석 확인 / 팀원이 이해하기 쉬운 코드인지 평가
LEVEL 3 · 중급
프로젝트 전용 훅 만들기 ⏱ 1~2시간
hooks.json에 커스텀 훅을 추가하고, 새 파일 작성 후 자동으로 조건을 검사하는 스크립트를 직접 작성해보세요.
LEVEL 4 · 고급
비즈니스 도메인 스킬 만들기 ⏱ 2~3시간
자기 업무 도메인(예: 건설 현장 관리, 교육, 이커머스 등)에 맞는 스킬을 만들어보세요. skills/{my-domain}/SKILL.md 형식으로 작성합니다.
LEVEL 5 · 고급
크로스플랫폼 설정 분석 ⏱ 3~5시간
.claude/, .cursor/, .codex/ 디렉토리의 설정 파일을 비교 분석하여, 각 IDE가 에이전트/스킬을 어떻게 다르게 처리하는지 문서화해보세요. DRY 어댑터 패턴이 어떻게 구현되었는지 이해합니다.
9관련 기술 심화 학습 로드맵
4주 학습 계획
| 주차 | 학습 내용 | 실습 |
| 1주차 | Claude Code 기본 사용법 + CLAUDE.md 작성법 + 에이전트 개념 | 내 프로젝트에 CLAUDE.md 만들기, agents/ 3개 분석 |
| 2주차 | 훅 라이프사이클 이해 + Pre/PostToolUse 실습 + 세션 관리 | 커스텀 훅 작성, 자동 포맷팅 훅, 시크릿 감지 훅 |
| 3주차 | SKILL.md 작성법 + 토큰 최적화 전략 + 모델 선택 전략 | 나만의 스킬 3개 만들기, Sonnet vs Opus 사용 분기 설계 |
| 4주차 | AgentShield 이해 + 규칙 레이어링 + 종합 프로젝트 | 3계층 규칙 적용, 나만의 everything-MY-project 만들기 |
10핵심 키워드 사전
이 레포를 이해하는 핵심 개념들
| 키워드 | 설명 |
| 에이전트 하니스 | AI 에이전트를 제어하고 최적화하는 프레임워크. Claude Code, Cursor 같은 도구가 에이전트 하니스 |
| 스킬 (Skill) | 특정 기술/도메인의 베스트 프랙티스를 담은 마크다운 모듈. AI가 상황에 맞게 참조 |
| 훅 (Hook) | 특정 이벤트에 자동으로 실행되는 스크립트. Git의 pre-commit hook과 유사한 개념 |
| 규칙 (Rule) | AI가 항상 지켜야 할 코딩 규범. ESLint 규칙의 자연어 버전 |
| MCP | Model Context Protocol. AI 모델과 외부 서비스를 연결하는 프로토콜. USB와 비슷하게 표준 방식으로 연결 |
| 토큰 (Token) | AI 모델이 처리하는 텍스트의 최소 단위. 비용과 직결되므로 최적화가 중요 |
| 컨텍스트 압축 | 컨텍스트 윈도우가 차면 덜 중요한 정보를 요약하여 공간을 확보하는 기법 |
| DRY 어댑터 패턴 | 하나의 설정을 여러 IDE에서 재사용하기 위한 변환 계층 |
| AgentShield | AI 코딩 도구에 보안 규칙을 적용하는 시스템. 912개 규칙으로 취약점을 자동 감지 |
| Selective Install | 필요한 모듈만 선택적으로 설치하는 아키텍처 |
| 자율 루프 | AI가 스스로 계획-실행-평가를 반복하며 작업을 완료하는 패턴 |
11참고 링크
더 깊이 파고들 자료