본문으로 건너뛰기
에이전트 Skills 전체 목록

ECC (Everything Claude Code)

  • 추천0
  • GitHub 별304K
  • 개발라이선스MIT

에이전트 71개 · 스킬 314개 · 훅 · 규칙을 묶은 하네스 최적화 키트. Claude Code · Codex · Cursor 등에서 계획 · 테스트 · 리뷰 · 기억을 이어 줘요

원본:affaan-m/ECC

요약

에이전트 71개 · 스킬 314개 · 훅 · 규칙을 묶은 하네스 최적화 키트. Claude Code · Codex · Cursor 등에서 계획 · 테스트 · 리뷰 · 기억을 이어 줘요

설명

[!WARNING] 공식 출처에서만 설치하세요. GitHub 저장소 github.com/affaan-m/ECC, npm 패키지 ecc-universal과 ecc-agentshield, GitHub 앱, 플러그인 이름 ecc@ecc, 프로젝트 웹사이트 ecc.tools에서만 설치하세요. 제3자가 다시 올린 복제본과 비공식 미러는 프로젝트가 관리하거나 검토하지 않으며 악성 코드가 들어 있을 수 있습니다.

ECC - 에이전트 하네스 운영체제

GitHub 오늘의 트렌딩 저장소 Star History 글로벌 순위

Discord 웹사이트 GitHub 앱 MIT 라이선스

GitHub 스타 GitHub 포크 기여자 ecc-universal 주간 다운로드 ecc-agentshield 주간 다운로드

Claude Code에 설치하기

안내형 설치나 Claude Code 기본 플러그인 명령을 쓰세요. 둘 다 같은 ecc@ecc 플러그인을 설치합니다. 하나만 고르고, 그 위에 Claude 수동 전체 설치를 겹쳐 하지 마세요.

오픈소스는 계속 무료입니다. 이 저장소는 영원히 MIT 라이선스입니다. ECC Pro는 비공개 저장소용 호스팅 GitHub 앱이고(무료 설치, 비공개 저장소는 월 좌석당 $19부터), 후원자와 Pro 구독자가 이 작업을 뒷받침합니다. 그래서 한 명의 메인테이너가 7개 하네스에 매주 새 버전을 내놓을 수 있습니다.

파트너와 후원사

CodeRabbit Greptile Moonshot AI - Kimi Itô Markets SerpApi: 웹 검색 API

지난 후원사: Atlas Cloud · Mike Morgan(활동 중단). 커뮤니티 후원자: @jasonwu513 · @1anter · @massimotodaro · @meadmccabe.

ECC

에이전트는 코드를 쓸 수 있습니다. ECC는 거기에 조율된 엔지니어링 시스템과 도구 상자를 더해 줍니다. 만들기 전에 계획하고, 테스트로 변경을 검증하고, 새 컨텍스트에서 자기 작업을 리뷰하고, 중요한 것을 기억하고, 반복해서 거둔 성과를 재사용할 수 있는 스킬과 워크플로로 바꿉니다.

plan -> test -> implement -> review -> verify -> remember -> improve

이 과정을 프롬프트마다 다시 만드는 대신, 한 번 설치해서 에이전트가 일하는 방식의 일부로 만드세요.

컨텍스트 창은 최적화하고, 나머지는 모두 보존한다.

ECC는 MIT 라이선스 오픈소스입니다. 지금은 Claude Code에서 가장 잘 동작하고, Codex와 Qoder용 네이티브 플러그인 경로가 있으며, Cursor · OpenCode · Gemini · Zed · GitHub Copilot · Antigravity · Qwen 등 다른 하네스에는 기능이 제한된 어댑터를 제공합니다. 모든 기능이 똑같이 된다고 가정하기 전에 지원 현황 표를 확인하세요.

에이전트 71개, 스킬 314개, 예전 방식의 명령 단축 98개와 함께 훅, 규칙, 기억, 지속 학습, AgentShield 보안 스캔이 들어 있습니다. 에이전트는 계획, 리뷰, 빌드 복구, 보안, 설계, 도메인 작업에 특화되어 있습니다.

구성수량얻는 것
에이전트71개계획, 리뷰, 빌드 복구, 보안, 설계, 도메인 작업
스킬314개TDD, 조사, 보안, 문서, 프런트엔드, 데이터, ML, 운영 등
명령98개ECC가 스킬 중심으로 옮겨 가는 동안 쓰는 편의 진입점
훅과 기억런타임규칙 강제, 세션 요약, 지속 학습, 직관(instincts), 컨텍스트 제어
규칙선택언어나 프로젝트별로 골라 쓰는 상시 로드 표준
AgentShield포함프롬프트, 훅, MCP 설정, 권한, 비밀 값, 에이전트 파일 스캔

ECC 설치

[!IMPORTANT] ECC 2.2에는 Claude Code, Codex, Kimi Code용 안내형 패키지 설치가 들어 있습니다. 통합 패키지는 Node.js 18 이상이 필요합니다. Claude 플러그인 설치에는 Git과 PATH에 잡힌 Claude Code 2.1 이상도 필요합니다.

추천: 통합 안내형 설치

Claude Code 플러그인 설치, 업데이트, 범위 변경, 훅 프로필 변경에는 이 명령을 쓰세요.

npx ecc-universal@2.2.3 setup

Windows 처음 따라 하기

명령줄 도구가 처음이라면 이 순서를 복사해서 붙여 넣으세요.

  1. Node.js 18 이상, Git, Claude Code를 설치합니다.

  2. Windows 시작 메뉴에서 PowerShell을 엽니다.

  3. 필요한 것이 모두 있는지 확인합니다.

    node --version
    git --version
    claude --version
  4. 안내형 설치 프로그램을 실행합니다.

    npx ecc-universal@2.2.3 setup
  5. 보통의 개인용 설정이라면 Global user, Standard 훅을 고르고 확인합니다.

  6. 새 Claude Code 세션을 시작하고 /plugin list를 실행해 ecc@ecc가 켜져 있는지 확인합니다.

