affaan-m/ECC는 코딩 에이전트가 코드를 쓰는 데서 그치지 않고 체계적인 엔지니어링 절차를 따르도록 만드는 '에이전트 하네스 성능 최적화 시스템'이다. 개발자 affaan-m이 MIT 라이선스로 공개했고, 주 언어는 자바스크립트다. GitHub 스타는 28만 119개이며 하루 동안 1,015개가 늘었다.
무엇을 하나
README는 ECC를 '계획 → 테스트 → 구현 → 리뷰 → 검증 → 기억 → 개선'으로 이어지는 작업 체계를 한 번 설치해 에이전트의 기본 동작으로 만드는 도구라고 설명한다. 매번 프롬프트에 절차를 적는 수고를 없애겠다는 취지다.
구성은 다음과 같다고 밝혔다.
- 에이전트 71개: 계획, 리뷰, 빌드 오류 수정, 보안, 설계 등 역할별 전문 에이전트
- 스킬 311개: TDD, 리서치, 보안, 문서, 프런트엔드, 데이터, 머신러닝, 운영 등
- 명령어 97개: 스킬 중심 구조로 옮겨가는 과정의 기존 진입점
- 훅과 메모리: 규칙 강제, 세션 요약, 지속 학습, 컨텍스트 제어
- 에이전트실드(AgentShield): 프롬프트, 훅, MCP 설정, 권한, 비밀 정보, 에이전트 파일 점검
작동 방식과 지원 범위
핵심 문구는 '컨텍스트 윈도를 최적화하고 나머지는 모두 영속화하라'이다. 규칙은 언어·프로젝트별로 필요한 묶음만 골라 항상 로드되도록 하고, 반복해서 성공한 방식은 재사용 가능한 스킬과 워크플로로 바꾼다는 구상이다.
클로드 코드(Claude Code)에서 가장 잘 동작하며, 코덱스(Codex)와 큐더(Qoder)는 네이티브 플러그인 경로를 제공한다. 커서(Cursor), 오픈코드(OpenCode), 제미나이(Gemini), 젭(Zed), 깃허브 코파일럿 등은 기능이 제한된 어댑터로 지원한다. README는 기능이 동일하다고 가정하지 말고 지원 현황표를 먼저 확인하라고 안내한다.
써보면
노드(Node.js) 18 이상이 필요하며, 클로드 코드 플러그인 설정에는 Git과 클로드 코드 2.1 이상도 필요하다. 권장 방법은 안내형 설치 마법사다.
npx ecc-universal@2.2.3 setup
여러 에이전트를 한꺼번에 설정하려면 install --guided 옵션으로 클로드 코드, 코덱스, 키미 코드(Kimi Code)를 선택할 수 있다. 클로드 코드에서는 /plugin install ecc@ecc로 직접 설치할 수도 있다. 같은 하네스에 설치 방식을 중복 적용하면 스킬과 훅이 중복될 수 있어 한 가지만 쓰라고 당부한다. 클로드 코드 플러그인은 규칙을 배포할 수 없어 규칙 파일은 따로 복사해야 한다.
의의와 한계
저장소는 MIT 라이선스 오픈소스로 유지하되, 비공개 저장소용 호스팅 GitHub 앱 'ECC Pro'를 좌석당 월 19달러부터 유료로 제공한다고 밝혔다. 스폰서 후원과 함께 이 수익으로 단독 메인테이너가 매주 업데이트를 낸다는 설명이다.
다만 단일 메인테이너 프로젝트에 훅과 규칙이 광범위하게 개입하는 만큼 도입 전 코드 검토가 필요하다. README도 버전 고정이 보안 감사나 무결성 검증을 대신하지 않는다고 경고하며, 공식 채널 외 미러에는 악성코드가 있을 수 있다고 주의를 당부했다. 하네스별 기능 편차도 감안해야 한다.
