ECC × Claude Code / Cursor

핵심 요약

ECC = Agent 하네스 OSS: 246+ Skills, 61 Agents, Hooks 기억, AgentShield — MIT.
몇 줄 Cursor Rules와 달리 research-first, eval-harness, 세션 간 기억, 감사 가능 설치.
Claude Code/Cursor/Codex 지원 — 설치 경로 중복 금지, Hook 이중 실행이 1순위 느려짐.
개인: minimal + 5–10 Skills; 팀: 2주 PoC 후 Hook 프로필.
ECC는 «어떻게 쓸지», 클라우드 Mac은 «어디서 빌드할지».

VS Code와 협업 UI — Claude Code·Cursor 에이전트 하네스 — ECC는 화면 안 에디터·터미널·Skills 워크플로를 최적화합니다.

1. Star 수에 휘둘리지 말 것: ECC가 푸는 문제

많은 사람이 ECC를 설치하는 이유는 «다들 하니까»입니다. 더 나은 질문: Claude Code / Cursor에 IQ가 부족한가, 프로세스가 부족한가? 매번 프로젝트를 재설명하고, 머지가 불안하고, Hook이 터미널을 느리게 한다면 ECC가 맞습니다. 가끔 두 줄 스크립트만 묻는다면 프로젝트 Rules 몇 줄이면 충분합니다.

affaan-m/ECC는 agent harness performance optimization system — 하네스(Claude Code 플러그인, Cursor Skills, Codex AGENTS.md)를 다루며 또 다른 채팅 API가 아닙니다. Affaan Mustafa가 Hackathon 수상 후 약 10개월 프로덕션 설정을 MIT로 공개했습니다. 수치는 clone 시 README 기준:

Skills(~246): SKILL.md 워크플로 단위, 패시브 트리거·Agent 재사용, 신기능은 Skills 우선;
Agents(~61): 리뷰·빌드 수정·다국어 Review 등 역할 분담;
Hooks: SessionStart/Stop 스크립트로 세션 간 기억, 요약, 런타임 게이트;
Rules: TS/Python/Go/Java 등, 필요한 언어만 설치;
MCP, Commands(legacy-command-shims/ 레거시 slash), AgentShield;
v2.0.0-rc.1: Hermes 서사 + ecc2/ Rust(alpha, GA 전).

중문 개요는 README.zh-CN.md를 읽고, Agent를 «왜 이렇게 구성하는지»는 저자 Shorthand Guide와 Longform Guide(토큰 최적화, 병렬 worktree, eval 검증 루프)로 보완하세요.

라이선스와 상용 경계: 핵심 저장소는 MIT로 영구 무료입니다. ECC Pro(GitHub App, 비공개 저장소 감사 등 호스팅)와 Sponsor는 선택이며, Pro 없이도 OSS를 먼저 시험할 수 있습니다.

2. 핵심 모듈: Skills, Hooks, 기억, 보안

2.1 Skills: 워크플로를 1급 시민으로

ECC는 Skills를 주 작업면으로 두고 Commands는 유지보수·호환 기간에 들어가며, 예전 slash shim은 legacy-command-shims/에 둡니다. 팀 규범은 slash를 더 쌓기보다 skills/를 fork하는 편이 맞습니다.

스킬 범위는 넓습니다: search-first(공식 문서 먼저), eval-harness(검증 주도), Django/Spring Boot 패턴, v2 미디어·운영·예측 시장 리서치 팩 등. 개인 개발자에게 스택에 맞는 5–10개 Skills가 --profile full 전량 설치보다 다루기 쉬운 경우가 많습니다.

2.2 Hooks와 기억: 세션이 «망각»하지 않게

Longform Guide가 강조하는 기능 중 하나는 세션 종료 시 자동 요약, SessionStart에서 컨텍스트 복원입니다. PRD를 매번 다시 붙여넣는 토큰 낭비를 줄입니다. v1.8+부터 ECC_HOOK_PROFILE=minimal|standard|strict와 ECC_DISABLED_HOOKS로 파일을 건드리지 않고 Hook만 낮출 수 있어, «저장할 때마다 스크립트 두 번» 팀에 특히 중요합니다.

2.3 AgentShield와 research-first

보안에는 /security-scan과 AgentShield(Security Guide, Agentic Security)가 있으며 샌드박스·CVE·프롬프트 인젝션 등을 다룹니다. ECC는 구현 전 조사 문화를 밀어 — 공식 문서와 검증을 거치고 API를 추측하지 않습니다. Mac 렌탈·클라우드 Mac 개통 검수와 같이 자동화 전 재현 가능한 빌드가 전제입니다.

3. 크로스 하네스: Claude Code, Cursor, Codex — 한 팩으로?

README는 Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Zed, GitHub Copilot 등을 나열합니다. 루트의 .cursor/, .codex/, .claude/는 동일 Skills/Rules의 멀티 IDE 매핑이지 도구별 무관한 프롬프트 더미가 아닙니다.

사용 도구	ECC 설치 위치	실무 팁
Claude Code	공식 Plugin + `install.sh`	기본 경로; 먼저 `minimal` 또는 `core` profile
Cursor	`.cursor/skills` 등	프로젝트 Rules와 중복 주의; 팀은 `AGENTS.md`로 정렬
OpenAI Codex CLI	`AGENTS.md`, `.agents/skills/`	이미 Codex 쓰는 저장소; `/codex-setup` 흐름 읽기
Copilot만 가끔	문서 수준	전량 ECC ROI 낮음; 억지로 넣지 않기

v1.8의 /harness-audit, /quality-gate, /model-route는 «하네스가 건강한지»를 명령으로 만든 것 — 도입 2주 후 한 번 돌리고 첫날 전량은 피하세요.