이 방법은 저장소를 받을 필요가 없습니다. 어떤 명령이 없다고 나오면 그 준비물을 먼저 설치하거나 고친 뒤 ECC 설치를 다시 실행하세요.

npm이 버전이나 캐시 오류를 내면 다시 시도하기 전에 레지스트리 버전을 확인하세요.

npm view ecc-universal version

ECC 2.2는 요즘의 패키지 실행기로도 같은 안내형 설치를 지원합니다.

패키지 실행기안내형 설치 명령
npm / npxnpx ecc-universal@2.2.3 setup
pnpmpnpm dlx ecc-universal@2.2.3 setup
Yarn 2+yarn dlx ecc-universal@2.2.3 setup
Bunbunx ecc-universal@2.2.3 setup

예시는 이 저장소의 릴리스 버전과 같은 ECC 2.2.3 공개 릴리스를 고릅니다. 버전을 고정했다고 보안 감사나 무결성 확인이 되는 것은 아닙니다. 패키지 코드를 실행하기 전에 릴리스 소스와 레지스트리 무결성을 검토하세요. 아직 나오지 않은 변경은 검토한 체크아웃으로 쓰세요.

Yarn Classic 1에는 yarn dlx가 없습니다. 일회성으로 실행하려면 npx를 쓰거나, 패키지를 전역 설치하거나, Yarn을 올리세요.

이 마법사는 변경하기 전에 공식 마켓플레이스와 Claude의 모든 설치 범위를 조사한 뒤, 고른 범위에 ecc@ecc를 설치하거나 업데이트하거나 안전하게 옮깁니다. ECC를 업데이트하거나 범위나 훅 프로필을 바꾸고 싶을 때마다 같은 명령을 다시 실행하세요. 이 설치 마법사는 지금은 Claude Code 플러그인만 설정합니다. Codex나 Kimi Code는 아래 다중 하네스 마법사를 쓰세요.

코딩 에이전트 여러 개를 한 번의 검토 흐름으로 설정하려면 다중 하네스 마법사를 쓰세요.

npx ecc-universal@2.2.3 install --guided

Claude Code, Codex, Kimi Code 중 원하는 조합을 고를 수 있고, 각 설치 경로와 위치를 보여 주며, 첫 쓰기 전에 모든 선택을 미리 점검하고, 마지막에 한 번 확인을 받습니다.

하네스안내형 설치 동작
Claude Code네이티브 ecc@ecc 플러그인, user · project · local 중 하나의 범위, ECC 훅 프로필
Codex네이티브 Codex 마켓플레이스/플러그인 수명 주기. 훅 검토와 신뢰는 Codex가 관리
Kimi Code./.kimi-code 아래 관리되는 프로젝트 파일. ECC 훅, 모델/제공자 설정, 인증은 설정하지 않음

자동화할 때는 제공자별 선택을 모두 명시하세요.

npx ecc-universal@2.2.3 install --guided \
  --harness claude --harness codex --harness kimi \
  --claude-scope local --claude-hooks standard \
  --profile core --yes

쓰기 전에 네이티브 안내형 Codex 경로와 관리되는 Kimi 경로를 점검하려면 이렇게 하세요.

npx ecc-universal@2.2.3 install --guided --harness codex --dry-run
npx ecc-universal@2.2.3 install --profile core --target kimi --dry-run

2.2 별칭으로 패키지 이름 명령도 쓸 수 있습니다.

npx ecc-universal@2.2.3 consult "security reviews" --target claude
npx ecc-universal@2.2.3 install --profile minimal --target claude --with capability:machine-learning
npx ecc-universal@2.2.3 doctor --target kimi

npx ecc-install --profile minimal --target claude는 쓰지 마세요. ecc-install은 ecc-universal 안의 실행 파일 이름이지, 따로 공개된 npm 패키지가 아닙니다.

ECC는 cursor, antigravity, gemini, opencode, codebuddy, joycode, qwen, zed, hermes, openclaw용 고급 관리형 어댑터도 제공합니다. 이 대상들은 어댑터가 안내형 충돌 · 업데이트 · 복구 · 제거 수명 주기 검증을 통과하기 전까지는 문서에 적힌 ecc install --target ... 경로를 그대로 씁니다. 어느 마법사도 감지된 모든 하네스에 조용히 설치하지 않습니다.

하네스마다 한 경로만

Claude Code, Codex, 다른 하네스에서 ECC를 동시에 쓸 수 있습니다. 하네스마다 설치 방법은 하나만 고르세요.

  • 추천 기본값: 위의 안내형 Claude 플러그인 설치
  • Claude Code에서 쓸 수 있는 다른 방법: 기본 플러그인 명령
  • 2.2에서 가능: Claude Code, Codex, Kimi Code용 안내형 패키지 설치
  • 됩니다: Claude Code 플러그인 + Codex 네이티브 플러그인
  • 됩니다: Claude Code 플러그인 + 예전 방식의 Codex 동기화
  • 피하세요: Claude Code 플러그인 + Claude 수동 전체 설치
  • 피하세요: Codex 동기화 + Codex 마켓플레이스 플러그인

설치 방법을 겹쳐 쓰지 마세요. 같은 하네스에 ECC를 두 번 설치하면 스킬, 명령, 훅, 설정이 중복될 수 있습니다. 여러 하네스에 한 번씩 설치하는 것은 괜찮습니다.

