affaan-m/ECC — The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
ECC — Claude Code·Codex·Cursor를 위한 에이전트 하니스 최적화 시스템
ECC는 AI 코딩 에이전트에 계획·테스트·리뷰·검증·기억의 엔지니어링 워크플로를 한 번에 설치해 주는 MIT 라이선스 오픈소스 시스템입니다. 68개 에이전트, 292개 스킬, 훅·메모리·보안 스캐너를 제공하며 Claude Code, Codex, Cursor 등 다양한 하니스를 지원합니다.
- 주제
본문
AI 코딩 에이전트는 코드를 작성할 수 있지만, 계획을 세우고 검증하고 기억하는 '엔지니어링 프로세스'는 매 프롬프트마다 사용자가 다시 구성해야 하는 경우가 많습니다. ECC는 이 프로세스를 한 번 설치해 에이전트의 작동 방식 자체에 내장시키는 도구입니다. 프로젝트가 제시하는 파이프라인은 'plan -> test -> implement -> review -> verify -> remember -> improve'이며, 슬로건은 'Optimize the context window. Persist everything else.'입니다. 즉 컨텍스트 윈도우는 최적화하고 나머지는 모두 지속화한다는 뜻입니다.
구성 요소와 규모
ECC는 68개의 전문 에이전트(계획, 리뷰, 빌드 복구, 보안, 아키텍처, 도메인 작업), 292개의 스킬(TDD, 리서치, 보안, 문서, 프론트엔드, 데이터, ML, 운영 등), 94개의 레거시 커맨드 심을 제공합니다. 여기에 강제 실행을 담당하는 훅(hooks), 세션 요약과 지속 학습·인스팅트를 위한 메모리 시스템, 언어별·프로젝트별로 선택하는 상시 로드 규칙(rules), 그리고 프롬프트·훅·MCP 설정·권한·시크릿·에이전트 파일을 스캔하는 AgentShield 보안 스캐너가 포함됩니다. 스킬이 정식 워크플로 표면이고 슬래시 커맨드는 호환성 진입점으로 유지되는 구조입니다. 대표적인 진입점으로는 기능 개발 시 /ecc:plan과 tdd-workflow, 신선한 컨텍스트 리뷰를 위한 /code-review, 빌드 복구용 /build-fix, 컨텍스트 압박 점검용 /context-budget, 세션 종료·재개용 /save-session·/resume-session, 설정 감사용 /security-scan 등이 안내되어 있습니다.
지원 하니스와 설치 방식
MIT 라이선스로 영구 무료이며, 현재 Claude Code에서 가장 잘 동작하고 Codex는 공식 플러그인 경로를, Cursor·OpenCode·Gemini·Zed·GitHub Copilot·Antigravity·Qwen 등은 기능 제한이 있는 어댑터로 지원합니다. 2.2 버전부터는 npx [email protected] setup 명령의 가이드 설치(Claude Code)와 install --guided 멀티 하니스 마법사(Claude Code·Codex·Kimi Code)를 제공하며, Node.js 18 이상과 Claude Code 2.1 이상이 필요합니다. pnpm dlx, yarn dlx(Yarn 2+), bunx도 지원됩니다.
주의할 점이 몇 가지 있습니다. 첫째, 같은 하니스에 설치 방법을 중첩하지 말 것 — Claude 플러그인과 수동 설치를 겹치면 스킬·훅이 중복됩니다. 둘째, 식별자가 세 개로 나뉩니다. GitHub 리포지터리는 affaan-m/ECC, Claude 플러그인 ID는 ecc@ecc, npm 패키지는 ecc-universal이며 서로 바꿔 쓸 수 없습니다. 셋째, 훅 런타임은 --enable-hooks 또는 --no-hooks의 명시적 선택 없이는 설치가 중단되도록 설계되어 있고, /multi-plan 같은 multi-* 커맨드는 별도의 ccg-workflow 런타임이 필요합니다. 또한 Claude 플러그인은 규칙(rules)을 배포할 수 없으므로 rules/common과 사용하는 언어 팩을 수동으로 복사해야 합니다.
보안 경고와 운영 모델
프로젝트는 공식 채널(GitHub 리포지터리, npm 패키지 ecc-universal·ecc-agentshield, GitHub App, 플러그인 슬러그 ecc@ecc, 사이트 ecc.tools) 외의 제3자 재업로드·미러에 악성코드가 포함될 수 있다고 경고합니다. 버전 고정은 보안 감사가 아니므로 실행 전 릴리스 소스와 레지스트리 무결성을 직접 검토하라고 명시합니다. 상태 점검·복구·제거에는 list-installed, doctor, repair, uninstall --dry-run 순서의 도구 체계가 마련되어 있고, ECC는 진단 정보를 자동 업로드하지 않습니다.
수익 구조도 공개되어 있습니다. 리포지터리는 MIT로 영구 무료이고, 비공개 리포지터리용 호스티드 GitHub App인 ECC Pro가 월 시트당 19달러부터이며, 스폰서와 Pro 구독이 단일 메인테이너가 7개 하니스에 주간 단위로 배포하는 작업을 지원한다고 밝히고 있습니다.
원문: GitHub / 번역·요약: Trawling