Web Analytics

everything-claude-code

⭐ 174096 stars Korean by affaan-m

Language: English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe

Everything Claude Code

Everything Claude Code — the performance system for AI agent harnesses

Stars Forks Contributors npm ecc-universal npm ecc-agentshield GitHub App Install License Shell TypeScript Python Go Java Perl Markdown

140K+ stars | 21K+ forks | 170+ contributors | 12+ language ecosystems | Anthropic Hackathon Winner


Language / 语言 / 語言 / Dil

English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe


The performance optimization system for AI agent harnesses. From an Anthropic hackathon winner.

Not just configs. A complete system: skills, instincts, memory optimization, continuous learning, security scanning, and research-first development. Production-ready agents, skills, hooks, rules, MCP configurations, and legacy command shims evolved over 10+ months of intensive daily use building real products.

Claude Code, Codex, Cursor, OpenCode, Gemini 및 기타 AI 에이전트 하니스 전반에서 작동합니다.

ECC v2.0.0-rc.1은 재사용 가능한 계층 위에 공개 Hermes 운영자 스토리를 추가합니다: Hermes 설치 가이드로 시작한 다음, rc.1 릴리스 노트크로스 하니스 아키텍처를 검토하세요.


가이드

이 저장소는 원시 코드만 포함합니다. 가이드가 모든 것을 설명합니다.

The Shorthand Guide to Everything Claude Code The Longform Guide to Everything Claude Code The Shorthand Guide to Everything Agentic Security
간략 가이드
설정, 기초, 철학. 먼저 읽으세요.
상세 가이드
토큰 최적화, 메모리 지속성, 평가, 병렬 처리.
보안 가이드
공격 벡터, 샌드박싱, 정화, CVE, AgentShield.

| 주제 | 배우게 될 내용 | |-------|-------------------| | 토큰 최적화 | 모델 선택, 시스템 프롬프트 슬리밍, 백그라운드 프로세스 | | 메모리 지속성 | 세션 간 컨텍스트를 자동으로 저장/불러오는 훅 | | 지속적 학습 | 세션에서 패턴을 자동 추출하여 재사용 가능한 스킬로 변환 | | 검증 루프 | 체크포인트 대 연속 평가, 채점기 유형, pass@k 메트릭 | | 병렬화 | Git 작업 트리, 캐스케이드 방법, 인스턴스 확장 시점 | | 서브에이전트 오케스트레이션 | 컨텍스트 문제, 반복적 검색 패턴 |


새로운 소식

v2.0.0-rc.1 — 인터페이스 리프레시, 운영자 워크플로우, ECC 2.0 알파 (2026년 4월)

v1.9.0 — 선택적 설치 및 언어 확장 (2026년 3월)

v1.8.0 — 하니스 성능 시스템 (2026년 3월)

v1.7.0 — 크로스플랫폼 확장 및 프레젠테이션 빌더 (2026년 2월)

v1.6.0 — Codex CLI, AgentShield 및 마켓플레이스 (2026년 2월)

v1.4.1 — 버그 수정 (2026년 2월)

v1.4.0 — 다국어 규칙, 설치 마법사 및 PM2 (2026년 2월)

v1.3.0 — OpenCode 플러그인 지원 (2026년 2월)

v1.2.0 — 통합 명령어 및 스킬 (2026년 2월)

전체 변경 로그는 릴리즈에서 확인하세요.

---

빠른 시작

2분 이내에 시작하기:

한 경로만 선택하세요

대부분의 Claude Code 사용자는 정확히 한 가지 설치 경로를 사용해야 합니다:

이미 여러 설치를 겹쳐서 복제된 항목이 보인다면, 바로 ECC 재설정 / 제거로 이동하세요.

저컨텍스트 / 후크 없는 경로

후크가 너무 전역적이라고 느껴지거나 ECC의 규칙, 에이전트, 명령어 및 핵심 워크플로우 기능만 원한다면, 플러그인을 건너뛰고 최소 수동 프로파일을 사용하세요:

./install.sh --profile minimal --target claude

.\install.ps1 --profile minimal --target claude

or

npx ecc-install --profile minimal --target claude
이 프로필은 의도적으로 hooks-runtime을 제외합니다.

일반 코어 프로필을 원하지만 훅을 사용하지 않으려면 다음을 사용하세요:

./install.sh --profile core --without baseline:hooks --target claude

나중에 훅을 추가하려면 런타임 강제가 필요한 경우에만 추가하세요:

./install.sh --target claude --modules hooks-runtime

먼저 올바른 구성 요소 찾기

설치할 ECC 프로필이나 구성 요소를 잘 모를 경우, 모든 프로젝트에서 패키지된 어드바이저에게 문의하세요:

npx ecc consult "security reviews" --target claude
일치하는 구성 요소, 관련 프로필, 미리 보기/설치 명령을 반환합니다. 정확한 파일 계획을 확인하려면 설치하기 전에 미리 보기 명령을 사용하세요.

1단계: 플러그인 설치 (권장)

참고: 플러그인은 편리하지만, Claude Code 빌드가 자체 호스팅 마켓플레이스 항목을 해결하는 데 문제가 있을 경우 아래 OSS 설치 관리자가 여전히 가장 신뢰할 수 있는 경로입니다.

# Add marketplace
/plugin marketplace add https://github.com/affaan-m/everything-claude-code

Install plugin

/plugin install everything-claude-code@everything-claude-code

명명 규칙 + 마이그레이션 노트

ECC에는 이제 세 가지 공개 식별자가 있으며, 이들은 서로 교환할 수 없습니다:

이는 의도된 것입니다. Anthropic 마켓플레이스/플러그인 설치는 정식 플러그인 식별자를 기준으로 하므로 ECC는 everything-claude-code@everything-claude-code로 표준화하여 목록 이름, /plugin install, /plugin list, 그리고 저장소 문서를 하나의 공개 설치 인터페이스로 맞추었습니다. 이전 게시물에는 여전히 구식 약칭이 보일 수 있는데, 그 약칭은 더 이상 사용되지 않습니다. 별도로, npm 패키지는 ecc-universal을 유지하여 npm 설치와 마켓플레이스 설치가 의도적으로 다른 이름을 사용합니다.

2단계: 규칙 설치 (필수)

경고: 중요: Claude Code 플러그인은 rules를 자동으로 배포할 수 없습니다.
>
이미 /plugin install로 ECC를 설치한 경우, ./install.sh --profile full, .\install.ps1 --profile full, 또는 npx ecc-install --profile full을 실행하지 마십시오. 플러그인은 이미 ECC 스킬, 명령어, 후크를 로드합니다. 플러그인 설치 후 전체 설치 프로그램을 실행하면 동일한 내용을 사용자 디렉터리에 복사하여 스킬과 런타임 동작이 중복될 수 있습니다.
>
플러그인 설치 시에는 ~/.claude/rules/ecc/ 아래에 원하는 rules/ 디렉터리만 수동으로 복사하십시오. rules/common과 실제로 사용하는 하나의 언어 또는 프레임워크 팩부터 시작하십시오. 모든 규칙 디렉터리를 복사하지 마십시오. Claude에 해당 모든 컨텍스트를 명시적으로 원하지 않는 한 복사하지 마십시오.
>
전체 설치 프로그램은 플러그인 경로 대신 완전 수동 ECC 설치를 할 때만 사용하십시오.
>
로컬 Claude 설정이 초기화되거나 재설정되었다고 해서 ECC를 다시 구매할 필요는 없습니다. 먼저 node scripts/ecc.js list-installed를 실행한 후 node scripts/ecc.js doctornode scripts/ecc.js repair를 실행하고 재설치하십시오. 보통 이 과정만으로 ECC 관리 파일이 복구되며 설정을 다시 하지 않아도 됩니다. 문제가 ECC 도구에 대한 계정 또는 마켓플레이스 접근 권한이라면, 결제/계정 복구를 별도로 처리하십시오.

# Clone the repo first
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

Install dependencies (pick your package manager)

npm install # or: pnpm install | yarn install | bun install

Plugin install path: copy only ECC rules into an ECC-owned namespace

mkdir -p ~/.claude/rules/ecc cp -R rules/common ~/.claude/rules/ecc/ cp -R rules/typescript ~/.claude/rules/ecc/

Fully manual ECC install path (use this instead of /plugin install)

./install.sh --profile full

# Windows PowerShell

Plugin install path: copy only ECC rules into an ECC-owned namespace

New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules/ecc" | Out-Null Copy-Item -Recurse rules/common "$HOME/.claude/rules/ecc/" Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/ecc/"