4. 설치 함정: «설치 후 더 느려졌다»는 왜 생기나

Quick Start는 굵게 씁니다: 설치 경로는 정확히 하나. 현장에서 흔한 패턴은 월요일 마켓플레이스 원클릭, 수요일 동료의 «full이 완전체» 말에 install.sh --profile full 재실행 — /eval이 두 개, 저장 시 Hook이 두 번, 컨텍스트에 수천 토큰이 쌓입니다. 이건 ECC가 느린 게 아니라 이중 설치입니다.

Claude Code 사용자 권장 순서:

플러그인(마켓) + 필요한 언어 Rules만 복사; 또는
수동: ./install.sh --profile minimal --target claude(Hook 불필요 시 minimal); 게이트가 필요하면 --modules hooks-runtime 추가.
확신이 없으면 npx ecc consult "security reviews" --target claude로 컴포넌트 미리보기.

Windows는 install.ps1; v1.7+부터 Hook은 Node.js 스크립트가 많아 bash-only 실패가 줄었습니다. 꼬였으면 README의 Reset/Uninstall 후 재시도 — 커뮤니티는 Discussions, TROUBLESHOOTING, CONTRIBUTING를 참고하세요.

5. 쓸 만한가? 먼저 역할에 맞춰 보기

아래 표는 의사결정용 요약입니다. 5분만 있다면 표만 보세요. 팀 PoC 문서를 쓴다면 6절 클라우드 Mac 분업까지 읽으세요.

역할 / 시나리오	판단	이유
개인 풀스택(Claude Code/Cursor 사용)	시도 가치	minimal + Skills 10개 전후로 research-first·기억 Hook 체험; MIT 잠금 없음
엔지니어 10명+ 팀	PoC 후 신중 전량	설치 규약·Hook profile 통일, 개인 이중 설치 금지; 코드 리뷰 병행
레거시 소규모 스크립트만	선택	246 Skills 소음이 이득보다 큼
iOS 릴리스 + Xcode CI	계층 분리	ECC는 macOS Runner 대체 아님; Agent 병렬은 클라우드 Mac worktree 가이드
강한 컴플라이언스(미지 Hook 금지)	보안 검토 선행	SECURITY.md·AgentShield; `--without baseline:hooks` 검토

ECC는 «Agent 엔지니어링 베이스»로 시도할 가치가 있습니다 — README 없이 full 설치는 비추천. Star 수는 «누군가 Claude Code를 끝까지 파고 설정을 OSS로 공개했다»는 인정이지, clone만으로 속도 3배를 보장하지 않습니다.

6. 클라우드 Mac: 노트북의 Agent, 데이터센터의 빌드

ECC는 IDE/CLI 안의 추론과 워크플로를 다룹니다. xcodebuild, 시뮬레이터, 공증(notarization), Keychain은 여전히 macOS 실기가 필요합니다. 흔한 조합은 다음과 같습니다.

로컬/Cursor+ECC로 태스크·패치·PR;
클라우드 Mac mini M4에서 CI, worktree, launchd(FAQ);
릴리스 주 일일 임대로 16/24GB·Agent 피크 검증 후 주/월.

노트북 덮개를 닫아도 클라우드 Hook이 대신 Xcode를 돌리지 않습니다 — 그래서 하네스와 빌드 머신을 분리해야 합니다. 임대 단계는 클라우드 Mac 가이드를 보세요. 공유 Mac VPS보다 M4 전용 베어메탈이 현실적입니다.

7. 자주 묻는 질문

ECC와 Cursor 기본 Rules가 충돌하나요? 중복될 수 있습니다. 팀에서 «ECC 우선» 또는 «프로젝트 Rules 우선»을 정하고, 병합 전 /harness-audit이나 .cursor/와 ECC 디렉터리를 diff하세요.

ECC Pro 구독이 필수인가요? 아닙니다. OSS는 MIT; Pro는 비공개 저장소용 GitHub App 등 호스팅이며 Sponsor/Pro 설명을 참고하세요.

v2의 Hermes / ecc2란? rc.1에 Hermes 서사와 Rust ecc2/ 제어 평면이 들어갔고, 프로덕션은 README의 Plugin/수동 설치가 기준이며 ecc2는 alpha입니다.

업데이트는 어떻게 추적하나요? GitHub Releases Watch; 메이저 전 브랜치에서 install-plan 미리보기(v1.9+ 선택 설치).

OpenClaw와 같나요? 다릅니다. OpenClaw는 게이트웨이·플러그인 실행; ECC는 코딩 하네스 성능·엔지니어링 규범. 공존은 가능하나 같은 머신에서 포트·MCP·Hook이 리소스를 두고 싸우지 않게 계층을 나누세요.

8. 참고·외부 링크

저장소: github.com/affaan-m/ECC
중문 README: README.zh-CN.md
기여·보안: CONTRIBUTING · SECURITY · TROUBLESHOOTING
커뮤니티: Discussions
저자 가이드(X): Shorthand Guide · Longform Guide

9. 맺음말

ECC (Everything Claude Code)는 «Claude Code를 쓴다»에서 «Agent 하네스를 통제한다»로 옮깁니다 — Skills 워크플로, Hook 기억, 감사 가능 설치·보안 스캔. 개인은 minimal + 엄선 Skills로 research-first 습관; 팀은 Star 기반 일괄 설치보다 2주 PoC. iOS/macOS 파이프라인이면 코딩 하네스는 IDE, 빌드 환경은 클라우드 Mac — 일일 임대로 xcodebuild를 먼저 통과시키세요.