TRENDSHIFT #8 딥다이브 · 2026-04-02 분석

everything-claude-code 딥다이브
— Claude Code를 "슈퍼 AI 개발팀"으로 업그레이드하는 올인원 시스템

Claude Code를 맨손으로 쓰는 것과, 이 시스템을 적용한 후 쓰는 것은 완전히 다른 경험입니다. everything-claude-code67개 전문 에이전트, 271개 워크플로우 스킬, 114개 규칙 파일, 훅 자동화, MCP 통합을 하나의 패키지로 제공하는 AI 에이전트 하니스 최적화 시스템입니다. 저자(Affaan Mustafa)가 10개월+ 프로덕션 사용하며 발전시킨 실전 도구입니다. (저장소: affaan-m/ECC · ⭐131k+ · MIT)
목차
  1. 프로젝트 한줄 요약
  2. 왜 주목받는가
  3. 기술 스택 전체 지도
  4. 아키텍처 심화 분석
  5. 디렉토리 구조 해부
  6. 학습 포인트 (기술별)
  7. 시스템 요구사항
  8. 직접 해볼 수 있는 실습 과제
  9. 관련 기술 심화 학습 로드맵
  10. 핵심 키워드 사전
  11. 참고 링크

1프로젝트 한줄 요약

everything-claude-code가 정확히 무엇을 하는가

everything-claude-codeClaude 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-reviewernextjs-turbopack, frontend-patterns
Python있음python-reviewerdjango-patterns, pytorch-patterns
Go있음go-reviewer, go-build-resolvergolang-testing
Java있음java-reviewer, java-build-resolverspringboot-patterns
Rust있음rust-reviewerrust-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.js18 이상
패키지 매니저npm, yarn, pnpm, bun 중 하나 (자동 감지)
OSWindows, macOS, Linux
AI IDEClaude 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 규칙의 자연어 버전
MCPModel Context Protocol. AI 모델과 외부 서비스를 연결하는 프로토콜. USB와 비슷하게 표준 방식으로 연결
토큰 (Token)AI 모델이 처리하는 텍스트의 최소 단위. 비용과 직결되므로 최적화가 중요
컨텍스트 압축컨텍스트 윈도우가 차면 덜 중요한 정보를 요약하여 공간을 확보하는 기법
DRY 어댑터 패턴하나의 설정을 여러 IDE에서 재사용하기 위한 변환 계층
AgentShieldAI 코딩 도구에 보안 규칙을 적용하는 시스템. 912개 규칙으로 취약점을 자동 감지
Selective Install필요한 모듈만 선택적으로 설치하는 아키텍처
자율 루프AI가 스스로 계획-실행-평가를 반복하며 작업을 완료하는 패턴

11참고 링크

더 깊이 파고들 자료