Fully manual ECC install path (use this instead of /plugin install)

.\install.ps1 --profile full

npx ecc-install --profile full

수동 설치 지침은 rules/ 폴더 내 README를 참조하십시오. 규칙을 수동으로 복사할 때는 내부 파일이 아닌 전체 언어 디렉토리(예: rules/common 또는 rules/golang)를 복사하여 상대 참조가 계속 작동하고 파일 이름 충돌이 발생하지 않도록 하십시오.

완전 수동 설치 (대체 방법)

플러그인 경로를 의도적으로 건너뛸 경우에만 이것을 사용하십시오:

./install.sh --profile full

.\install.ps1 --profile full

or

npx ecc-install --profile full
이 경로를 선택했다면, 거기서 멈추세요. /plugin install도 실행하지 마십시오.

ECC 재설정 / 제거

ECC가 중복되거나, 방해가 되거나, 작동하지 않는 것 같으면, 계속해서 다시 설치하지 마십시오.

node scripts/uninstall.js --dry-run

그런 다음 ECC 관리 파일을 제거하십시오:

node scripts/uninstall.js
라이프사이클 래퍼를 사용할 수도 있습니다:

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run
ECC는 설치 상태에 기록된 파일만 제거합니다. 설치하지 않은 관련 없는 파일은 삭제하지 않습니다.

메서드를 중첩한 경우, 다음 순서로 정리하세요:

3단계: 사용 시작하기

# Skills are the primary workflow surface.

Existing slash-style command names still work while ECC migrates off commands/.

Plugin install uses the canonical namespaced form

/everything-claude-code:plan "Add user authentication"

Manual install keeps the shorter slash form:

/plan "Add user authentication"

Check available commands

/plugin list everything-claude-code@everything-claude-code
끝났습니다! 이제 48개의 에이전트, 182개의 스킬, 68개의 레거시 명령 셈에 접근할 수 있습니다.

대시보드 GUI

데스크탑 대시보드를 실행하여 ECC 구성 요소를 시각적으로 탐색하세요:

npm run dashboard

or

python3 ./ecc_dashboard.py

특징:

다중 모델 명령어는 추가 설정이 필요합니다