이미 여러 방식을 겹쳐 설치해서 중복되어 보인다면 아래 「초기화 / 제거」로 바로 가세요.

설치에 문제가 있나요? 짧은 설치·실행 문제 양식을 열거나 ecc feedback을 실행하세요. ECC는 진단 자료를 자동으로 올리지 않습니다.

Claude Code 자세히

다른 방법으로, Claude Code 안에서 기본 플러그인 명령을 실행할 수 있습니다.

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

이 방법은 ECC의 스킬, 에이전트, 명령, 플러그인이 관리하는 훅을 설치합니다. 이 방법을 골랐다면 거기서 멈추세요. 그 위에 Claude Code 수동 전체 설치를 하지 마세요.

Claude Code가 이 기본 명령들을 소유하며, 마켓플레이스·플러그인·범위가 이미 있을 때 나는 오류도 Claude Code가 냅니다. ECC는 그 파서를 가로챌 수 없습니다. 두 명령 중 하나가 이미 설치되어 있다거나 범위가 충돌한다고 하면 2.2 안내형 설치를 쓰거나 충돌하는 Claude 플러그인 범위를 해결한 뒤 다시 시도하세요. 수동 설치를 겹쳐 하지 마세요.

ECC를 설치한 뒤에는 /ecc:configure-ecc가 Claude 안에서 쓰는 이름공간 재설정 스킬입니다. 같은 안전한 설치 흐름을 호출하지만 플러그인을 설치한 뒤에만 쓸 수 있고, 처음 설치할 때 Claude Code의 기본 /plugin 명령을 대신하지는 못합니다.

Claude Code 플러그인은 rules를 배포할 수 없으니, 실제로 쓸 규칙 묶음만 추가하세요.

git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/  # replace with your stack

rules/common과 실제로 쓰는 언어나 프레임워크 묶음 하나로 시작하세요. 플러그인을 설치했다면 그 뒤에 ./install.sh --profile full을 실행하지 마세요.

settings.json으로 설정하고 싶다면: 마켓플레이스를 선언형으로 추가

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

{
  "extraKnownMarketplaces": {
    "ecc": {
      "source": {
        "source": "github",
        "repo": "affaan-m/ECC"
      }
    }
  },
  "enabledPlugins": {
    "ecc@ecc": true
  }
}

위의 /plugin 명령 두 개와 같은 결과가 나옵니다.

이름과 이전 안내 (ecc@ecc, affaan-m/ECC, ecc-universal)

ECC에는 공개 식별자가 세 개 있고, 서로 바꿔 쓸 수 없습니다.

  • GitHub 소스 저장소: affaan-m/ECC
  • Claude 마켓플레이스/플러그인 식별자: ecc@ecc
  • npm 패키지: ecc-universal

의도된 구조입니다. Anthropic 마켓플레이스/플러그인 설치는 정식 플러그인 식별자를 기준으로 하므로, 엄격한 Desktop/API 검증기에서도 도구 이름과 슬래시 명령 이름공간이 짧게 유지되도록 ECC는 ecc@ecc를 씁니다. 예전 글에는 이전의 긴 마켓플레이스 식별자가 보일 수 있는데, 옛 별칭일 뿐입니다. 그와 별개로 npm 패키지는 ecc-universal로 남았으므로, npm 설치와 마켓플레이스 설치는 의도적으로 이름이 다릅니다.

npm 릴리스는 커밋마다가 아니라 버전 태그마다 나가므로, ecc-universal은 main에 올라오는 모든 푸시가 아니라 릴리스(2.1, 2.2, ...)를 따라갑니다. 최신 개발 상태가 필요하면 git으로 설치하세요.

로컬 Claude 설정이 지워지거나 초기화됐다고 해서 다시 구매해야 하는 것은 아닙니다. node scripts/ecc.js list-installed로 시작하고, 다시 설치하기 전에 node scripts/ecc.js doctor와 node scripts/ecc.js repair를 실행하세요. 보통 설정을 다시 만들지 않아도 ECC가 관리하는 파일이 복구됩니다.

Codex 앱과 CLI

요즘 Codex는 ECC를 네이티브 저장소 마켓플레이스 플러그인으로 설치할 수 있습니다. 마켓플레이스 항목은 저장소 루트를 쓰기 때문에, Codex 캐시가 매니페스트와 참조하는 모든 스킬, MCP 설정, 훅 런타임, 스크립트, 자산을 함께 받습니다.

codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
node scripts/codex/check-plugin-cache.js

두 add 명령은 여러 번 실행해도 같은 결과가 나옵니다. 나중에 새로 고치려면 codex plugin marketplace upgrade ecc를 실행한 뒤 codex plugin add ecc@ecc를 실행하세요. Codex는 활성 CODEX_HOME에 켜진 플러그인 상태를 하나만 저장하며, Claude의 user · project · local 범위는 없습니다. 네이티브 훅은 명시적인 신뢰 결정이 필요하고, Claude의 ECC 훅 프로필 4종을 쓰지 않습니다. Codex 안에서는 $configure-ecc로 제공자를 고려한 안내 흐름을 쓰세요.

예전 방식의 scripts/sync-ecc-to-codex.sh는 ~/.codex에 복사하고 병합한 설정이 꼭 필요한 사용자를 위한 지원 중단 예정 호환 옵션입니다. 네이티브 플러그인에는 필요하지 않습니다. 새 동기화는 소유권 매니페스트를 쓰므로 정리할 때 사용자가 수정한 파일이 보존됩니다. 먼저 Codex를 한 번 실행해 ~/.codex/config.toml이 있게 한 뒤 이렇게 하세요.

git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
bash scripts/sync-ecc-to-codex.sh

Codex 대화나 네이티브 플러그인 캐시를 건드리지 않고 그 예전 계층을 살펴보거나 제거하려면:

