50K+ stars|6K+ forks|30 contributors|6개 언어 지원|Anthropic 해커톤 우승작

AI 에이전트 (Agent) 프레임워크를 위한 성능 최적화 시스템. Anthropic 해커톤 우승 작품에서 유래되었습니다.

이것은 단순한 설정 파일이 아닙니다. 기술 (Skills), 본능 (Instincts), 메모리 최적화, 지속적 학습, 보안 스캔 및 연구 우선 개발 모드를 포함하는 완전한 시스템입니다. 이러한 프로덕션급 에이전트 (Agents), 훅 (Hooks), 명령 (Commands), 규칙 (Rules) 및 MCP 설정은 실제 제품을 구축하는 10개월 이상의 고강도 일상 사용을 통해 진화되었습니다.

Claude Code, Codex, Cowork 및 기타 AI 에이전트 프레임워크에 적합합니다.

본 저장소는 원본 코드만 포함합니다. 가이드 섹션에서 모든 세부 사항을 설명합니다.

|
|
간략 가이드 (Shorthand Guide) 설정, 기초 지식, 철학. 이 글을 먼저 읽어주세요. |
상세 가이드 (Longform Guide) 토큰 (Token) 최적화, 메모리 지속화, 평가 (Evals), 병렬화. |

주제	배우게 될 내용
토큰 (Token) 최적화	모델 선택, 시스템 프롬프트 경량화, 백그라운드 프로세스
...
Codex 애플리케이션 + CLI 지원— AGENTS.md를 기반으로 하는 Codex를 직접 지원합니다.

설치기 타겟팅 및 Codex 문서— 의존성 없는 HTML 프레젠테이션 생성기이며, PPTX 변환 가이드와 엄격한 뷰포트 적응 규칙이 포함된 frontend-slides를 포함합니다.

기술 (Skill) 5가지 새로운 범용 비즈니스/콘텐츠 기술— article-writing (기사 작성), content-engine (콘텐츠 엔진), market-research (시장 조사), investor-materials (투자 자료), investor-outreach (투자자 발굴)

더 넓은 도구 커버리지— Cursor, Codex 및 OpenCode 지원을 강화하여 동일한 저장소가 모든 주요 프레임워크에서 원활하게 작동할 수 있도록 합니다.

992개 내부 테스트— 플러그인, 훅 (Hooks), 기술 (Skills) 및 패키징의 검증 및 회귀 테스트 커버리지를 확장했습니다.

Codex CLI 지원— OpenAI Codex CLI와 호환되는 codex.md를 생성하기 위한 /codex-setup 명령을 추가했습니다.

7가지 새로운 기술— search-first, swift-actor-persistence, swift-protocol-di-testing, regex-vs-llm-structured-text, content-hash-cache-pattern, cost-aware-llm-pipeline, skill-stocktake

AgentShield 통합— /security-scan 기술을 통해 Claude Code에서 직접 AgentShield를 실행할 수 있습니다. 1282개의 테스트와 102개의 규칙을 포함합니다.

GitHub 마켓플레이스 (Marketplace)— ECC Tools GitHub 앱이 github.com/marketplace/ecc-tools 에 출시되었으며, 무료/프로/엔터프라이즈 버전을 제공합니다.

30개 이상의 커뮤니티 PR 병합— 6개 언어의 30명 기여자의 기여를 반영했습니다.

978개 내부 테스트— 에이전트, 기술, 명령, 훅 및 규칙을 아우르는 검증 스위트를 확장했습니다.

