리본랩스 스킬팩
ECC · 에이전트 하네스 · 클로드 코드

클로드한테 매번 하던 설명,
한 번 깔면 끝.

ECC 는 계획 → 테스트 → 리뷰 → 기억 개발 순서를 클로드 코드에 통째로 넣어 두는 오픈소스입니다. 에이전트 68 · 스킬 292 · 명령 94 에 훅·룰·메모리까지 — 기능은 플래너가 계획하고, 짠 코드는 리뷰어가 새 맥락에서 다시 봅니다. 한 줄로 붙이되, 겹치지 않게 붙여 드립니다.

ECC 는 Affaan Mustafa(affaan-m) 의 오픈소스(MIT)입니다 — 우리가 만든 것이 아니고 제휴 관계도 없습니다. 우리가 만든 것은 설치기와 한국어 안내뿐입니다. GitHub 스타 257,770 · 포크 38,551 (2026-09-14 확인)

★겹쳐 깔기

까는 길이 셋이고, 둘을 겹치면 두 번 들어갑니다

ECC 는 클로드 코드에 붙이는 공식 길이 여럿입니다. 원저자 README 는 「같은 곳에 두 번 깔지 마라 — 스킬·명령·훅·설정이 중복될 수 있다」고 적고, 플러그인 + 수동 전체 설치 조합을 피하라고 적습니다.

어느 길로 이미 깔려 있는지는 따로 찾아보지 않으면 모른다. 예전에 한 설치를 잊고 다른 길로 또 깔기 쉽다. 그래서 기계가 잽니다.

노드 18 이상

원저자 패키지 ecc-universal 이 노드 18 이상을 요구한다. 낮으면 설치 명령이 시작부터 막힌다.

어떻게 재나 process.versions.node 를 읽어 잰다

Git

클로드 플러그인 설치는 Git 이 PATH 에 있어야 한다(README).

어떻게 재나 git --version 을 불러 본다. 못 부르면 「없다」가 아니라 「못 쟀다」다

클로드 코드 2.1 이상

플러그인 설치는 클로드 코드 2.1 이상이 필요하다(README). 낮으면 안내 설치가 플러그인을 못 건다.

어떻게 재나 claude --version 의 판 숫자를 읽는다. 못 부르거나 못 읽으면 「못 쟀다」다

플러그인 설치

ecc@ecc 가 이미 있으면 새로 까는 게 아니라 갱신이다. 옛 이름(everything-claude-code)으로만 깔려 있는 경우도 있다.

어떻게 재나 클로드 코드 설정 폴더의 plugins/installed_plugins.json 과 settings.json(홈·현재 폴더)의 enabledPlugins 에서 ecc@ecc 또는 옛 이름을 찾는다

수동 설치

수동 설치가 있는데 플러그인을 얹으면 겹친다. README 가 피하라고 적은 조합이다.

어떻게 재나 ~/.claude/ecc/install-state.json(CLAUDE_CONFIG_DIR 이 있으면 그 폴더도)이 있는지 본다

겹쳐 깔기

가장 많이 막히는 자리다. 플러그인과 수동 설치가 동시에 있으면 같은 스킬·명령·훅이 두 번 들어갈 수 있다.

어떻게 재나 플러그인 기록과 수동 설치 기록이 동시에 있는지 본다. 있으면 더 얹지 않고 README 의 Reset / Uninstall 절차로 안내한다

못 잰 칸은 「없다」가 아니라 「못 쟀다」고 말합니다. 그 둘은 다른 이야기입니다.

다섯 걸음

무엇을 하면 되나

1
먼저 잰다 — 아무것도 안 깔고

npx --yes reborn-ecc --check 가 이 컴퓨터에서 여섯 칸을 실제로 잽니다. 특히 이미 플러그인이나 수동 설치가 들어가 있지 않은지 봅니다.

2
깐다 — 원저자 공식 설치기 그대로

겹칠 조합이 아니면 설치기가 원저자의 공식 안내 설치를 그대로 부릅니다.npx -y ecc-universal@2.2.1 setup수동 설치 기록이 있으면 플러그인을 얹지 않고 멈춥니다.

3
안내 화면에서 고른다

설치 범위(user · project · local)와 훅 프로필을 고릅니다. 훅 없이 가볍게 가려면 npx --yes reborn-ecc --minimal 입니다.

4
클로드 코드를 껐다 켠다

스킬 목록은 켤 때 읽습니다. 방금 깔고 바로 부르면 안 보이는 게 정상입니다.

5
겹치지 않았는지 다시 본다

끝나면 설치기가 명령의 성공 표시를 믿지 않고 플러그인 기록과 수동 설치 기록을 다시 봅니다.

무엇이 들어오나

에이전트 · 스킬 · 명령

에이전트 하네스 성능 최적화 시스템 — 스킬·인스팅트·메모리·보안·리서치 우선 개발을 클로드 코드·코덱스·오픈코드·커서 등에 붙인다.

에이전트 68계획·리뷰·빌드 수리·보안·아키텍처·도메인 작업용 전문 에이전트
스킬 292클로드 코드가 필요할 때 불러 쓰는 작업 절차
명령 94옛 슬래시 명령을 잇는 명령 심(legacy command shims)
그 밖에훅 · 룰 · 메모리 · 지속 학습 · AgentShield 보안 스캔
공식 길 셋