경고: multi-* 명령어는 위의 기본 플러그인/규칙 설치에 포함되지 않습니다.
>
/multi-plan, /multi-execute, /multi-backend, /multi-frontend, /multi-workflow를 사용하려면 ccg-workflow 런타임도 설치해야 합니다.
>
npx ccg-workflow로 초기화하세요.
>
이 런타임은 다음과 같은 외부 의존성을 제공합니다:
- ~/.claude/bin/codeagent-wrapper
- ~/.claude/.ccg/prompts/*
>
ccg-workflow가 없으면 이 multi-* 명령어들은 제대로 실행되지 않습니다.


크로스 플랫폼 지원

이 플러그인은 이제 Windows, macOS, Linux를 완벽히 지원하며, 주요 IDE(Cursor, OpenCode, Antigravity) 및 CLI 하니스와의 긴밀한 통합을 제공합니다. 모든 훅과 스크립트는 최대 호환성을 위해 Node.js로 재작성되었습니다.

패키지 매니저 감지

플러그인은 다음 우선순위에 따라 선호하는 패키지 매니저(npm, pnpm, yarn, bun)를 자동으로 감지합니다:

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

# Via environment variable
export CLAUDE_PACKAGE_MANAGER=pnpm

Via global config

node scripts/setup-package-manager.js --global pnpm

Via project config

node scripts/setup-package-manager.js --project bun

Detect current setting

node scripts/setup-package-manager.js --detect
또는 Claude Code에서 /setup-pm 명령어를 사용하세요.

후크 런타임 제어

런타임 플래그를 사용하여 엄격성을 조정하거나 특정 후크를 일시적으로 비활성화하세요:

# Hook strictness profile (default: standard)
export ECC_HOOK_PROFILE=standard

Comma-separated hook IDs to disable

export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

Cap SessionStart additional context (default: 8000 chars)

export ECC_SESSION_START_MAX_CHARS=4000

Disable SessionStart additional context entirely for low-context/local-model setups

export ECC_SESSION_START_CONTEXT=off


What's Inside

This repo is a Claude Code plugin - install it directly or copy components manually.

everything-claude-code/
|-- .claude-plugin/   # Plugin and marketplace manifests
|   |-- plugin.json         # Plugin metadata and component paths
|   |-- marketplace.json    # Marketplace catalog for /plugin marketplace add
|
|-- agents/           # 36 specialized subagents for delegation
|   |-- planner.md           # Feature implementation planning
|   |-- architect.md         # System design decisions
|   |-- tdd-guide.md         # Test-driven development
|   |-- code-reviewer.md     # Quality and security review
|   |-- security-reviewer.md # Vulnerability analysis
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # Playwright E2E testing
|   |-- refactor-cleaner.md  # Dead code cleanup
|   |-- doc-updater.md       # Documentation sync
|   |-- docs-lookup.md       # Documentation/API lookup
|   |-- chief-of-staff.md    # Communication triage and drafts
|   |-- loop-operator.md     # Autonomous loop execution
|   |-- harness-optimizer.md # Harness config tuning
|   |-- cpp-reviewer.md      # C++ code review
|   |-- cpp-build-resolver.md # C++ build error resolution
|   |-- go-reviewer.md       # Go code review
|   |-- go-build-resolver.md # Go build error resolution
|   |-- python-reviewer.md   # Python code review
|   |-- database-reviewer.md # Database/Supabase review
|   |-- typescript-reviewer.md # TypeScript/JavaScript code review
|   |-- java-reviewer.md     # Java/Spring Boot code review
|   |-- java-build-resolver.md # Java/Maven/Gradle build errors
|   |-- kotlin-reviewer.md   # Kotlin/Android/KMP code review
|   |-- kotlin-build-resolver.md # Kotlin/Gradle build errors
|   |-- rust-reviewer.md     # Rust code review
|   |-- rust-build-resolver.md # Rust build error resolution
|   |-- pytorch-build-resolver.md # PyTorch/CUDA training errors
|
|-- skills/           # Workflow definitions and domain knowledge
|   |-- coding-standards/           # Language best practices
|   |-- clickhouse-io/              # ClickHouse analytics, queries, data engineering
|   |-- backend-patterns/           # API, database, caching patterns
|   |-- frontend-patterns/          # React, Next.js patterns
|   |-- frontend-slides/            # HTML slide decks and PPTX-to-web presentation workflows (NEW)
|   |-- article-writing/            # Long-form writing in a supplied voice without generic AI tone (NEW)
|   |-- content-engine/             # Multi-platform social content and repurposing workflows (NEW)
|   |-- market-research/            # Source-attributed market, competitor, and investor research (NEW)
|   |-- investor-materials/         # Pitch decks, one-pagers, memos, and financial models (NEW)
|   |-- investor-outreach/          # Personalized fundraising outreach and follow-up (NEW)
|   |-- continuous-learning/        # Legacy v1 Stop-hook pattern extraction
|   |-- continuous-learning-v2/     # Instinct-based learning with confidence scoring
|   |-- iterative-retrieval/        # Progressive context refinement for subagents
|   |-- strategic-compact/          # Manual compaction suggestions (Longform Guide)
|   |-- tdd-workflow/               # TDD methodology
|   |-- security-review/            # Security checklist
|   |-- eval-harness/               # Verification loop evaluation (Longform Guide)
|   |-- verification-loop/          # Continuous verification (Longform Guide)
|   |-- videodb/                   # Video and audio: ingest, search, edit, generate, stream (NEW)
|   |-- golang-patterns/            # Go idioms and best practices
|   |-- golang-testing/             # Go testing patterns, TDD, benchmarks
|   |-- cpp-coding-standards/         # C++ coding standards from C++ Core Guidelines (NEW)
|   |-- cpp-testing/                # C++ testing with GoogleTest, CMake/CTest (NEW)
|   |-- django-patterns/            # Django patterns, models, views (NEW)
|   |-- django-security/            # Django security best practices (NEW)
|   |-- django-tdd/                 # Django TDD workflow (NEW)
|   |-- django-verification/        # Django verification loops (NEW)
|   |-- laravel-patterns/           # Laravel architecture patterns (NEW)
|   |-- laravel-security/           # Laravel security best practices (NEW)
|   |-- laravel-tdd/                # Laravel TDD workflow (NEW)
|   |-- laravel-verification/       # Laravel verification loops (NEW)
|   |-- python-patterns/            # Python idioms and best practices (NEW)
|   |-- python-testing/             # Python testing with pytest (NEW)
|   |-- springboot-patterns/        # Java Spring Boot patterns (NEW)
|   |-- springboot-security/        # Spring Boot security (NEW)
|   |-- springboot-tdd/             # Spring Boot TDD (NEW)
|   |-- springboot-verification/    # Spring Boot verification (NEW)
|   |-- configure-ecc/              # Interactive installation wizard (NEW)
|   |-- security-scan/              # AgentShield security auditor integration (NEW)
|   |-- java-coding-standards/     # Java coding standards (NEW)
|   |-- jpa-patterns/              # JPA/Hibernate patterns (NEW)
|   |-- postgres-patterns/         # PostgreSQL optimization patterns (NEW)
|   |-- nutrient-document-processing/ # Document processing with Nutrient API (NEW)
|   |-- docs/examples/project-guidelines-template.md  # Template for project-specific skills
|   |-- database-migrations/         # Migration patterns (Prisma, Drizzle, Django, Go) (NEW)
|   |-- api-design/                  # REST API design, pagination, error responses (NEW)
|   |-- deployment-patterns/         # CI/CD, Docker, health checks, rollbacks (NEW)
|   |-- docker-patterns/            # Docker Compose, networking, volumes, container security (NEW)
|   |-- e2e-testing/                 # Playwright E2E patterns and Page Object Model (NEW)
|   |-- content-hash-cache-pattern/  # SHA-256 content hash caching for file processing (NEW)
|   |-- cost-aware-llm-pipeline/     # LLM cost optimization, model routing, budget tracking (NEW)
|   |-- regex-vs-llm-structured-text/ # Decision framework: regex vs LLM for text parsing (NEW)
|   |-- swift-actor-persistence/     # Thread-safe Swift data persistence with actors (NEW)
|   |-- swift-protocol-di-testing/   # Protocol-based DI for testable Swift code (NEW)
|   |-- search-first/               # Research-before-coding workflow (NEW)
|   |-- skill-stocktake/            # Audit skills and commands for quality (NEW)
|   |-- liquid-glass-design/         # iOS 26 Liquid Glass design system (NEW)
|   |-- foundation-models-on-device/ # Apple on-device LLM with FoundationModels (NEW)
|   |-- swift-concurrency-6-2/       # Swift 6.2 Approachable Concurrency (NEW)
|   |-- perl-patterns/             # Modern Perl 5.36+ idioms and best practices (NEW)
|   |-- perl-security/             # Perl security patterns, taint mode, safe I/O (NEW)
|   |-- perl-testing/              # Perl TDD with Test2::V0, prove, Devel::Cover (NEW)
|   |-- autonomous-loops/           # Autonomous loop patterns: sequential pipelines, PR loops, DAG orchestration (NEW)
|   |-- plankton-code-quality/      # Write-time code quality enforcement with Plankton hooks (NEW)
|
|-- commands/         # Maintained slash-entry compatibility; prefer skills/
|   |-- plan.md             # /plan - Implementation planning
|   |-- code-review.md      # /code-review - Quality review
|   |-- build-fix.md        # /build-fix - Fix build errors
|   |-- refactor-clean.md   # /refactor-clean - Dead code removal
|   |-- quality-gate.md     # /quality-gate - Verification gate
|   |-- learn.md            # /learn - Extract patterns mid-session (Longform Guide)
|   |-- learn-eval.md       # /learn-eval - Extract, evaluate, and save patterns (NEW)
|   |-- checkpoint.md       # /checkpoint - Save verification state (Longform Guide)
|   |-- setup-pm.md         # /setup-pm - Configure package manager
|   |-- go-review.md        # /go-review - Go code review (NEW)
|   |-- go-test.md          # /go-test - Go TDD workflow (NEW)
|   |-- go-build.md         # /go-build - Fix Go build errors (NEW)
|   |-- skill-create.md     # /skill-create - Generate skills from git history (NEW)
|   |-- instinct-status.md  # /instinct-status - View learned instincts (NEW)
|   |-- instinct-import.md  # /instinct-import - Import instincts (NEW)
|   |-- instinct-export.md  # /instinct-export - Export instincts (NEW)
|   |-- evolve.md           # /evolve - Cluster instincts into skills
|   |-- prune.md            # /prune - Delete expired pending instincts (NEW)
|   |-- pm2.md              # /pm2 - PM2 service lifecycle management (NEW)
|   |-- multi-plan.md       # /multi-plan - Multi-agent task decomposition (NEW)
|   |-- multi-execute.md    # /multi-execute - Orchestrated multi-agent workflows (NEW)
|   |-- multi-backend.md    # /multi-backend - Backend multi-service orchestration (NEW)
|   |-- multi-frontend.md   # /multi-frontend - Frontend multi-service orchestration (NEW)
|   |-- multi-workflow.md   # /multi-workflow - General multi-service workflows (NEW)
|   |-- sessions.md         # /sessions - Session history management
|   |-- test-coverage.md    # /test-coverage - Test coverage analysis
|   |-- update-docs.md      # /update-docs - Update documentation
|   |-- update-codemaps.md  # /update-codemaps - Update codemaps
|   |-- python-review.md    # /python-review - Python code review (NEW)
|-- legacy-command-shims/   # Opt-in archive for retired shims such as /tdd and /eval
|   |-- tdd.md              # /tdd - Prefer the tdd-workflow skill
|   |-- e2e.md              # /e2e - Prefer the e2e-testing skill
|   |-- eval.md             # /eval - Prefer the eval-harness skill
|   |-- verify.md           # /verify - Prefer the verification-loop skill
|   |-- orchestrate.md      # /orchestrate - Prefer dmux-workflows or multi-workflow
|
|-- rules/            # Always-follow guidelines (copy to ~/.claude/rules/ecc/)
|   |-- README.md            # Structure overview and installation guide
|   |-- common/              # Language-agnostic principles
|   |   |-- coding-style.md    # Immutability, file organization
|   |   |-- git-workflow.md    # Commit format, PR process
|   |   |-- testing.md         # TDD, 80% coverage requirement
|   |   |-- performance.md     # Model selection, context management
|   |   |-- patterns.md        # Design patterns, skeleton projects
|   |   |-- hooks.md           # Hook architecture, TodoWrite
|   |   |-- agents.md          # When to delegate to subagents
|   |   |-- security.md        # Mandatory security checks
|   |-- typescript/          # TypeScript/JavaScript specific
|   |-- python/              # Python specific
|   |-- golang/              # Go specific
|   |-- swift/               # Swift specific
|   |-- php/                 # PHP specific (NEW)
|
|-- hooks/            # Trigger-based automations
|   |-- README.md                 # Hook documentation, recipes, and customization guide
|   |-- hooks.json                # All hooks config (PreToolUse, PostToolUse, Stop, etc.)
|   |-- memory-persistence/       # Session lifecycle hooks (Longform Guide)
|   |-- strategic-compact/        # Compaction suggestions (Longform Guide)
|
|-- scripts/          # Cross-platform Node.js scripts (NEW)
|   |-- lib/                     # Shared utilities
|   |   |-- utils.js             # Cross-platform file/path/system utilities
|   |   |-- package-manager.js   # Package manager detection and selection
|   |-- hooks/                   # Hook implementations
|   |   |-- session-start.js     # Load context on session start
|   |   |-- session-end.js       # Save state on session end
|   |   |-- pre-compact.js       # Pre-compaction state saving
|   |   |-- suggest-compact.js   # Strategic compaction suggestions
|   |   |-- evaluate-session.js  # Extract patterns from sessions
|   |-- setup-package-manager.js # Interactive PM setup
|
|-- tests/            # Test suite (NEW)
|   |-- lib/                     # Library tests
|   |-- hooks/                   # Hook tests
|   |-- run-all.js               # Run all tests
|
|-- contexts/         # Dynamic system prompt injection contexts (Longform Guide)
|   |-- dev.md              # Development mode context
|   |-- review.md           # Code review mode context
|   |-- research.md         # Research/exploration mode context
|
|-- examples/         # Example configurations and sessions
|   |-- CLAUDE.md             # Example project-level config
|   |-- user-CLAUDE.md        # Example user-level config
|   |-- saas-nextjs-CLAUDE.md   # Real-world SaaS (Next.js + Supabase + Stripe)
|   |-- go-microservice-CLAUDE.md # Real-world Go microservice (gRPC + PostgreSQL)
|   |-- django-api-CLAUDE.md      # Real-world Django REST API (DRF + Celery)
|   |-- laravel-api-CLAUDE.md     # Real-world Laravel API (PostgreSQL + Redis) (NEW)
|   |-- rust-api-CLAUDE.md        # Real-world Rust API (Axum + SQLx + PostgreSQL) (NEW)
|
|-- mcp-configs/      # MCP server configurations
|   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway, etc.
|
|-- ecc_dashboard.py  # Desktop GUI dashboard (Tkinter)
|
|-- assets/           # Assets for dashboard
|   |-- images/
|       |-- ecc-logo.png
|
|-- marketplace.json  # Self-hosted marketplace config (for /plugin marketplace add)


에코시스템 도구

스킬 생성기

저장소에서 Claude Code 스킬을 생성하는 두 가지 방법:

#### 옵션 A: 로컬 분석 (내장)

외부 서비스 없이 로컬 분석을 위해 /skill-create 명령어를 사용하세요:

/skill-create                    # Analyze current repo
/skill-create --instincts        # Also generate instincts for continuous-learning-v2
이것은 로컬에서 git 히스토리를 분석하고 SKILL.md 파일을 생성합니다.

#### 옵션 B: GitHub 앱 (고급)

고급 기능(1만 개 이상의 커밋, 자동 PR, 팀 공유)을 위해:

GitHub 앱 설치 | ecc.tools

# Comment on any issue:
/skill-creator analyze

Or auto-triggers on push to default branch

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

AgentShield — 보안 감사 도구

Claude Code 해커톤(Cerebral Valley x Anthropic, 2026년 2월)에서 제작. 1282개 테스트, 98% 커버리지, 102개 정적 분석 규칙.

Claude Code 구성을 취약점, 잘못된 설정 및 인젝션 위험에 대해 검사하세요.

# Quick scan (no install needed)
npx ecc-agentshield scan

Auto-fix safe issues

npx ecc-agentshield scan --fix

Deep analysis with three Opus 4.6 agents

npx ecc-agentshield scan --opus --stream

Generate secure config from scratch

npx ecc-agentshield init
스캔 대상: CLAUDE.md, settings.json, MCP 구성, 훅, 에이전트 정의 및 5가지 범주에 걸친 스킬 — 비밀 탐지(14개 패턴), 권한 감사, 훅 주입 분석, MCP 서버 위험 프로파일링, 에이전트 구성 검토.

--opus 플래그는 세 명의 Claude Opus 4.6 에이전트를 레드팀/블루팀/감사자 파이프라인으로 실행합니다. 공격자는 익스플로잇 체인을 찾고, 방어자는 보호 조치를 평가하며, 감사자는 두 가지를 종합해 우선순위가 매겨진 위험 평가를 수행합니다. 단순 패턴 매칭이 아닌 적대적 추론.

출력 형식: 터미널(색상 등급 A-F), JSON(CI 파이프라인), 마크다운, HTML. 빌드 게이트용 치명적 발견 시 종료 코드 2 반환.

Claude Code에서 /security-scan을 사용해 실행하거나 GitHub Action으로 CI에 추가하세요.

GitHub | npm

연속 학습 v2

본능 기반 학습 시스템이 자동으로 당신의 패턴을 학습합니다:

/instinct-status        # Show learned instincts with confidence
/instinct-import  # Import instincts from others
/instinct-export        # Export your instincts for sharing
/evolve                 # Cluster related instincts into skills
skills/continuous-learning-v2/에서 전체 문서를 참조하세요. 명시적으로 레거시 v1 Stop-hook 학습 스킬 흐름을 원할 때만 continuous-learning/을 유지하세요.

---

요구사항

Claude Code CLI 버전

최소 버전: v2.1.0 이상

이 플러그인은 플러그인 시스템이 훅을 처리하는 방식 변경으로 인해 Claude Code CLI v2.1.0 이상이 필요합니다.

버전을 확인하세요:

claude --version

중요: 훅 자동 로딩 동작

경고: 기여자용: .claude-plugin/plugin.json"hooks" 필드를 추가하지 마십시오. 이는 회귀 테스트로 강제됩니다.

Claude Code v2.1+는 자동으로 설치된 모든 플러그인에서 관례에 따라 hooks/hooks.json을 로드합니다. plugin.json에 명시적으로 선언하면 중복 감지 오류가 발생합니다:

Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file

이력: 이로 인해 이 저장소에서 반복적인 수정/되돌리기 사이클이 발생했습니다 (#29, #52, #103). 이 동작은 Claude Code 버전 간에 변경되어 혼란을 야기했습니다. 이제 이 문제가 다시 발생하지 않도록 회귀 테스트를 추가했습니다.


설치

옵션 1: 플러그인으로 설치 (권장)

이 저장소를 사용하는 가장 쉬운 방법 - Claude Code 플러그인으로 설치:

# Add this repo as a marketplace
/plugin marketplace add https://github.com/affaan-m/everything-claude-code

Install the plugin

/plugin install everything-claude-code@everything-claude-code
또는 직접 ~/.claude/settings.json에 추가하세요:

{
  "extraKnownMarketplaces": {
    "ecc": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}
이렇게 하면 모든 명령어, 에이전트, 스킬 및 훅에 즉시 접근할 수 있습니다.

참고: Claude Code 플러그인 시스템은 플러그인을 통해 rules를 배포하는 것을 지원하지 않습니다 (상위 제한사항). 규칙은 수동으로 설치해야 합니다:
>
> # 먼저 저장소를 클론하세요
git clone https://github.com/affaan-m/everything-claude-code.git
>
# 옵션 A: 사용자 수준 규칙 (모든 프로젝트에 적용)
mkdir -p ~/.claude/rules/ecc
cp -r everything-claude-code/rules/common ~/.claude/rules/ecc/
cp -r everything-claude-code/rules/typescript ~/.claude/rules/ecc/ # 사용하는 스택 선택
cp -r everything-claude-code/rules/python ~/.claude/rules/ecc/
cp -r everything-claude-code/rules/golang ~/.claude/rules/ecc/
cp -r everything-claude-code/rules/php ~/.claude/rules/ecc/
>
# 옵션 B: 프로젝트 수준 규칙 (현재 프로젝트에만 적용)
mkdir -p .claude/rules/ecc
cp -r everything-claude-code/rules/common .claude/rules/ecc/
cp -r everything-claude-code/rules/typescript .claude/rules/ecc/ # 사용하는 스택 선택
``


옵션 2: 수동 설치

설치 항목을 직접 제어하고 싶다면:

bash

Clone the repo

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

Copy agents to your Claude config

cp everything-claude-code/agents/*.md ~/.claude/agents/

Copy rules directories (common + language-specific)

mkdir -p ~/.claude/rules/ecc cp -r everything-claude-code/rules/common ~/.claude/rules/ecc/ cp -r everything-claude-code/rules/typescript ~/.claude/rules/ecc/ # pick your stack cp -r everything-claude-code/rules/python ~/.claude/rules/ecc/ cp -r everything-claude-code/rules/golang ~/.claude/rules/ecc/ cp -r everything-claude-code/rules/php ~/.claude/rules/ecc/

Copy skills first (primary workflow surface)

Recommended (new users): core/general skills only

mkdir -p ~/.claude/skills/ecc cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/ecc/ cp -r everything-claude-code/skills/search-first ~/.claude/skills/ecc/

Optional: add niche/framework-specific skills only when needed

for s in django-patterns django-tdd laravel-patterns springboot-patterns; do

cp -r everything-claude-code/skills/$s ~/.claude/skills/ecc/

done

Optional: keep maintained slash-command compatibility during migration

mkdir -p ~/.claude/commands cp everything-claude-code/commands/*.md ~/.claude/commands/

Retired shims live in legacy-command-shims/commands/.

Copy individual files from there only if you still need old names such as /tdd.

#### 후크 설치

원시 저장소의 hooks/hooks.json 파일을 ~/.claude/settings.json 또는 ~/.claude/hooks/hooks.json에 복사하지 마십시오. 해당 파일은 플러그인/저장소 지향적이며 ECC 설치 프로그램을 통해 설치되거나 플러그인으로 로드되도록 설계되었으므로, 원시 복사는 지원되는 수동 설치 경로가 아닙니다.

설치 프로그램을 사용하여 Claude 후크 런타임만 설치하여 명령 경로가 올바르게 다시 작성되도록 하십시오:

bash

macOS / Linux

bash ./install.sh --target claude --modules hooks-runtime
powershell

Windows PowerShell

pwsh -File .\install.ps1 --target claude --modules hooks-runtime
이것은 해결된 훅을 ~/.claude/hooks/hooks.json에 기록하며 기존의 ~/.claude/settings.json은 변경하지 않습니다.

만약 /plugin install을 통해 ECC를 설치했다면, 해당 훅들을 settings.json에 복사하지 마십시오. Claude Code v2.1+는 이미 플러그인 hooks/hooks.json을 자동으로 로드하며, settings.json에 중복하면 중복 실행 및 크로스 플랫폼 훅 충돌이 발생합니다.

Windows 참고: Claude 설정 디렉토리는 ~/claude가 아닌 %USERPROFILE%\\.claude입니다.

#### MCP 구성하기

Claude 플러그인 설치는 의도적으로 ECC에 번들된 MCP 서버 정의를 자동 활성화하지 않습니다. 이는 엄격한 서드파티 게이트웨이에서 너무 긴 플러그인 MCP 도구 이름을 피하면서 수동 MCP 설정을 가능하게 합니다.

라이브 Claude Code 서버 변경을 위해 Claude Code의 /mcp 명령이나 CLI 관리 MCP 설정을 사용하십시오. Claude Code 런타임 비활성화는 /mcp를 사용하며, Claude Code는 이 선택을 ~/.claude.json에 유지합니다.

저장소 로컬 MCP 접근을 위해서는 원하는 MCP 서버 정의를 mcp-configs/mcp-servers.json에서 프로젝트 범위 .mcp.json으로 복사하십시오.

만약 이미 ECC 번들 MCP 사본을 직접 운영 중이라면, 다음을 설정하십시오:

bash export ECC_DISABLED_MCPS="github,context7,exa,playwright,sequential-thinking,memory"

ECC 관리 설치 및 Codex 동기화 흐름은 중복 서버를 다시 추가하는 대신 번들된 서버를 건너뛰거나 제거합니다. ECC_DISABLED_MCPS는 ECC 설치/동기화 필터이며, 실시간 Claude Code 토글이 아닙니다.

중요: YOUR_*_HERE 자리 표시자를 실제 API 키로 교체하세요.


주요 개념

에이전트

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

markdown
name: code-reviewer description: Reviews code for quality, security, and maintainability tools: ["Read", "Grep", "Glob", "Bash"] model: opus

You are a senior code reviewer...


기술

기술은 주요 워크플로우 표면입니다. 직접 호출할 수 있고, 자동으로 제안되며, 에이전트가 재사용할 수 있습니다. ECC는 마이그레이션 중에도 유지되는 commands/를 제공하며, 단축 이름 쉼은 명시적 선택을 위해 legacy-command-shims/에 있습니다. 새로운 워크플로우 개발은 먼저 skills/에 배치되어야 합니다.

markdown

TDD Workflow

  • Define interfaces first
  • Write failing tests (RED)
  • Implement minimal code (GREEN)
  • Refactor (IMPROVE)
  • Verify 80%+ coverage

후크

후크는 도구 이벤트에서 실행됩니다. 예 - console.log 경고:

json { "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"", "hooks": [{ "type": "command", "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2" }] }

규칙

규칙은 항상 준수해야 하는 지침으로, common/ (언어에 무관한) 및 언어별 디렉터리로 구성됩니다:

rules/ common/ # Universal principles (always install) typescript/ # TS/JS specific patterns and tools python/ # Python specific patterns and tools golang/ # Go specific patterns and tools swift/ # Swift specific patterns and tools php/ # PHP specific patterns and tools
  
설치 및 구조 세부 정보는 rules/README.md를 참조하세요.


어떤 에이전트를 사용해야 하나요?

어디서 시작해야 할지 모르겠나요? 이 빠른 참조를 사용하세요. 스킬은 표준 워크플로우 인터페이스이며, 유지 관리되는 슬래시 엔트리는 명령 우선 워크플로우에서 계속 사용할 수 있습니다.

| 하고 싶은 일 | 사용할 인터페이스 | 사용되는 에이전트 | |--------------|-----------------|------------| | 새 기능 계획하기 | /everything-claude-code:plan "Add auth" | planner | | 시스템 아키텍처 설계하기 | /everything-claude-code:plan + architect 에이전트 | architect | | 테스트 우선 코드 작성하기 | tdd-workflow 스킬 | tdd-guide | | 방금 작성한 코드 리뷰하기 | /code-review | code-reviewer | | 빌드 실패 수정하기 | /build-fix | build-error-resolver | | 엔드 투 엔드 테스트 실행하기 | e2e-testing 스킬 | e2e-runner | | 보안 취약점 찾기 | /security-scan | security-reviewer | | 죽은 코드 제거하기 | /refactor-clean | refactor-cleaner | | 문서 업데이트하기 | /update-docs | doc-updater | | Go 코드 리뷰하기 | /go-review | go-reviewer | | Python 코드 리뷰하기 | /python-review | python-reviewer | | TypeScript/JavaScript 코드 리뷰하기 | (직접 typescript-reviewer 호출) | typescript-reviewer | | 데이터베이스 쿼리 감사하기 | (자동 위임됨) | database-reviewer |

공통 워크플로우

아래 슬래시 명령은 유지 관리되는 명령 인터페이스의 일부로 남아 있는 경우에 표시됩니다. /tdd/eval 같은 단명 이름 셈은 명시적 선택적 사용만을 위해 legacy-command-shims/에 보관되어 있습니다.

새 기능 시작하기:

/everything-claude-code:plan "Add user authentication with OAuth" → planner creates implementation blueprint tdd-workflow skill → tdd-guide enforces write-tests-first /code-review → code-reviewer checks your work

버그 수정:
tdd-workflow skill → tdd-guide: write a failing test that reproduces it → implement the fix, verify test passes /code-review → code-reviewer: catch regressions

생산 준비 중:
/security-scan → security-reviewer: OWASP Top 10 audit e2e-testing skill → e2e-runner: critical user flow tests /test-coverage → verify 80%+ coverage


FAQ

How do I check which agents/commands are installed?
bash /plugin list everything-claude-code@everything-claude-code
이것은 플러그인에서 사용 가능한 모든 에이전트, 명령어 및 스킬을 보여줍니다.

내 후크가 작동하지 않거나 "중복 후크 파일" 오류가 표시됩니다

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

커스텀 API 엔드포인트나 모델 게이트웨이에서 Claude Code와 ECC를 사용할 수 있나요?

네. ECC는 Anthropic이 호스팅하는 전송 설정을 하드코딩하지 않습니다. Claude Code의 일반 CLI/플러그인 인터페이스를 통해 로컬에서 실행되므로 다음과 함께 작동합니다:

  • Anthropic이 호스팅하는 Claude Code
  • ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN을 사용하는 공식 Claude Code 게이트웨이 설정
  • Claude Code가 기대하는 Anthropic API를 사용하는 호환 가능한 커스텀 엔드포인트
최소 예제:

bash export ANTHROPIC_BASE_URL=https://your-gateway.example.com export ANTHROPIC_AUTH_TOKEN=your-token claude
게이트웨이가 모델 이름을 재매핑하는 경우, ECC가 아닌 Claude Code에서 구성하세요. claude CLI가 이미 작동 중이라면 ECC의 훅, 스킬, 명령어 및 규칙은 모델 제공자에 구애받지 않습니다.

공식 참고 자료:

내 컨텍스트 창이 줄어들고 / Claude가 컨텍스트를 다 써가요

너무 많은 MCP 서버가 컨텍스트를 소모합니다. 각 MCP 도구 설명은 200k 토큰 창에서 토큰을 소비하여 약 70k까지 줄어들 수 있습니다. SessionStart 컨텍스트는 기본적으로 8000자 제한이며, ECC_SESSION_START_MAX_CHARS=4000으로 줄이거나 로컬 모델 또는 저컨텍스트 설정 시 ECC_SESSION_START_CONTEXT=off로 비활성화할 수 있습니다.

해결법: 사용하지 않는 MCP를 Claude Code에서 /mcp로 비활성화하세요. Claude Code는 이러한 런타임 선택을 ~/.claude.json에 기록하며, .claude/settings.json.claude/settings.local.json은 이미 로드된 MCP 서버에 대한 신뢰할 수 있는 토글이 아닙니다.

활성 MCP는 10개 미만, 활성 도구는 80개 미만으로 유지하세요.

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

네. 옵션 2(수동 설치)를 사용하고 필요한 것만 복사하세요:

bash

Just agents

cp everything-claude-code/agents/*.md ~/.claude/agents/

Just rules

mkdir -p ~/.claude/rules/ecc/ cp -r everything-claude-code/rules/common ~/.claude/rules/ecc/
각 구성 요소는 완전히 독립적입니다.

이것이 Cursor / OpenCode / Codex / Antigravity와 작동합니까?

예. ECC는 크로스 플랫폼입니다:

  • Cursor: .cursor/에 미리 번역된 구성 파일. Cursor IDE 지원 참조.
  • Gemini CLI: .gemini/GEMINI.md 및 공유 설치 파이프라인을 통한 실험적 프로젝트 로컬 지원.
  • OpenCode: .opencode/에서 전체 플러그인 지원. OpenCode 지원 참조.
  • Codex: macOS 앱과 CLI 모두에 대한 일류 지원, 어댑터 드리프트 가드 및 SessionStart 폴백 포함. PR #257 참조.
  • Antigravity: .agent/에서 워크플로, 스킬 및 평면화된 규칙에 대한 긴밀한 통합 설정. Antigravity 가이드 참조.
  • 비네이티브 하니스: Grok 및 유사 인터페이스를 위한 수동 폴백 경로. 수동 적응 가이드 참조.
  • Claude Code: 네이티브 — 이것이 주요 대상입니다.

새로운 스킬이나 에이전트를 어떻게 기여합니까?

CONTRIBUTING.md를 참조하세요. 요약 버전:

  • 저장소를 포크합니다.
  • skills/your-skill-name/SKILL.md에 스킬을 만듭니다 (YAML 프론트매터 포함).
  • 또는 agents/your-agent.md에 에이전트를 만듭니다.
  • 기능과 사용 시기를 명확히 설명하는 PR을 제출합니다.


테스트 실행

플러그인은 포괄적인 테스트 스위트를 포함합니다:

bash

Run all tests

node tests/run-all.js

Run individual test files

node tests/lib/utils.test.js node tests/lib/package-manager.test.js node tests/hooks/hooks.test.js


기여하기

기여는 환영하며 권장됩니다.

이 저장소는 커뮤니티 리소스를 목적으로 합니다. 만약 다음과 같은 것이 있다면:

  • 유용한 에이전트 또는 스킬
  • 기발한 훅
  • 더 나은 MCP 설정
  • 개선된 규칙
기여해 주세요! 가이드라인은 CONTRIBUTING.md에서 확인할 수 있습니다.

기여 아이디어

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

커뮤니티 생태계 참고 사항

이들은 ECC에 번들로 포함되어 있지 않고 이 저장소에서 감사를 받지 않았지만, Claude Code 스킬 생태계를 탐색할 때 알아두면 유용합니다:

---

Cursor IDE 지원

ECC는 Cursor의 프로젝트 레이아웃에 맞춘 훅, 규칙, 에이전트, 스킬, 명령어, MCP 설정과 함께 Cursor IDE 지원을 제공합니다.

빠른 시작 (Cursor)

bash

macOS/Linux

./install.sh --target cursor typescript ./install.sh --target cursor python golang swift php
powershell

Windows PowerShell

.\install.ps1 --target cursor typescript .\install.ps1 --target cursor python golang swift php
### 포함 내용

| 구성 요소 | 수량 | 세부사항 | |-----------|-------|---------| | 후크 이벤트 | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt, 그리고 10개 더 | | 후크 스크립트 | 16 | 공유 어댑터를 통해 scripts/hooks/에 위임하는 얇은 Node.js 스크립트 | | 규칙 | 34 | 9개 공통 (alwaysApply) + 25개 언어별 (TypeScript, Python, Go, Swift, PHP) | | 에이전트 | 48 | 설치 시 .cursor/agents/ecc-*.md; 사용자 또는 마켓플레이스 에이전트와 충돌 방지를 위해 접두사 사용 | | 스킬 | 공유 + 번들 | 번역된 추가 기능을 위한 .cursor/skills/ | | 명령어 | 공유 | 설치 시 .cursor/commands/ | | MCP 설정 | 공유 | 설치 시 .cursor/mcp.json |

커서 로딩 노트

ECC는 루트 AGENTS.md.cursor/에 설치하지 않습니다. 커서는 중첩된 AGENTS.md 파일을 디렉터리 컨텍스트로 처리하므로, ECC의 저장소 식별자를 호스트 프로젝트에 복사하면 해당 프로젝트가 오염됩니다.

커서 네이티브 로딩 동작은 커서 빌드에 따라 다를 수 있습니다. ECC는 에이전트를 .cursor/agents/ecc-*.md로 설치하며, 귀하의 커서 빌드가 프로젝트 에이전트를 노출하지 않더라도 해당 파일들은 숨겨진 전역 프롬프트 컨텍스트 대신 명시적 참조 정의로 작동합니다.

후크 아키텍처 (DRY 어댑터 패턴)

커서는 Claude Code보다 더 많은 후크 이벤트를 가지고 있습니다 (20 대 8). .cursor/hooks/adapter.js 모듈은 커서의 stdin JSON을 Claude Code 형식으로 변환하여 기존 scripts/hooks/*.js를 중복 없이 재사용할 수 있게 합니다.

Cursor stdin JSON → adapter.js → transforms → scripts/hooks/*.js (shared with Claude Code)
핵심 훅:
  • beforeShellExecution — tmux 외부의 개발 서버 차단 (종료 코드 2), git push 검토
  • afterFileEdit — 자동 포맷 + TypeScript 검사 + console.log 경고
  • beforeSubmitPrompt — 프롬프트 내 비밀 키(sk-, ghp_, AKIA 패턴) 감지
  • beforeTabFileRead — Tab이 .env, .key, .pem 파일 읽기 차단 (종료 코드 2)
  • beforeMCPExecution / afterMCPExecution — MCP 감사 로깅

규칙 포맷

커서 규칙은 description, globs, alwaysApply가 포함된 YAML 프런트매터를 사용:

yaml
description: "TypeScript coding style extending common rules" globs: ["/.ts", "/.tsx", "/.js", "/.jsx"] alwaysApply: false


Codex macOS 앱 + CLI 지원

ECC는 macOS 앱과 CLI 모두에 대해 최고 수준의 Codex 지원을 제공하며, 참조 구성, Codex 전용 AGENTS.md 보충 자료, 그리고 공유 기술을 포함합니다.

빠른 시작 (Codex 앱 + CLI)

bash

Run Codex CLI in the repo — AGENTS.md and .codex/ are auto-detected

codex

Automatic setup: sync ECC assets (AGENTS.md, skills, MCP servers) into ~/.codex

npm install && bash scripts/sync-ecc-to-codex.sh

or: pnpm install && bash scripts/sync-ecc-to-codex.sh

or: yarn install && bash scripts/sync-ecc-to-codex.sh

or: bun install && bash scripts/sync-ecc-to-codex.sh

Or manually: copy the reference config to your home directory

cp .codex/config.toml ~/.codex/config.toml
동기화 스크립트는 추가 전용 전략을 사용하여 ECC MCP 서버를 기존 ~/.codex/config.toml에 안전하게 병합합니다 — 기존 서버를 제거하거나 수정하지 않습니다. 변경 사항을 미리 보려면 --dry-run을 실행하고, ECC 서버를 최신 권장 구성으로 강제 새로 고치려면 --update-mcp를 사용하세요.

Context7의 경우, ECC는 정식 Codex 섹션 이름 [mcp_servers.context7]를 사용하면서도 @upstash/context7-mcp 패키지를 실행합니다. 이미 구식 [mcp_servers.context7-mcp] 항목이 있으면 --update-mcp가 이를 정식 섹션 이름으로 마이그레이션합니다.

Codex macOS 앱:

  • 이 저장소를 작업 공간으로 엽니다.
  • 루트 AGENTS.md가 자동 감지됩니다.
  • .codex/config.toml.codex/agents/*.toml은 프로젝트 로컬에 보관할 때 가장 잘 작동합니다.
  • 참조용 .codex/config.tomlmodel 또는 model_provider를 고정하지 않으므로, Codex는 사용자가 재정의하지 않는 한 자체 현재 기본값을 사용합니다.
  • 선택 사항: 글로벌 기본값으로 .codex/config.toml~/.codex/config.toml에 복사하고, 다중 에이전트 역할 파일은 .codex/agents/도 복사하지 않는 한 프로젝트 로컬에 유지하세요.

포함된 항목

| 구성요소 | 개수 | 상세 | |-----------|-------|---------| | 구성 | 1 | .codex/config.toml — 최상위 승인/샌드박스/웹_검색, MCP 서버, 알림, 프로필 | | AGENTS.md | 2 | 루트(범용) + .codex/AGENTS.md (Codex 전용 보충) | | 스킬 | 32 | .agents/skills/ — SKILL.md + 스킬별 agents/openai.yaml | | MCP 서버 | 6 | GitHub, Context7, Exa, Memory, Playwright, Sequential Thinking (--update-mcp 동기화 시 Supabase 포함 7개) | | 프로필 | 2 | strict (읽기 전용 샌드박스)와 yolo (완전 자동 승인) | | 에이전트 역할 | 3 | .codex/agents/ — 탐험가, 검토자, 문서 연구자 |

스킬

.agents/skills/의 스킬은 Codex에 의해 자동 로드됩니다:

claude-api, frontend-design, skill-creator와 같은 정식 Anthropic 스킬은 여기에서 재번들하지 않습니다. 공식 버전이 필요하면 anthropics/skills에서 설치하세요.

| 스킬 | 설명 | |-------|-------------| | agent-introspection-debugging | 에이전트 동작, 라우팅, 프롬프트 경계 디버깅 | | agent-sort | 에이전트 카탈로그 및 할당 표면 정렬 | | api-design | REST API 설계 패턴 | | article-writing | 노트 및 음성 참조에서 장문 작성 | | backend-patterns | API 설계, 데이터베이스, 캐싱 | | brand-voice | 실제 콘텐츠에서 유래한 작성 스타일 프로필 | | bun-runtime | 런타임, 패키지 관리자, 번들러, 테스트 러너로서 Bun | | coding-standards | 범용 코딩 표준 | | content-engine | 플랫폼 네이티브 소셜 콘텐츠 및 재활용 |

| crosspost | X, LinkedIn, Threads 간 다중 플랫폼 콘텐츠 배포 | | deep-research | 종합 출처 연구 및 출처 명시 | | dmux-workflows | tmux 창 관리자 사용 다중 에이전트 오케스트레이션 | | documentation-lookup | Context7 MCP를 통한 최신 라이브러리 및 프레임워크 문서 | | e2e-testing | Playwright E2E 테스트 | | eval-harness | 평가 기반 개발 | | everything-claude-code | 프로젝트 개발 규칙 및 패턴 | | exa-search | Exa MCP를 통한 웹, 코드, 기업 연구용 신경망 검색 | | fal-ai-media | 이미지, 비디오, 오디오 통합 미디어 생성 | | frontend-patterns | React/Next.js 패턴 | | frontend-slides | HTML 프레젠테이션, PPTX 변환, 시각 스타일 탐색 | | investor-materials | 데크, 메모, 모델, 원페이지 문서 | | investor-outreach | 개인화된 연락, 후속 조치, 소개 문구 | | market-research | 출처 명시 시장 및 경쟁자 조사 | | mcp-server-patterns | Node/TypeScript SDK로 MCP 서버 구축 | | nextjs-turbopack | Next.js 16+ 및 Turbopack 점진적 번들링 | | product-capability | 제품 목표를 범위가 명확한 역량 맵으로 변환 | | security-review | 종합 보안 체크리스트 | | strategic-compact | 컨텍스트 관리 | | tdd-workflow | 80% 이상 커버리지의 테스트 주도 개발 | | verification-loop | 빌드, 테스트, 린트, 타입체크, 보안 | | video-editing | FFmpeg 및 Remotion을 활용한 AI 지원 비디오 편집 워크플로우 | | x-api | 게시 및 분석을 위한 X/Twitter API 통합 |

주요 제한 사항

Codex는 아직 Claude 스타일의 후크 실행 동등성을 제공하지 않습니다. ECC 강제는 AGENTS.md 기반 명령어, 선택적 model_instructions_file 재정의, 샌드박스/승인 설정을 통해 이루어집니다.

다중 에이전트 지원

현재 Codex 빌드는 안정적인 다중 에이전트 워크플로우를 지원합니다.

  • .codex/config.toml에서 features.multi_agent = true 활성화
  • [agents.] 아래 역할 정의
  • 각 역할을 .codex/agents/ 아래 파일로 지정
  • CLI에서 /agent 명령어로 하위 에이전트 검사 또는 조정
ECC는 세 가지 샘플 역할 구성을 제공합니다:

| 역할 | 목적 | |------|---------| | explorer | 편집 전 읽기 전용 코드베이스 증거 수집 | | reviewer | 정확성, 보안 및 누락된 테스트 검토 | | docs_researcher | 릴리스/문서 변경 전 문서 및 API 검증 |


OpenCode 지원

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

빠른 시작

bash

Install OpenCode

npm install -g opencode

Run in the repository root

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

기능 동등성

| 기능 | Claude Code | OpenCode | 상태 | |---------|-------------|----------|--------| | 에이전트 | 통과: 48 에이전트 | 통과: 12 에이전트 | Claude Code 우위 | | 명령어 | 통과: 68 명령어 | 통과: 31 명령어 | Claude Code 우위 | | 스킬 | 통과: 182 스킬 | 통과: 37 스킬 | Claude Code 우위 | | 훅 | 통과: 8 이벤트 유형 | 통과: 11 이벤트 | OpenCode가 더 많음! | | 규칙 | 통과: 29 규칙 | 통과: 13 지침 | Claude Code 우위 | | MCP 서버 | 통과: 14 서버 | 통과: 전체 | 완전 동등 | | 사용자 도구 | 통과: 훅을 통해 | 통과: 6 네이티브 도구 | OpenCode가 더 우수 |

플러그인을 통한 훅 지원

OpenCode의 플러그인 시스템은 20개 이상의 이벤트 유형으로 Claude Code보다 더 정교합니다:

| Claude Code 훅 | OpenCode 플러그인 이벤트 | |-----------------|----------------------| | PreToolUse | tool.execute.before | | PostToolUse | tool.execute.after | | Stop | session.idle | | SessionStart | session.created | | SessionEnd | session.deleted |

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

유지 관리되는 슬래시 명령어

| 명령어 | 설명 | |---------|-------------| | /plan | 구현 계획 생성 | | /code-review | 코드 변경 검토 | | /build-fix | 빌드 오류 수정 | | /refactor-clean | 불필요한 코드 제거 | | /learn | 세션에서 패턴 추출 | | /checkpoint | 검증 상태 저장 | | /quality-gate | 유지 관리되는 검증 게이트 실행 |

| /update-docs | 문서 업데이트 | | /update-codemaps | 코드맵 업데이트 | | /test-coverage | 커버리지 분석 | | /go-review | Go 코드 리뷰 | | /go-test | Go TDD 워크플로우 | | /go-build | Go 빌드 오류 수정 | | /python-review | Python 코드 리뷰 (PEP 8, 타입 힌트, 보안) | | /multi-plan | 다중 모델 협업 계획 | | /multi-execute | 다중 모델 협업 실행 | | /multi-backend | 백엔드 중심 다중 모델 워크플로우 | | /multi-frontend | 프론트엔드 중심 다중 모델 워크플로우 | | /multi-workflow | 전체 다중 모델 개발 워크플로우 | | /pm2 | PM2 서비스 명령 자동 생성 | | /sessions | 세션 기록 관리 | | /skill-create | git에서 스킬 생성 | | /instinct-status | 학습된 본능 보기 | | /instinct-import | 본능 가져오기 | | /instinct-export | 본능 내보내기 | | /evolve | 본능을 스킬로 클러스터링 | | /promote | 프로젝트 본능을 전역 범위로 승격 | | /projects | 알려진 프로젝트 및 본능 통계 목록 | | /prune | 만료된 대기 본능 삭제 (30일 TTL) | | /learn-eval | 저장 전 패턴 추출 및 평가 | | /setup-pm | 패키지 관리자 구성 | | /harness-audit | 하니스 신뢰성, 평가 준비 상태 및 위험 태세 감사 | | /loop-start | 제어된 에이전트 루프 실행 패턴 시작 | | /loop-status | 활성 루프 상태 및 체크포인트 점검 | | /quality-gate | 경로 또는 전체 저장소에 대한 품질 게이트 검사 실행 | | /model-route | 복잡도 및 예산에 따라 작업을 모델로 라우팅 |

플러그인 설치

옵션 1: 직접 사용

bash cd everything-claude-code opencode

옵션 2: npm 패키지로 설치하기
bash npm install ecc-universal

그런 다음 opencode.json에 추가하십시오:
json { "plugin": ["ecc-universal"] }
그 npm 플러그인 항목은 ECC에서 배포한 OpenCode 플러그인 모듈(훅/이벤트 및 플러그인 도구)을 활성화합니다.  
이는 자동으로 ECC의 전체 명령/에이전트/지침 카탈로그를 프로젝트 구성에 추가하지 않습니다.  

전체 ECC OpenCode 설정을 위해서는, 다음 중 하나를 수행하세요:

  • 이 저장소 내에서 OpenCode를 실행하거나,
  • 번들된 .opencode/ 구성 자산을 프로젝트에 복사하고 opencode.json에서 instructions, agent, command 항목을 연결하세요.

문서

  • 마이그레이션 가이드: .opencode/MIGRATION.md
  • OpenCode 플러그인 README: .opencode/README.md
  • 통합 규칙: .opencode/instructions/INSTRUCTIONS.md
  • LLM 문서: llms.txt (LLM용 완전한 OpenCode 문서)
---

도구 간 기능 동등성

ECC는 모든 주요 AI 코딩 도구를 최대한 활용한 최초의 플러그인입니다. 각 도구별 활용 현황은 다음과 같습니다:

| 기능 | Claude Code | Cursor IDE | Codex CLI | OpenCode | |---------|------------|------------|-----------|----------| | 에이전트 | 48 | 공유 (AGENTS.md) | 공유 (AGENTS.md) | 12 | | 명령어 | 68 | 공유 | 지침 기반 | 31 | | 스킬 | 182 | 공유 | 10 (네이티브 형식) | 37 | | 훅 이벤트 | 8종류 | 15종류 | 아직 없음 | 11종류 | | 훅 스크립트 | 20+ 스크립트 | 16 스크립트 (DRY 어댑터) | 해당 없음 | 플러그인 훅 | | 규칙 | 34개 (공통 + 언어별) | 34개 (YAML 프런트매터) | 지침 기반 | 13개 지침 | | 커스텀 도구 | 훅을 통해 | 훅을 통해 | 해당 없음 | 6개 네이티브 도구 | | MCP 서버 | 14개 | 공유 (mcp.json) | 7개 (TOML 파서로 자동 병합) | 전체 | | 구성 형식 | settings.json | hooks.json + rules/ | config.toml | opencode.json | | 컨텍스트 파일 | CLAUDE.md + AGENTS.md | AGENTS.md | AGENTS.md | AGENTS.md | | 비밀 탐지 | 훅 기반 | beforeSubmitPrompt 훅 | 샌드박스 기반 | 훅 기반 | | 자동 포맷 | PostToolUse 훅 | afterFileEdit 훅 | 해당 없음 | file.edited 훅 | | 버전 | 플러그인 | 플러그인 | 참조 구성 | 2.0.0-rc.1 |

주요 아키텍처 결정:

  • 루트의 AGENTS.md는 모든 4개 도구가 읽는 범용 크로스 도구 파일입니다.
  • DRY 어댑터 패턴은 Cursor가 Claude Code의 훅 스크립트를 중복 없이 재사용할 수 있게 합니다.
  • 스킬 포맷 (YAML 프런트매터가 포함된 SKILL.md)은 Claude Code, Codex, OpenCode 전반에서 작동합니다.
  • Codex의 후킹 부족은 AGENTS.md, 선택적 model_instructions_file 오버라이드, 샌드박스 권한으로 보완됩니다.
---

배경

저는 실험적 롤아웃 이후 Claude Code를 사용해 왔습니다. 2025년 9월 Anthropic x Forum Ventures 해커톤에서 @DRodriguezFX와 함께 우승 — Claude Code만으로 zenith.chat을 완성했습니다.

이 구성들은 여러 프로덕션 애플리케이션에서 검증되었습니다.


토큰 최적화

Claude Code 사용은 토큰 소비를 관리하지 않으면 비용이 많이 들 수 있습니다. 이 설정들은 품질을 유지하면서 비용을 크게 줄여줍니다.

권장 설정

~/.claude/settings.json에 추가하세요:

json { "model": "sonnet", "env": { "MAX_THINKING_TOKENS": "10000", "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50" } }
| Setting | Default | Recommended | Impact |
|---------|---------|-------------|--------|
| model | opus | sonnet | 약 60% 비용 절감; 80% 이상의 코딩 작업 처리 |
| MAX_THINKING_TOKENS | 31,999 | 10,000 | 요청당 숨겨진 사고 비용 약 70% 절감 |
| CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | 95 | 50 | 더 일찍 압축 — 긴 세션에서 더 나은 품질 |

깊은 아키텍처적 추론이 필요할 때만 Opus로 전환하세요:

/model opus
### 일일 작업 명령어

| 명령어 | 사용 시기 | |---------|-------------| | /model sonnet | 대부분의 작업 기본값 | | /model opus | 복잡한 아키텍처, 디버깅, 심층 추론 | | /clear | 관련 없는 작업 사이 (무료, 즉시 리셋) | | /compact | 논리적 작업 구간에서 (연구 완료, 마일스톤 완료) | | /cost | 세션 중 토큰 사용량 모니터링 |

전략적 압축

strategic-compact 스킬(이 플러그인에 포함됨)은 95% 컨텍스트 자동 압축 대신 논리적 구간에서 /compact를 제안합니다. 전체 결정 가이드는 skills/strategic-compact/SKILL.md를 참고하세요.

압축 시점:

  • 연구/탐색 후, 구현 전에
  • 마일스톤 완료 후, 다음 시작 전에
  • 디버깅 후, 기능 작업 계속 전에
  • 실패한 접근 후, 새로운 시도 전에
압축하지 말아야 할 때:
  • 구현 중간 (변수명, 파일 경로, 부분 상태 손실 우려)

컨텍스트 창 관리

중요: 모든 MCP를 한 번에 활성화하지 마세요. 각 MCP 도구 설명은 20만 토큰 창에서 토큰을 소비하여 약 7만 토큰으로 줄어들 수 있습니다.

  • 프로젝트당 10개 미만 MCP 활성 유지
  • 80개 미만 도구 활성 유지
  • /mcp를 사용해 사용하지 않는 Claude Code MCP 서버 비활성화; 실행 시간 선택 사항은 ~/.claude.json에 저장됨
  • 설치/동기화 흐름 중 ECC가 생성한 MCP 구성만 필터링하려면 ECC_DISABLED_MCPS 사용

에이전트 팀 비용 경고

에이전트 팀은 여러 컨텍스트 창을 생성합니다. 각 팀원은 독립적으로 토큰을 소비합니다. 병렬 처리가 명확한 가치를 제공하는 작업(다중 모듈 작업, 병렬 리뷰)에만 사용하세요. 간단한 순차 작업에는 서브에이전트가 토큰 효율적입니다.


경고: 중요 참고사항

토큰 최적화

일일 한도에 도달하셨나요? 권장 설정 및 작업 흐름 팁은 토큰 최적화 가이드 를 참조하세요.

빠른 성과:

json // ~/.claude/settings.json { "model": "sonnet", "env": { "MAX_THINKING_TOKENS": "10000", "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50", "CLAUDE_CODE_SUBAGENT_MODEL": "haiku" } }
` 관련 없는 작업 사이에는 /clear를 사용하고, 논리적 구간에서는 /compact를 사용하며, 지출 모니터링에는 /cost`를 사용하세요.

사용자 정의

이 구성은 제 작업 흐름에 맞게 작동합니다. 당신은:

---

커뮤니티 프로젝트

Everything Claude Code를 기반으로 하거나 영감을 받은 프로젝트들:

| 프로젝트 | 설명 | |---------|-------------| | EVC | 마케팅 에이전트 작업 공간 — 콘텐츠 운영자, 브랜드 거버넌스, 다중 채널 퍼블리싱을 위한 42개 명령어. 시각적 개요. |

ECC로 무언가를 만들었나요? 여기에 추가하려면 PR을 오픈하세요.


후원자

이 프로젝트는 무료이자 오픈 소스입니다. 후원자는 유지 보수 및 성장에 도움을 줍니다.

후원자가 되기 | 후원 등급 | 후원 프로그램


스타 히스토리

스타 히스토리 차트


링크들

---

라이선스

MIT - 자유롭게 사용하고, 필요에 따라 수정하며, 가능하면 기여하세요.


이 저장소가 도움이 되면 별을 주세요. 두 가이드를 모두 읽으세요. 멋진 것을 만드세요.

--- Tranlated By Open Ai Tx | Last indexed: 2026-05-06 ---