node scripts/ecc.js uninstall --legacy-codex-sync --dry-run
node scripts/ecc.js uninstall --legacy-codex-sync

매니페스트가 생기기 전의 설치는 보수적으로 처리합니다. ECC가 표시해 둔 AGENTS.md 블록은 지우지만, 자기 것임을 증명할 수 없는 복사 파일은 보존하고 검토하도록 알려 줍니다.

ECC 저장소를 Codex에서 직접 열어 프로젝트 로컬로 설정할 수도 있습니다. Codex는 전역 동기화 없이 루트 AGENTS.md와 .codex/의 신뢰한 프로젝트 설정을 읽습니다. 동기화 흐름 위에 네이티브 마켓플레이스 플러그인을 더하지 마세요.

저장소 탐색, 표면별 소유, PR diff 안내는 Codex ECC 탐색 지도를 읽으세요. 네이티브 수명 주기 설명은 .codex 플러그인 안내를 보세요.

Qoder CLI와 IDE

ECC는 기본 스킬, 에이전트, 예전 명령 단축 95개, 버전을 고정한 chrome-devtools MCP 정의를 재사용하는 네이티브 Qoder 플러그인을 제공합니다. 검토한 체크아웃에서 Qoder CLI로 검증하고 설치하세요.

qoder plugins validate . --strict
qoder plugins install .
qoder plugins list

Qoder IDE에서는 저장소 루트의 ZIP을 올리세요. ZIP 루트에 .qoder-plugin/과 함께 skills/, agents/, commands/, hooks/, scripts/, .mcp.json이 있어야 합니다. 매니페스트 폴더만, 또는 SKILL.md 하나만 올리면 필요한 리소스가 빠집니다.

Node.js 18 이상이라는 통합 요구 사항은 Qoder의 비대화형 훅 환경에도 적용됩니다. MCP 서버도 처음 쓸 때 npx와 네트워크 접근이 필요합니다. Qoder는 QODER_PLUGIN_ROOT와 exec 형식 인자를 쓰는 검토된 크로스 플랫폼 SessionStart 부트스트랩 하나를 받습니다. ECC는 Claude 훅 프로필 전체를 Qoder에 복사하지 않습니다. 차단형 도구 훅, 비동기 종료 작업, Claude 전용 매처는 이 초기 네이티브 통합 범위 밖입니다. 정확한 경계는 .qoder-plugin 안내를 보세요.

다른 에이전트와 에디터

Cursor, OpenCode, Gemini, Zed, Antigravity, Qwen, Hermes, OpenClaw, Kimi, CodeBuddy, JoyCode, Copilot

ECC를 한 번 받은 뒤 쓰는 하네스에 맞는 대상을 고르세요.

git clone https://github.com/affaan-m/ECC.git
cd ECC
하네스설치 또는 설정비고
Cursor./install.sh --profile minimal --target cursor프로젝트 로컬 .cursor/ 어댑터
OpenCodenpm install && npm run build:opencode && ./install.sh --profile full --target opencode --enable-hooks전체 설치 전에 플러그인 페이로드를 빌드
Gemini CLI./install.sh --profile minimal --target gemini프로젝트 로컬 .gemini/ 설정
Zed./install.sh --profile minimal --target zed프로젝트 로컬 .zed/ 어댑터
Antigravity./install.sh --profile minimal --target antigravityAntigravity 가이드 참고
Qwen CLI./install.sh --profile minimal --target qwenQwen 가이드 참고
Hermes./install.sh --profile minimal --target hermesHermes 설정 가이드 참고
OpenClaw./install.sh --profile minimal --target openclaw관리되는 홈 디렉터리 설치
Kimi Code CLI./install.sh --profile minimal --target kimi프로젝트 로컬 .kimi-code/ 설치 · Kimi Code 받기
CodeBuddy./install.sh --profile minimal --target codebuddy프로젝트 로컬 .codebuddy/ 설치
JoyCode./install.sh --profile minimal --target joycode프로젝트 로컬 .joycode/ 설치
GitHub Copilot./install.sh --profile full --target copilotCopilot CLI용으로 스킬은 .github/skills/에, 에이전트는 .github/agents/에 설치

GitHub Copilot 지원은 이 저장소에 이미 들어 있습니다. .github/copilot-instructions.md가 지침 계층을 제공하고, .github/prompts/에 재사용 가능한 /plan, /tdd, /security-review, /build-fix, /refactor 프롬프트가 있으며, .vscode/settings.json이 chat.promptFiles를 켭니다. GitHub Copilot CLI는 설정 없이 단순 클론만으로도 .agents/skills/ 부분 집합을 찾아냅니다.

ECC 네이티브 대상이 없는 하네스에는 수동 적용 가이드를 쓰세요. 훅이나 네이티브 스킬 탐색이 있는 척하지 않고, 몇 가지 ECC 스킬과 워크플로 지침을 채팅형 도구로 옮기는 방법을 설명합니다.

Cursor는 에이전트 정의를 .cursor/agents/ecc-*.md에 설치합니다. Cursor 네이티브 로딩 동작은 Cursor 빌드에 따라 다를 수 있습니다. ECC는 루트 AGENTS.md를 .cursor/에 설치하지 않으며, 어댑터는 Cursor의 컨텍스트를 네이티브 규칙과 에이전트 표면 안으로 한정합니다.

고급 설치 옵션

컨텍스트를 아끼는 설치 (훅 런타임 없음)

ECC의 규칙, 에이전트, 명령, 플랫폼 설정, 핵심 워크플로는 쓰되 런타임 훅은 쓰고 싶지 않을 때 쓰세요.

npx ecc-universal@2.2.3 install --profile minimal --target claude