하나만 고릅니다

안내 설치 — 원저자 권장npx ecc-universal@2.2.1 setup · 플러그인 ecc@ecc 를 범위와 훅 프로필을 골라 겁니다.
훅 없이 가볍게npx ecc-universal@2.2.1 install --profile minimal --target claude · 룰·에이전트·명령·핵심 흐름만. hooks-runtime 을 뺍니다.
클로드 코드 안에서/plugin marketplace add https://github.com/affaan-m/ECC → /plugin install ecc@ecc · 이 길을 골랐으면 거기서 멈춥니다.
받는 법

한 줄이면 됩니다

ECC 는 원저자 공식 설치기(ecc-universal)로 받고, 한국어 안내는 ~/.claude/skills/ecc-ko-guide 에 넣습니다. 깔기 전에 --check 로 먼저 재 볼 수 있습니다.

클로드 코드에서 바로 실행하기

터미널을 따로 열지 않아도 됩니다. 클로드 코드 안에서 둘 중 하나면 됩니다.

1
명령 앞에 ! 붙이기 — 제일 확실합니다
!npx --yes reborn-ecc
맨 앞의 ! 까지 함께 붙여넣으세요. 클로드를 거치지 않고 곧장 설치가 돕니다.
중간의 --yes 도 빼지 마세요 — 이게 없으면 «받아도 되나요?» 하고 묻는 자리에서 아무 말 없이 멈춥니다.
2
클로드에게 그냥 말하기
reborn-ecc 설치해줘
클로드가 명령을 대신 돌리고, 막히면 이유까지 봐 줍니다.
3
둘 다 안 되면 검은 창에서 — 클로드를 아예 거치지 않습니다
npx --yes reborn-ecc
윈도우 — 윈도우키를 누르고 cmd 라고 친 뒤 엔터. 맥 — command+스페이스 누르고 터미널 엔터.
어느 폴더에서 하셔도 상관없습니다 — 스킬은 항상 내 계정 폴더(~/.claude/skills)에 깔립니다. 여기서는 ! 를 빼세요.

먼저 컴퓨터에 Node.js 가 있어야 합니다. 없으면 위 명령이 아예 안 뜁니다 — nodejs.org 에서 큰 초록 버튼을 누르고 계속 «다음»만 누르시면 됩니다(3분). 클로드 코드를 쓰고 계시면 이미 있습니다.
클로드가 “실행하지 않겠습니다”라고 하면 1번을 쓰세요. 이제 막 나온 설치기라 클로드가 낯선 것으로 보고 막는 것이고, 그 판단 자체는 옳습니다. ! 를 붙이면 클로드에게 부탁하지 않고 바로 돌아갑니다.
폰이나 브라우저의 클로드 화면에서는 안 됩니다 — 그 창은 인터넷 저쪽의 임시 서버라 깔아도 내 컴퓨터에 남지 않습니다. 내 컴퓨터의 클로드 코드나 터미널에서 해 주세요.

깐 뒤 클로드 코드를 다시 열어야 스킬이 잡힙니다. 그다음 「ECC 로 뭘 할 수 있는지 알려줘」라고 하면 됩니다.

알아 둘 것

깔기 전에 알면 덜 헤매는 것

판 고정은 보안 감사가 아닙니다명령에 붙은 @2.2.1 은 판을 고르는 것이지 보안 감사나 무결성 검사가 아니다 — 원저자가 README 에 직접 적었다
룰은 플러그인으로 오지 않습니다클로드 플러그인은 rules 를 배포하지 못한다. 룰은 쓰는 것만 손으로 ~/.claude/rules/ecc/ 에 복사한다 — rules/common 에 쓰는 언어 하나부터
ecc-install 은 패키지가 아닙니다ecc-install 은 따로 발행된 npm 패키지가 아니다 — ecc-universal 안의 실행 이름이다. npx ecc-install 로 부르면 안 된다(README)
multi-* 명령은 따로입니다multi-* 명령(/multi-plan 등)은 기본 설치로 안 된다. ccg-workflow 를 따로 깔아야 한다
세 이름저장소 affaan-m/ECC · 플러그인 ecc@ecc · npm ecc-universal — 셋은 서로 바꿔 쓸 수 없다
진단 정보ECC 는 진단 정보를 자동으로 올리지 않는다
되는 곳Claude Code · Codex · Kimi Code · Cursor · OpenCode · Gemini CLI
말하지 않는 것

재 본 적 없는 값은 적지 않습니다

아래는 우리가 일부러 비워 둔 칸입니다.

몇 배 빨라진다 · 토큰이 몇 % 준다우리가 잰 적이 없다. 작업과 모델에 따라 다르다.
292개 스킬을 다 깔아야 한다 · 다 쓰인다원저자도 룰은 쓰는 것만 담으라고 적는다. 필요한 만큼 고른다.
깔면 보안이 보장된다AgentShield 는 스캔 도구다. 판 고정도 보안 감사가 아니라고 원저자가 적었다.
우리가 ECC 를 고치거나 새 판을 낸다판은 원저자가 낸다. 우리는 원저자 공식 설치기를 그대로 부른다.

이미 깔려 있는지부터 확인하세요

아무것도 안 깔고 이 컴퓨터를 먼저 잽니다.