본능 (Instinct) 임포트 시 내용 유실 문제 수정— /instinct-import 실행 시 parse_instinct_file()이 Frontmatter 이후의 모든 내용(Action, Evidence, Examples 부분)을 조용히 삭제하던 문제를 커뮤니티 기여자 @ericcai0814가 수정했습니다 (#148, #161).

대화형 설치 마법사— 병합/덮어쓰기 감지 기능이 있는 가이드형 설정을 제공하는 configure-ecc 기술을 추가했습니다.

PM2 및 멀티 에이전트 오케스트레이션— 복잡한 멀티 서비스 워크플로우를 관리하기 위한 6개의 새로운 명령(/pm2, /multi-plan, /multi-execute, /multi-backend, /multi-frontend, /multi-workflow)을 추가했습니다.

다국어 규칙 아키텍처— 규칙을 평면 파일에서 common/ + typescript/ + python/ + golang/ 구조로 리팩토링했습니다.

목차. 필요한 언어만 설치하세요.

중국어 (zh-CN) 번역— 모든 에이전트(Agents), 명령(Commands), 스킬(Skills) 및 규칙(Rules)(80개 이상의 파일)에 대한 전체 번역을 완료했습니다.
GitHub Sponsors 지원— GitHub Sponsors를 통해 이 프로젝트를 후원할 수 있습니다.
강화된 CONTRIBUTING.md— 각 기여 유형에 대한 상세한 PR 템플릿을 제공합니다.

OpenCode 완전 통합— 12개의 에이전트, 24개의 명령, 16개의 스킬이 OpenCode의 플러그인 시스템(20개 이상의 이벤트 유형)을 통해 훅(Hooks)을 지원합니다.
3개의 네이티브 커스텀 도구— run-tests(테스트 실행), check-coverage(커버리지 확인), security-audit(보안 감사)
LLM 문서— 전체 OpenCode 문서를 확인하려면 llms.txt를 참조하세요.

Python/Django 지원— Django 모드, 보안, TDD 및 검증 스킬
Java Spring Boot 스킬— Spring Boot의 모드, 보안, TDD 및 검증
세션 관리— 세션 기록을 확인하기 위한 /sessions 명령
지속적 학습 (Continuous Learning) v2— 본능(Instincts) 기반의 신뢰 점수(Confidence Score), 가져오기/내보내기, 진화하는 학습 시스템

Releases에서 전체 변경 로그를 확인하세요.

2분 안에 시작하고 실행하기:

# 마켓플레이스 추가
/plugin marketplace add affaan-m/everything-claude-code
# 플러그인 설치
...

⚠️ 중요 알림: Claude Code 플러그인은 rules(규칙)를 자동으로 배포할 수 없습니다.

수동으로 설치해 주세요:

# 먼저 저장소를 클론합니다
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
...

수동 설치에 대한 설명은 rules/ 폴더의 README를 참조하세요.

# 명령 실행 테스트 (플러그인 설치 시 네임스페이스 형식 사용)
/everything-claude-code:plan "사용자 인증 추가"
# 수동 설치 (옵션 2) 시 짧은 형식 사용:
...

✨ 완료! 이제 13개의 에이전트(Agents), 56개의 스킬(Skills), 32개의 명령(Commands)을 사용할 수 있습니다.

이 플러그인은 이제 Windows, macOS 및 Linux를 완전히 지원합니다. 모든 훅(Hooks)과 스크립트는 최대 호환성을 위해 Node.js로 재작성되었습니다.

플러그인은 사용자가 선호하는 패키지 매니저(npm, pnpm, yarn 또는 bun)를 자동으로 감지하며, 우선순위는 다음과 같습니다:

환경 변수: CLAUDE_PACKAGE_MANAGER
프로젝트 설정: .claude/package-manager.json
package.json: packageManager 필드
잠금 파일 (Lockfile): package-lock.json, yarn.lock, pnpm-lock.yaml 또는 bun.lockb에서 감지
전역 설정: ~/.claude/package-manager.json
대안: 사용 가능한 첫 번째 패키지 매니저

선호하는 패키지 매니저를 설정하려면:

# 환경 변수를 통해 설정
export CLAUDE_PACKAGE_MANAGER=pnpm
# 전역 설정을 통해 설정
...

또는 Claude Code에서 /setup-pm 명령을 사용하세요.

이 저장소는 Claude Code 플러그인입니다. 직접 설치하거나 구성 요소를 수동으로 복사할 수 있습니다.

everything-claude-code/
|-- .claude-plugin/ # 플러그인 및 마켓플레이스 매니페스트 파일
| |-- plugin.json # 플러그인 메타데이터 및 구성 요소 경로
...

저장소에서 Claude Code 스킬(Skills)을 생성하는 두 가지 방법이 있습니다:

외부 서비스 없이 로컬 분석을 수행하는 /skill-create 명령 사용:

/skill-create # 현재 저장소 분석
/skill-create --instincts # 지속적 학습을 위한 본능(instincts)을 동시에 생성

이렇게 하면 로컬에서 git 히스토리를 분석하여 SKILL.md 파일을 생성합니다.

고급 기능(10k+ 커밋, 자동 PR, 팀 공유)에 적합한 방식:

# 모든 issue 아래에 댓글로 남기기:
/skill-creator analyze
# 또는 기본 브랜치로 푸시할 때 자동으로 트리거

두 옵션 모두 다음을 생성합니다:

SKILL.md 파일

• Claude Code에서 즉시 사용할 수 있는 스킬 (Skills)

본능 컬렉션 (Instinct collections)

• continuous-learning-v2에 적용 가능

패턴 추출 (Pattern extraction)

• 사용자의 커밋 히스토리로부터 학습

Claude Code 해커톤(Cerebral Valley x Anthropic, 2026년 2월)에서 구축되었습니다. 1,282개의 테스트, 98%의 커버리지, 102개의 정적 분석 (Static analysis) 규칙을 포함합니다.

Claude Code 설정에 취약점, 잘못된 구성 및 인젝션 (Injection) 위험이 있는지 스캔합니다.

# 빠른 스캔 (설치 불필요)
npx ecc-agentshield scan
# 보안 문제 자동 수정
...

스캔 범위: CLAUDE.md, settings.json, MCP 설정, 훅 (Hooks), 에이전트 (Agent) 정의 및 5가지 카테고리의 스킬 —— 키 탐지(14가지 패턴), 권한 감사 (Permission audit), 훅 인젝션 분석, MCP 서버 위험 분석 및 에이전트 구성 검토.

--opus 플래그는 레드팀 (Red team)/블루팀 (Blue team)/감사관 (Auditor) 파이프라인에서 세 개의 Claude Opus 4.6 에이전트를 실행합니다. 공격자는 공격 체인 (Attack chain)을 찾고, 방어자는 방어 조치를 평가하며, 감사관은 이 둘을 통합하여 우선순위가 지정된 위험 평가를 수행합니다. 이는 단순한 패턴 매칭이 아닌 대립적 추론 (Adversarial reasoning)입니다.

출력 형식: 터미널 (색상 등급 A-F), JSON (CI 파이프라인), Markdown, HTML. 심각한 문제가 발견되면 종료 코드(Exit code) 2를 반환하여 빌드 게이트 (Build gate)로 사용됩니다.

Claude Code에서 /security-scan을 실행하거나, GitHub Action을 통해 CI에 추가하세요.

Plankton(감사: @alxfazio)은 권장되는 코드 작성 시 품질 강제 실행 파트너입니다. 이는 PostToolUse 훅을 통해 매 파일 편집 시 포맷터 (Formatter)와 20개 이상의 린터 (Linter)를 실행한 후, Claude 서브 프로세스(위반 복잡도에 따라 Haiku/Sonnet/Opus로 라우팅됨)를 생성하여 메인 에이전트가 놓친 문제를 수정합니다. 3단계 아키텍처: 무음 자동 포맷팅 (문제의 40-50% 해결), 나머지 위반 사항을 구조화된 JSON으로 수집, 수정 작업을 서브 프로세스에 위임. 에이전트가 검사를 통과하기 위해 린터 설정을 수정하는 것을 방지하는 구성 보호 훅을 포함합니다. Python, TypeScript, Shell, YAML, JSON, TOML, Markdown 및 Dockerfile을 지원합니다. AgentShield와 함께 사용하면 보안과 품질을 모두 커버할 수 있습니다. 전체 통합 가이드는 skills/plankton-code-quality/를 참조하세요.

본능 기반의 학습 시스템은 사용자의 패턴을 자동으로 학습합니다:

/instinct-status # 학습된 본능 및 신뢰도 표시
/instinct-import <file> # 타인의 본능 가져오기
/instinct-export # 공유를 위해 자신의 본능 내보내기
...

전체 문서는 skills/continuous-learning-v2/를 참조하세요.

최소 버전: v2.1.0 이상

플러그인 시스템의 훅 (Hooks) 처리 방식 변경으로 인해, 이 플러그인은 Claude Code CLI v2.1.0 이상이 필요합니다.

버전 확인:
claude --version

⚠️ 기여자 주의 사항: .claude-plugin/plugin.json에 `

주의: Claude Code 플러그인 시스템은 현재 플러그인을 통해 rules (규칙)를 배포하는 것을 지원하지 않습니다.

(규칙) (업스트림 제한). 규칙을 수동으로 설치해야 합니다:

먼저 저장소를 클론합니다

git clone https://github.com/affaan-m/everything-claude-code.git

옵션 A: 사용자 레벨 규칙 (모든 프로젝트에 적용)

mkdir -p ~/.claude/rules
cp -r everything-claude-code/rules/common/* ~/.claude/rules/
cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/

기술 스택을 선택하세요

cp -r everything-claude-code/rules/python/* ~/.claude/rules/
cp -r everything-claude-code/rules/golang/* ~/.claude/rules/

옵션 B: 프로젝트 레벨 규칙 (현재 프로젝트에만 적용)

mkdir -p .claude/rules
cp -r everything-claude-code/rules/common/* .claude/rules/
cp -r everything-claude-code/rules/typescript/* .claude/rules/

기술 스택을 선택하세요

설치 내용을 수동으로 제어하는 것을 선호한다면:

# 저장소 클론
git clone https://github.com/affaan-m/everything-claude-code.git
# 에이전트(Agent)를 Claude 설정 디렉토리로 복사
...

hooks/hooks.json에 있는 훅(Hooks)을 ~/.claude/settings.json으로 복사하세요.

mcp-configs/mcp-servers.json에 있는 필요한 MCP 서버들을 ~/.claude.json으로 복사하세요.

중요 알림: YOUR_*_HERE 플레이스홀더를 실제 API 키로 교체해 주세요.

서브 에이전트 (Subagents)는 범위가 제한된 위임 작업을 처리합니다. 예시:

---
name: code-reviewer
description: 코드의 품질, 보안성 및 유지보수성을 검토합니다
...

스킬 (Skills)은 명령 또는 에이전트에 의해 호출되는 워크플로우 (Workflow) 정의입니다:

# TDD 워크플로우
1. 먼저 인터페이스를 정의합니다
2. 실패하는 테스트를 작성합니다 (RED)
...

훅 (Hooks)은 도구 이벤트 (Tool events)에서 트리거됩니다. 예시 — console.log 경고:

{
"matcher": "tool == \"Edit\" && tool_input.file_path matches \\\\.(ts|tsx|js|jsx)$\","
"hooks": [{
...

규칙 (Rules)은 반드시 준수해야 하는 지침이며, common/ (언어 무관) + 특정 언어 디렉토리에 조직되어 있습니다:

rules/
common/ # 일반 원칙 (항상 설치)
typescript/ # TS/JS 특정 패턴 및 도구
...

설치 및 구조에 대한 자세한 내용은 rules/README.md를 참조하세요.

어디서부터 시작해야 할지 모르겠다면, 이 빠른 가이드를 참조하세요:

내가 하고 싶은 것...	사용할 명령	사용하는 에이전트 (Agent)
새로운 기능 계획	/everything-claude-code:plan "인증 추가"	planner
시스템 아키텍처 설계	/everything-claude-code:plan + architect 에이전트	architect
테스트를 먼저 작성하고 코드 작성	/tdd	tdd-guide
방금 작성한 코드 리뷰	/code-review	code-reviewer
빌드 실패 수정	/build-fix	build-error-resolver
엔드 투 엔드 (E2E) 테스트 실행	/e2e	e2e-runner
보안 취약점 찾기	/security-scan	security-reviewer
폐기된 코드 제거	/refactor-clean	refactor-cleaner
문서 업데이트	/update-docs	doc-updater
Go 코드 리뷰	/go-review	go-reviewer
Python 코드 리뷰	/python-review	python-reviewer
데이터베이스 쿼리 감사	(자동 위임)	database-reviewer

새로운 기능 시작하기:

/everything-claude-code:plan "OAuth를 사용하여 사용자 인증 추가"
→ planner가 구현 청사진(blueprint) 생성
/tdd → tdd-guide가 테스트 우선 작성을 강제함
...

버그 수정하기:

/tdd → tdd-guide: 문제를 재현하는 실패하는 테스트 작성
→ 수정을 구현하고 테스트 통과 확인
/code-review → code-reviewer: 회귀(regression) 문제 포착

프로덕션 배포 준비하기:

/security-scan → security-reviewer: OWASP Top 10 감사
/e2e → e2e-runner: 핵심 사용자 흐름 테스트
/test-coverage → 80% 이상의 커버리지 확인

어떤 에이전트/명령어가 설치되어 있는지 확인하려면 어떻게 하나요?

/plugin list everything-claude-code@everything-claude-code

이 명령은 플러그인에서 사용 가능한 모든 에이전트, 명령어 및 기술(skills)을 보여줍니다.

내 훅 (Hooks)이 작동하지 않아요 / "Duplicate hooks file" 오류가 보여요

이는 가장 흔한 문제입니다. .claude-plugin/plugin.json 파일에 "hooks" 필드를 추가하지 마세요. Claude Code v2.1+ 버전은 설치된 플러그인으로부터 hooks/hooks.json을 자동으로 로드합니다. 명시적으로 선언하면 중복 감지 오류가 발생합니다. #29, #52, #103을 참조하세요.

내 컨텍스트 창(Context Window)이 줄어들고 있어요 / Claude가 컨텍스트를 다 써버렸어요

너무 많은 MCP 서버는 컨텍스트를 소모합니다. 각 MCP 도구 설명은 200k의 컨텍스트 창에서 토큰을 소모하며, 이로 인해 창이 ~70k까지 줄어들 수 있습니다.

해결 방법: 프로젝트별로 사용하지 않는 MCP를 비활성화하세요:

// 프로젝트의 .claude/settings.json 에서
{
"disabledMcpServers": ["supabase", "railway", "vercel"]
...
}

활성화된 MCP는 10개 미만, 활성 도구는 80개 미만으로 유지하는 것이 좋습니다.

일부 구성 요소만 사용할 수 있나요 (예: 에이전트만 사용)?

네, 가능합니다. 옵션 2(수동 설치)를 사용하여 필요한 부분만 복사하세요:

# 에이전트만 복사
cp everything-claude-code/agents/*.md ~/.claude/agents/
# 규칙만 복사
...

각 구성 요소는 완전히 독립적입니다.

이것이 Cursor / OpenCode / Codex에도 적용되나요?

네, ECC는 크로스 플랫폼을 지원합니다:

Cursor: 사전 번역된 설정은 .cursor/에 위치합니다. Cursor IDE 지원을 참조하세요.
OpenCode: 전체 플러그인 지원은 .opencode/에 위치합니다. OpenCode 지원을 참조하세요.
Codex: 어댑터 오프셋 보호(adapter offset protection) 및 SessionStart 다운그레이드를 갖춘 일류 지원을 제공합니다. PR #257을 참조하세요.
Claude Code: 네이티브 지원 — 이것이 주요 목표입니다.

새로운 기술(Skill)이나 에이전트를 기여하려면 어떻게 하나요?

CONTRIBUTING.md를 참조하세요. 요약하자면:

• 본 저장소를 Fork 하세요.
• skills/your-skill-name/SKILL.md (YAML Frontmatter 포함)에서 기술 (Skill)을 생성하거나, agents/your-agent.md에서 에이전트 (Agent)를 생성한 후, 기능 및 사용 사례를 명확히 설명하여 PR을 제출하세요.

플러그인은 포괄적인 테스트 스위트 (Test Suite)를 포함하고 있습니다:

# 모든 테스트 실행
node tests/run-all.js
# 단일 테스트 파일 실행
...

모든 종류의 기여를 환영하며 권장합니다.

본 저장소는 커뮤니티 리소스가 되는 것을 목표로 합니다. 만약 다음과 같은 것이 있다면 기여해 주세요:

• 유용한 에이전트 (Agents) 또는 기술 (Skills)
• 정교한 훅 (Hooks)
• 더 나은 MCP 설정
• 개선된 규칙 (Rules)

가이드라인은 CONTRIBUTING.md를 참조하세요.

• 특정 언어 기술 (Rust, C#, Swift, Kotlin) — Go, Python, Java는 이미 포함됨
• 특정 프레임워크 설정 (Rails, Laravel, FastAPI, NestJS) — Django, Spring Boot는 이미 포함됨
• DevOps 에이전트 (Kubernetes, Terraform, AWS, Docker)
• 테스트 전략 (다양한 프레임워크, 시각적 회귀 테스트)
• 특정 도메인 지식 (머신러닝 (Machine Learning), 데이터 엔지니어링 (Data Engineering), 모바일)

ECC는 Cursor IDE에 대한 완전한 지원을 제공하며, Cursor의 네이티브 형식에 맞춘 훅 (Hooks), 규칙 (Rules), 에이전트 (Agents), 기술 (Skills), 명령 (Commands) 및 MCP 설정을 포함합니다.

# 사용 언어 설치
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift

구성 요소	수량	상세 내용
훅 이벤트 (Hook Events)	15	sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt 및 기타 10개
...

Cursor가 보유한 훅 이벤트 (Hook Events)는 Claude Code보다 더 많습니다 (20개 vs 8개). .cursor/hooks/adapter.js 모듈은 Cursor의 stdin JSON을 Claude Code 형식으로 변환하여, 기존의 scripts/hooks/*.js를 중복 없이 재사용할 수 있게 합니다.

Cursor stdin JSON → adapter.js → 변환 → scripts/hooks/*.js
(Claude Code와 공유)

주요 훅 (Hooks):

beforeShellExecution — tmux 이외의 개발 서버 실행 차단 (exit 2), git push 검토
afterFileEdit — 자동 포맷팅 + TypeScript 체크 + console.log 경고
beforeSubmitPrompt — 프롬프트 내 키(Key) 감지 (sk-, ghp_, AKIA 등의 패턴)
beforeTabFileRead — Tab 읽기 시 .env, .key, .pem 파일 차단 (exit 2)
beforeMCPExecution / afterMCPExecution — MCP 감사 로그 (Audit Log) 기록

Cursor 규칙 (Rules)은 description, globs, alwaysApply를 포함하는 YAML Frontmatter를 사용합니다:

---
description: "범용 규칙을 확장하는 TypeScript 코딩 스타일"
globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
...

ECC는 최상급의 Codex CLI 지원을 제공하며, 참조 설정, Codex 전용 AGENTS.md 보충 및 16개의 이식된 기술을 포함합니다.

# 참조 설정을 사용자 디렉토리로 복사
cp .codex/config.toml ~/.codex/config.toml
# 저장소에서 Codex 실행 — AGENTS.md를 자동으로 감지함
...

구성 요소	수량	상세 내용
설정 (Config)	1	.codex/config.toml — 모델, 권한, MCP 서버, 영구적 지시사항
...

.agents/skills/ 아래의 기술 (Skills)은 Codex에 의해 자동으로 로드됩니다:

기술 (Skills)	설명
tdd-workflow	80% 이상의 커버리지를 가진 테스트 주도 개발 (TDD)
...

Codex CLI는 현재 훅 (Hooks)을 지원하지 않습니다 (OpenAI Codex Issue #2109, 430+ 찬성). 보안 강제 실행은 config.toml 내의 persistent_instructions 및 지시사항(instructions)을 기반으로 구현된 샌드박스 권한 시스템을 통해 이루어집니다.

ECC는 플러그인과 훅 (Hooks)을 포함하여 완전한 OpenCode 지원을 제공합니다.

# OpenCode 설치
npm install -g opencode
# 저장소 루트 디렉토리에서 실행
...

설정은 .opencode/opencode.json에서 자동으로 감지됩니다.

기능	Claude Code	OpenCode	상태
에이전트 (Agents)	✅ 13개	✅ 12개	Claude Code 우세
...

OpenCode의 플러그인 시스템은 Claude Code보다 더 복잡하며, 20가지 이상의 이벤트 유형을 보유하고 있습니다:

Claude Code 훅 (Hooks)	OpenCode 플러그인 이벤트
PreToolUse	tool.execute.before
...

추가적인 OpenCode 이벤트: file.edited, file.watcher.updated, message.updated, lsp.client.diagnostics, tui.toast.show 등.