소스 체크아웃에서는 같은 명령이 이렇습니다.

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

Windows:

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

이 프로필은 hooks-runtime을 의도적으로 뺍니다.

Claude 수동 설치는 각 스킬을 ~/.claude/skills/<스킬 이름>/(claude-project는 .claude/skills/<스킬 이름>/)에 바로 놓아 Claude Code가 찾을 수 있게 합니다. 예전 ECC 수동 설치를 올릴 때, 설치기는 ECC 설치 상태에 기록된 중첩 skills/ecc/ 파일만 옮깁니다. 평평한 스킬 디렉터리가 사용자 소유이면 ECC는 그것을 보존하고 충돌 경고를 출력하며, 안전하게 제거할 수 있도록 예전에 관리하던 사본을 계속 추적합니다.

훅을 끈 일반 core 프로필은 이렇게 설치합니다.

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

훅 런타임은 원할 때 나중에 추가하세요.

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

프로필이나 모듈이 훅 런타임을 만들어 내는 설치는 명시적인 결정이 필요합니다. --enable-hooks나 --no-hooks 없이 실행하면 설치기가 훅이 무엇을 할 수 있는지 출력하고, 아무것도 쓰기 전에 멈춥니다. 안내형 설치(ecc install --guided)는 이 선택을 대화로 묻습니다.

필요한 구성 요소만 고르기

포장된 조언 도구에게 내 작업에 맞는 구성 요소를 물어보세요.

node scripts/ecc.js consult "security reviews" --target claude

맞는 구성 요소, 관련 프로필, 미리 보기·설치 명령을 돌려줍니다. 정확한 파일 계획을 확인하고 싶다면 설치하기 전에 미리 보기 명령을 쓰세요.

스킬이나 기능을 직접 지정해서 설치할 수도 있습니다.

./install.sh --target claude --skills tdd-workflow,security-review
node scripts/ecc.js install --profile minimal --target claude --with capability:machine-learning

구성 요소를 하나씩 직접 복사해도 됩니다. 각 구성 요소는 완전히 독립적입니다.

# Just agents
mkdir -p ~/.claude/agents
cp agents/*.md ~/.claude/agents/

# Rules directories (common + language-specific)
mkdir -p ~/.claude/rules/ecc
cp -r rules/common ~/.claude/rules/ecc/
cp -r rules/typescript ~/.claude/rules/ecc/   # pick your stack

# Core/general skills only (Claude Code loads skills from direct children
# of ~/.claude/skills; do not nest manual installs under ~/.claude/skills/ecc/)
mkdir -p ~/.claude/skills
cp -r .agents/skills/* ~/.claude/skills/
cp -r skills/search-first ~/.claude/skills/

# Optional: maintained slash-command compatibility during migration
mkdir -p ~/.claude/commands
cp commands/*.md ~/.claude/commands/

은퇴한 단축 명령은 legacy-command-shims/에 있습니다. /tdd 같은 옛 이름이 아직 필요할 때만 거기서 개별 파일을 복사하세요.

전역 규칙 대신 프로젝트 로컬 규칙

ECC 표준을 모든 Claude Code 세션이 아니라 저장소 하나에만 적용하고 싶을 때 프로젝트 로컬 규칙을 쓰세요.

cd your-project
mkdir -p .claude/rules/ecc
cp -R /path/to/ECC/rules/common .claude/rules/ecc/
cp -R /path/to/ECC/rules/typescript .claude/rules/ecc/

규칙은 항상 로드되는 컨텍스트이므로, common과 실제로 쓰는 스택 묶음 하나로 시작하세요. 규칙을 직접 복사할 때는 안의 파일이 아니라 언어 디렉터리 전체(예: rules/common, rules/golang)를 복사해야 상대 참조가 유지되고 파일 이름이 겹치지 않습니다.

Claude 수동 전체 설치

플러그인 경로를 일부러 건너뛸 때만 쓰세요.

git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile full --enable-hooks

Windows:

git clone https://github.com/affaan-m/ECC.git
cd ECC
.\install.ps1 --profile full --enable-hooks

이 예시는 자동 훅 런타임을 켭니다. 훅 없이 설치하려면 --enable-hooks를 --no-hooks로 바꾸세요.

이 경로를 골랐다면 거기서 멈추세요. /plugin install을 함께 실행하지 마세요.

직접 고른 수동 설치에서 Claude는 스킬을 ~/.claude/skills/의 바로 아래 자식으로 찾습니다. ~/.claude/skills/ecc/ 아래에 중첩하지 마세요.

훅 설치

저장소의 원본 hooks/hooks.json을 ~/.claude/settings.json이나 ~/.claude/hooks/hooks.json에 복사하지 마세요. 그 파일은 플러그인/저장소용이므로, 훅 명령 경로가 올바르게 고쳐지도록 설치기를 쓰세요.

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

이 명령은 훅 스크립트를 ~/.claude/ 아래에 설치하고 확정된 훅 항목을 ~/.claude/settings.json에 등록합니다. 기존 사용자 설정과 훅은 보존되고, ECC 소유 항목은 고유 ID로 추적되므로 여러 번 실행해도 같은 결과가 나오고 안전하게 제거할 수 있습니다.

/plugin install로 ECC를 설치했다면 그 훅을 settings.json에 복사하지 마세요. Claude Code v2.1 이상은 이미 플러그인의 hooks/hooks.json을 자동으로 읽으므로, settings.json에 중복하면 훅이 두 번 실행되고 플랫폼 간 훅 충돌이 생깁니다.

Windows에서 Claude 설정 루트는 %USERPROFILE%\.claude입니다. 훅 런타임은 이렇게 설치하세요.

pwsh -File .\install.ps1 --target claude --modules hooks-runtime --enable-hooks

MCP 설정

Claude 플러그인 설치는 ECC에 들어 있는 MCP 서버 정의를 일부러 자동으로 켜지 않습니다. 엄격한 제3자 게이트웨이에서 플러그인 MCP 도구 이름이 너무 길어지는 문제를 피하면서도 수동 MCP 설정은 쓸 수 있게 하려는 것입니다.

실행 중인 Claude Code 서버를 바꾸려면 Claude Code의 /mcp 명령이나 CLI로 관리하는 MCP 설정을 쓰세요. Claude Code는 그 선택을 ~/.claude.json에 저장합니다. 저장소 로컬 MCP 접근은 mcp-configs/mcp-servers.json에서 원하는 MCP 서버 정의를 프로젝트 범위 .mcp.json으로 복사하세요.

ECC가 기본으로 제공하는 커넥터는 정확히 하나(chrome-devtools)이고, 나머지는 CLI/REST API를 감싼 스킬이거나 선택해서 쓰는 목록 항목입니다. 이 규칙과 이전 기본값 6개를 없앤 2026년 6월 감사는 docs/MCP-CONNECTOR-POLICY.md에 있습니다.

ECC에 들어 있는 MCP를 이미 직접 돌리고 있다면 이렇게 설정하세요.

export ECC_DISABLED_MCPS="chrome-devtools"

ECC가 관리하는 설치와 Codex 동기화 흐름은 중복을 다시 추가하지 않고 그 번들 서버를 건너뛰거나 제거합니다. ECC_DISABLED_MCPS는 ECC 설치/동기화 필터이지, 실행 중인 Claude Code의 토글이 아닙니다.

중요: YOUR_*_HERE 자리 표시는 실제 API 키로 바꾸세요.

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

multi-* 명령은 기본 플러그인/규칙 설치에 포함되지 않습니다.

/multi-plan, /multi-execute, /multi-backend, /multi-frontend, /multi-workflow를 쓰려면 ccg-workflow 런타임도 설치해야 합니다. CCG 설치 가이드에서 정확한 릴리스를 골라 검토한 뒤, 설치한 런타임을 초기화하세요. ECC는 CCG를 번들하지 않으며 호환되고 감사된 CCG 릴리스를 보증하지도 않습니다. 이 가이드는 특정하지 않은 레지스트리 버전을 부트스트랩하지 않습니다.

그 런타임이 이 명령들이 기대하는 외부 의존성을 제공합니다.

  • ~/.claude/bin/codeagent-wrapper
  • ~/.claude/.ccg/prompts/*

ccg-workflow 없이는 이 multi-* 명령이 제대로 동작하지 않습니다.

Astra 리뷰는 Codex CLI가 필요합니다

/astra-review는 Claude가 쓴 코드를 독립적인 다른 제공자의 리뷰를 받도록 GPT-6-Astra에 보냅니다. 로컬에 설치된 Codex CLI를 ChatGPT 로그인(codex login)으로 실행하므로 OpenAI API 키는 필요 없고, 환경 변수의 API 키는 전달되지 않습니다. 명령을 호출하는 것이 그 diff를 OpenAI에 보내는 것에 동의한다는 뜻입니다. 설정, 범위, 푸시 게이트, 문제 해결은 Astra 리뷰 가이드에 있습니다.

초기화 / 제거

통합 패키지로 설치했다면, 설치할 때 쓴 같은 프로젝트 디렉터리에서 이 명령을 실행하세요.

npx ecc-universal@2.2.3 list-installed
npx ecc-universal@2.2.3 doctor
npx ecc-universal@2.2.3 repair
npx ecc-universal@2.2.3 uninstall --dry-run
npx ecc-universal@2.2.3 uninstall

소스 체크아웃에서는 다시 설치하기 전에 관리되는 상태를 확인하세요.

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run

소스 체크아웃에서 직접 제거하려면:

node scripts/uninstall.js --dry-run
node scripts/uninstall.js

떠나는 경우 제거 명령이 선택 사항인 20초 피드백 양식을 출력합니다. 공개 GitHub 이슈이고, 제거를 막지 않으며, ECC는 진단 자료를 올리지 않습니다. 언제든 ecc feedback을 실행하면 문제 · 피드백 · 기능 요청 경로를 볼 수 있습니다.

플러그인 사용자는 Claude Code에서 플러그인을 제거한 뒤, 직접 복사해서 더는 필요 없는 규칙 폴더만 지우세요. ECC는 설치 상태에 기록된 파일만 지우며, 하네스 디렉터리의 관련 없는 파일은 건드리지 않습니다.

방법을 겹쳐 썼다면 이 순서로 정리하세요.

  1. Claude Code 플러그인 설치를 제거합니다.
  2. 관리되는 설치 상태가 있는 프로젝트 디렉터리에서 ECC 제거 명령을 실행합니다.
  3. 직접 복사했고 더는 필요 없는 규칙 폴더를 지웁니다.
  4. 한 가지 경로만 써서 한 번 다시 설치합니다.

ECC 사용 시작

전체 목록이 아니라 필요한 워크플로부터 시작하세요.

하려는 일여기서 시작
기능 만들기/ecc:plan "기능 설명", 이어서 tdd-workflow
버그 고치기실패하는 테스트로 재현한 뒤 tdd-workflow
새 코드 리뷰새 컨텍스트 리뷰를 위한 /code-review
GitHub 이슈 분류/ecc:issue-review <이슈>(플러그인) 또는 /issue-review <이슈>(수동 설치)로 코드와 대조해 검증하고 답변 초안 작성
빌드 고치기/build-fix
코드베이스 정리/refactor-clean
컨텍스트 압박 확인/context-budget
긴 세션 마무리/save-session 또는 /learn-eval
나중에 이어서 하기/resume-session
에이전트 설정 감사검토한 스캐너로 /security-scan, 또는 설치한 agentshield scan --path .

플러그인 명령과 수동 설치 명령

Claude Code 플러그인 명령은 이름공간이 붙은 형태를 씁니다.

/ecc:plan "Add authentication"

수동 설치는 더 짧은 호환 형태를 제공할 수 있습니다.

/plan "Add authentication"

스킬이 기본 워크플로 표면이고, 명령은 편의 진입점이자 호환 단축으로 남아 있습니다. 무엇이 설치됐는지는 이렇게 확인하세요.

/plugin list ecc@ecc

어떤 에이전트를 써야 하나요?

스킬이 표준 워크플로 표면이고, 명령 중심 워크플로를 위해 관리되는 슬래시 항목도 계속 남아 있습니다.

하고 싶은 일쓰는 표면쓰이는 에이전트
새 기능 계획/ecc:plan "Add auth"planner
시스템 아키텍처 설계/ecc:plan + architect 에이전트architect
테스트를 먼저 쓰며 코드 작성tdd-workflow 스킬tdd-guide
방금 쓴 코드 리뷰/code-reviewcode-reviewer
GitHub 이슈 리뷰/ecc:issue-review(플러그인), /issue-review(수동 설치)— (issue-review 스킬)
실패하는 빌드 고치기/build-fixbuild-error-resolver
엔드투엔드 테스트 실행e2e-testing 스킬e2e-runner
보안 취약점 찾기/security-scansecurity-reviewer
죽은 코드 제거/refactor-cleanrefactor-cleaner
문서 갱신/update-docsdoc-updater
Go 코드 리뷰/go-reviewgo-reviewer
Python 코드 리뷰/python-reviewpython-reviewer
F# 코드 리뷰(fsharp-reviewer를 직접 호출)fsharp-reviewer
TypeScript/JavaScript 코드 리뷰(typescript-reviewer를 직접 호출)typescript-reviewer
HarmonyOS 앱 개발(harmonyos-app-resolver를 직접 호출)harmonyos-app-resolver
데이터베이스 쿼리 감사(자동 위임)database-reviewer
운영용 ML 변경 리뷰mle-workflow 스킬 + mle-reviewer 에이전트mle-reviewer

자주 쓰는 워크플로

슬래시 형태는 관리되는 명령 표면에 남아 있는 것만 보여 줍니다. /tdd, /eval 같은 은퇴한 짧은 이름 단축은 명시적으로 선택할 때만 쓰도록 legacy-command-shims/에 있습니다.

새 기능 시작:

/ecc: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

자체 호스팅 모델과 커스텀 엔드포인트

ECC는 각 하네스의 평소 설정을 통해 동작하므로, ECC의 워크플로를 바꾸지 않고도 공식 제공자, 호환되는 커스텀 API 엔드포인트나 모델 게이트웨이, 자체 호스팅 모델을 쓸 수 있습니다.

Claude Code에서 ECC는 Anthropic이 호스팅하는 전송 설정을 하드코딩하지 않습니다. 최소한의 게이트웨이 예시는 이렇습니다.

export ANTHROPIC_BASE_URL=https://your-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=your-token
claude

게이트웨이가 모델 이름을 바꿔 매핑한다면 ECC가 아니라 Claude Code에서 설정하세요. claude CLI가 이미 동작한다면 ECC의 훅, 스킬, 명령, 규칙은 모델 제공자와 무관합니다. Anthropic의 LLM 게이트웨이 문서와 모델 설정 문서를 보세요.

오픈소스 모델은 별도의 컴퓨팅과 서빙 환경으로 그 게이트웨이 뒤에 띄우거나 직접 호스팅하세요. GPU가 필요하다면 Itô가 ECC가 선호하는 컴퓨팅 후원사이고, 어떤 GPU 제공자든 괜찮습니다. 후원 링크는 수동적입니다. RFQ를 호출하거나 용량을 예약하거나 컴퓨팅을 준비하거나 서빙을 설정하지 않습니다. 이와 별개로 ecc ito find는 명시적으로 설정한 정식 Itô CLI를 호출해 인증된 실제 RFQ를 제출하지만, 용량을 예약하지는 않습니다. Itô를 통한 관리형 추론은 아직 서비스 중이 아닙니다.

ECC + Itô 컴퓨팅으로 Kimi 자체 호스팅

Kimi Code 하네스와 모델 서빙 계층은 별개입니다. ECC는 에이전트 하네스를 설정하고, 사용자는 API 엔드포인트(Kimi API 키 받기)를 가져오거나 직접 가진 GPU 용량에 오픈 가중치 Kimi 모델을 자체 호스팅합니다. 이 어댑터는 Kimi Code 0.31.x(@moonshot-ai/kimi-code)에서 검증됐습니다.

  1. GPU 용량 확보: Itô나 아무 GPU 제공자를 쓰세요.
  2. Kimi 서빙: 고른 체크포인트를 호환되는 엔드포인트로 노출하세요.
  3. ECC로 Kimi Code 실행: 프로젝트 지침과 스킬을 설치한 뒤 Kimi Code를 시작하세요.

Kimi Code의 공식 제공자 가이드로 엔드포인트를 설정한 뒤 ECC를 설치하세요.

bash ./install.sh --target kimi --profile minimal
node scripts/ecc.js doctor --target kimi
kimi

Kimi Code는 설치된 .kimi-code/AGENTS.md 지침과 .kimi-code/skills/ 워크플로를 네이티브로 찾으며, 프로젝트 수준 .agents/skills/도 공식 탐색 위치입니다. ECC는 프로젝트 MCP 항목을 .kimi-code/mcp.json에 안전하게 병합하고 사용자 수준 ~/.kimi-code/config.toml은 바꾸지 않습니다. Kimi Code는 네이티브 훅을 지원하지만 ECC의 지금 관리형 프로젝트 어댑터는 그것을 설정하지 않으므로, 이 설치기는 Kimi 훅 프로필을 제공하지 않습니다. 설치기 dry-run과 회귀 테스트가 관리되는 모든 Kimi 쓰기가 프로젝트 로컬 .kimi-code/ 루트 안에 머무는지 검증합니다.

Itô 컴퓨팅 CLI 브리지

ecc ito는 따로 설치한 정식 Itô 클라이언트에 위임합니다. ECC는 두 번째 API 클라이언트를 유지하지 않습니다. ecc ito login [--no-browser]는 기기 인증을 수행하고, 기본적으로 Itô 인증 페이지를 열며, 기기 토큰을 macOS 키체인에 저장합니다. --no-browser는 페이지 열기를 막습니다. ECC 자체는 브라우저 자동화를 하지 않습니다. ecc ito auth는 검증 전용이며 --no-browser를 거부합니다. 쓸 수 있는 동작은 ecc ito login, ecc ito auth, ecc ito find, ecc ito status, 별도로 제한된 ecc ito evals입니다. 대응하는 MCP 도구는 ito_auth, ito_find, ito_status로 남아 있고, ito_auth는 기존 자격 증명을 검증하며 노드 자격 확인은 CLI 전용입니다.

ito-compute-cli 패키지는 아직 공개되지 않았습니다. Itô 런타임 저장소(데스크가 강화되는 동안 비공개이며 디자인 파트너가 접근)의 cli/ito-compute-cli에서 로컬로 빌드하고, npm ci와 npm run check를 실행한 뒤, ECC_ITO_CLI_EXECUTABLE을 그 빌드의 dist/bin/ito.js 절대 경로로 설정하세요. 로그인은 ITO_API_KEY를 물려받지 않고, auth · find · status는 설정돼 있으면 ITO_API_KEY를 직접 전달하며, ITO_AUTH_MODE=legacy는 필요 없습니다. ecc ito logout은 현재 기기 자격 증명을 폐기하고, 원격 폐기를 확인하지 못하면 로컬 사본을 보존합니다. 기기 토큰은 기본으로 macOS 키체인을 쓰며, 명시적인 파일 대체 저장은 소유자 전용 디렉터리/파일 권한을 유지해야 합니다. ECC는 자격 증명을 다루는 이 클라이언트를 PATH에서 찾지 않습니다. RFQ 권한과 MCP 설정의 전체 규약은 ito-compute 스킬을 보세요.

find는 인증된 실제 RFQ를 제출하지만 용량을 예약하지는 않습니다. evals는 ITO_ENABLE_SIXTYTWO_LIVE=1과 --live-sixtytwo가 모두 있어야 하고, 따로 설치한 sixtytwo-cli==0.3.33, 명시적인 노드 목록, 이미 있는 절대 경로 설정 디렉터리가 필요합니다. 임대, 시작, 복구, 수리, 구매는 할 수 없습니다. ECC는 견적 잠금, 구매, 워크로드, 추론 경로를 제공하지 않으며, 클라이언트가 없거나 실제 호출이 실패했을 때 로컬 결과로 대체하지도 않습니다.

새 소식

현재 릴리스: 2.2.3(2026-10-01). 2.2 계열의 주요 내용은 이렇습니다.

  • Claude Code, Codex, Kimi Code 전반의 안내형 매니페스트 기반 설치와 설치 상태 소유권, doctor, repair, uninstall
  • 네이티브 Antigravity 설치, 얇은 Pi 어댑터, Linux · macOS · Windows에서 테스트한 패키지 산출물 릴리스 게이트
  • Plan Canvas 브라우저 리뷰, 통합 기억 저장소(ecc memory), Itô 컴퓨팅 스킬 모음

전체 이력은 CHANGELOG.md에 있고, 릴리스별 노트와 근거는 docs/releases/에 있습니다.

v2.0.0: 에이전트 하네스 운영체제 (2026년 6월)

2.0 계열의 안정판 졸업입니다. 컨트롤 페인 기반, 워크트리 수명 주기 서비스, orch-* 오케스트레이터 모음, Discord 커뮤니티가 들어 있습니다. 노트: docs/releases/2.0.0/release-notes.md.

안에 든 것

ECC/
|-- agents/           # 71 specialized subagents for delegation
|-- skills/           # 314 reusable workflows loaded on demand
|-- commands/         # 98 maintained slash-command shims
|-- rules/            # opt-in common and language standards
|-- hooks/            # runtime automation and enforcement
|-- scripts/          # install, repair, sync, orchestration, and checks
|-- .claude-plugin/   # Claude Code marketplace manifest
|-- .codex/           # Codex reference configuration and agent roles
|-- .opencode/        # OpenCode plugin, commands, and instructions
|-- .cursor/          # Cursor rules and hook adapter
|-- docs/             # public setup, architecture, and operating guides

루트가 원본입니다. 플랫폼 어댑터는 별도 사본을 두지 않고 이 워크플로를 포장하거나 연결합니다.

가이드

ECC 약식 가이드 ECC 장문 가이드 ECC 보안 가이드

더 알아보기

  • 지원 플랫폼 표, 에이전트 · 스킬 · 명령 전체 목록, 지속 학습, AgentShield 보안 스캔, 기여 방법, 후원 안내는 원문 README를 보세요.
  • 웹사이트: ecc.tools
  • 스타 기록: 스타 기록

라이선스

MIT 라이선스입니다(저장소 LICENSE 파일 기준).

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0