코딩 에이전트에 계획·테스트·리뷰·메모리 워크플로우를 더하는 ECC

affaan-m/ECC는 코딩 에이전트에 반복 가능한 엔지니어링 워크플로우를 심어주는 오픈소스 저장소입니다. Claude Code, Codex, OpenCode, Cursor 등 다양한 에이전트 하네스(Harness)를 지원합니다. 여기서 하네스는 에이전트를 구동하고 도구를 연결하며 모델에 동작 규칙을 적용하는 실행 환경을 가리킵니다. ECC는 스킬, 메모리, 보안 검사, 리서치 스킬을 제공해 매번 프롬프트에 같은 작업 방식을 일일이 적지 않도록 돕습니다.

이 저장소는 2026년 1월 18일에 개설되었으며, 마지막 커밋 푸시는 2026년 11월 9일에 기록되었습니다. 이 날짜는 최근 푸시 시점일 뿐 구체적인 변경 내역을 나타내지는 않습니다. GitHub 기준 스타 수는 301,561개입니다. 스타는 계정 북마크 개념이므로 실제 설치 수나 사용자 수를 뜻하지는 않습니다. 다른 계정으로 복제된 포크 수는 44,486개이며, 아직 해결되지 않은 열린 이슈(Open issue)는 272건입니다. 라이선스는 MIT입니다. MIT는 저작권 고지만 남겨두면 누구나 코드를 자유롭게 사용, 수정, 배포할 수 있는 허용적 라이선스입니다.

ECC의 역할

ECC는 계획, 테스트, 구현, 리뷰, 검증, 기억, 개선으로 이어지는 하나의 엔지니어링 루프를 구축합니다. 에이전트는 코드를 작성하기 전에 먼저 계획을 세우고, 테스트로 변경 사항을 확인하며, 새로운 컨텍스트에서 작업 결과를 직접 리뷰합니다. 여기서 새로운 컨텍스트란 코드를 작성했던 기존 대화에 얽매이지 않고 독립된 환경에서 객관적으로 검토함을 가리킵니다. 메모리는 세션이 끝나도 보존해야 할 정보를 저장하며, 반복해서 성공한 작업은 재사용 가능한 스킬이나 워크플로우로 발전시킬 수 있습니다.

README에서는 '컨텍스트 윈도우는 최적화하고, 그 외의 모든 것은 영구 저장하라'는 간결한 원칙을 제시합니다. 컨텍스트 윈도우는 현재 턴에서 모델이 직접 읽을 수 있는 텍스트 범위입니다. 메모, 요약, 스킬은 이 창 밖에 보관해 두었다가 이후 세션에서 다시 활용합니다.

도구별 지원 수준에는 차이가 있습니다. 현재 ECC는 Claude Code에서 가장 매끄럽게 동작합니다. Codex와 Qoder는 네이티브 플러그인 방식을 지원합니다. Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, Qwen 등 다른 하네스는 어댑터 형태로 연결되며, 프로젝트에서는 이러한 어댑터의 기능이 일부 제한적(capability-limited)이라고 설명합니다. 따라서 모든 하네스에서 동일한 기능을 제공한다고 넘겨짚지 말고 지원 현황 매트릭스를 먼저 살펴봐야 합니다.

저장소 토픽 태그로는 ai-agents, anthropic, claude, claude-code, developer-tools, llm, mcp, productivity 등이 등록되어 있습니다. 한국어 README 또한 docs/ko-KR/README.md 경로에 이미 공개되어 있습니다.

워크플로우 동작 방식

공개된 워크플로우는 순차적으로 진행됩니다. 계획 단계에서 변경 사항을 정의하고, 테스트 단계에서 통과 기준을 세웁니다. 구현 단계에서 코드를 작성하면, 리뷰 단계에서는 새로운 컨텍스트로 결과를 살펴봅니다. 검증 단계에서는 작성한 코드가 테스트와 계획에 부합하는지 점검합니다. 메모리 단계에서는 이후 세션에 필요한 내용을 보관하고, 개선 단계에서는 반복된 성공 경험을 스킬이나 워크플로우로 전환합니다.

세션이 진행되는 동안 훅(Hook)과 메모리가 백그라운드에서 동작합니다. 런타임 기능에는 규칙 강제(enforcement), 세션 요약, 지속적 학습, 본능(instincts), 컨텍스트 제어 등이 포함됩니다. 규칙은 선별적으로 적용할 수 있습니다. 매 실행마다 모든 규칙을 불러오지 않고, 언어나 프로젝트별로 상시 로드할 기준만 골라 지정하면 됩니다.

보안 도구인 AgentShield도 기본 포함되어 있습니다. 프롬프트, 훅, MCP 설정, 권한, 시크릿(비밀값), 에이전트 파일을 종합적으로 검사합니다. 여기서 MCP는 에이전트 도구를 연결하는 표준 인터페이스인 모델 컨텍스트 프로토콜(Model Context Protocol)을 가리킵니다. AgentShield는 이러한 파일과 설정을 스캔하지만, 모든 위험 요소를 완벽히 잡아낸다는 보장은 아닙니다.

설치 및 첫 실행

설치는 반드시 README에 명시된 공식 채널을 이용해야 합니다. 공식 채널로는 GitHub 저장소(github.com/affaan-m/ECC), npm 패키지(ecc-universal, ecc-agentshield), GitHub App, 플러그인 식별자(ecc@ecc), 공식 웹사이트(ecc.tools)가 있습니다. 서드파티 재업로드나 비공식 미러는 프로젝트 측에서 관리하지 않으며 악성코드가 포함될 위험이 있습니다.

ECC 2.2는 Claude Code, Codex, Kimi Code를 위한 대화형 가이드 설치를 지원합니다. 유니버설 패키지를 쓰려면 Node.js 18 이상 버전이 필요합니다. Claude 플러그인으로 설치할 때는 Git과 Claude Code 2.1 이상 버전이 PATH 환경변수에 등록되어 있어야 합니다. PATH는 셸이 실행 프로그램을 탐색하는 디렉터리 목록입니다. 18 이상, 2.1 이상이란 해당 버전 또는 그 이후 릴리스를 써야 한다는 뜻입니다.

권장 설치 방식은 저장소를 로컬에 따로 클론할 필요가 없습니다. 가이드 설치 프로그램이나 네이티브 플러그인 명령어를 활용하면 됩니다. 가이드 설치를 마친 상태에서 별도로 Claude 수동 전체 설치를 중복해 덧붙이지 마세요.

npx ecc-universal@2.2.3 setup

이 명령어는 2.2.3 버전 패키지의 가이드 설치 프로그램을 실행합니다. npm은 Node 패키지 레지스트리이며, npx는 패키지를 바로 실행하는 도구입니다. 일반적인 개인 환경이라면 README 안내대로 'Global user'와 'Standard hooks'를 선택하고 확인을 진행하면 됩니다.

사용 방법

Windows 환경이라면 Node.js 18 이상, Git, Claude Code를 먼저 설치한 뒤 PowerShell을 열어 각 도구가 잘 준비되었는지 확인합니다.

node --version
git --version
claude --version

프로그램이 정상적으로 설치되어 있다면 각 명령어마다 버전 정보가 출력됩니다. 만약 명령어를 찾을 수 없다는 오류가 뜬다면 설치를 진행하기 전에 해당 프로그램을 새로 설치하거나 복구해야 합니다. 이 세 명령어는 ECC를 직접 실행하는 명령이 아니라 필수 사전 요구사항을 점검하는 단계입니다.

설치가 끝나면 새로운 Claude Code 세션을 열고 다음 명령어를 입력합니다.

/plugin list

Claude Code에 활성화된 플러그인 목록이 표시됩니다. 목록에 ecc@ecc가 활성화 상태로 나타나면 점검을 통과한 것입니다. 나중에 설치 범위(scope)나 훅 프로필을 변경할 때도 앞서 실행한 동일한 설치 명령어를 사용합니다. 설치 안내에 별도 추가 플래그가 지정되어 있지 않으므로 안내된 명령어를 그대로 복사해 실행하면 됩니다.

저장소 구성 살펴보기

README 표에는 71개의 에이전트, 314개의 스킬, 98개의 커맨드가 명시되어 있습니다. 71개 에이전트는 기획, 리뷰, 빌드 복구, 보안, 아키텍처, 도메인별 업무 등에 특화된 역할군입니다. 314개 스킬은 테스트 주도 개발(TDD), 리서치, 보안, 문서화, 프론트엔드, 데이터, 머신러닝, 인프라 운영 등 다양한 분야를 아우릅니다. 98개 커맨드는 레거시 심(shim)으로, 프로젝트가 스킬 중심 인터페이스로 전환하는 과정에서 남겨둔 간단한 진입점 명령어입니다.

전체 디렉터리 트리에는 4,701개의 파일이 담겨 있습니다. 이 수치는 코드 라인 수가 아닌 순수 파일 개수입니다. 이 중 1,068개 파일이 SKILL.md라는 파일명을 갖습니다. 이 파일 수는 README 표에 나온 314개 스킬과는 집계 기준이 다릅니다. 표에 적힌 숫자는 공식 패키지로 배포되는 스킬 수이고, 파일 수는 저장소 트리 전체에 존재하는 모든 SKILL.md를 합산한 결과입니다.

루트 경로에는 다양한 하네스별 전용 폴더가 마련되어 있습니다. .claude, .claude-plugin, .codex, .codex-plugin, .cursor, .gemini, .agents, .codebuddy, .hermes, .kimi, .kiro, .adal 등이 포함됩니다. 루트의 주요 설정 파일로는 .mcp.json, .coderabbit.yaml, .env.example, .gitattributes, .gitignore, .gitleaksignore, .markdownlint.json이 있습니다. README 뱃지에는 Shell, TypeScript, Python, Go, Java, Perl, Markdown 언어가 표시되어 있습니다.

MIT 라이선스가 적용된 공개 저장소는 계속 무료로 이용할 수 있습니다. 비공개 저장소를 위한 호스팅형 GitHub App인 'ECC Pro'는 별도로 운영됩니다. README에 따르면 비공개 저장소 플랜은 시트(seat)당 월 19달러부터 시작합니다. 여기서 시트는 유료 호스팅 플랜을 이용하는 사용자 한 명을 뜻하며, 이 가격 정책은 공개된 MIT 오픈소스 코드에는 적용되지 않습니다.

유사 저장소와의 비교

동일한 일간 트렌드 목록에 있는 세 저장소가 ECC보다 더 많은 스타를 보유하고 있습니다. 다만 스타 수는 단순 북마크 수치일 뿐 코드의 정확성이나 보안성, 특정 에디터와의 적합도를 보장하지는 않습니다.

저장소	스타 수	주요 포커스
morluto/rea	453,579	에이전트를 활용한 앱 동작 및 네이티브 바이너리 리버스 엔지니어링
mattpocock/skills	322,332	동작하는 .agents 디렉터리 기반으로 공개된 스킬 모음
obra/superpowers	316,439	에이전트 스킬 프레임워크 및 소프트웨어 개발 방법론
affaan-m/ECC	301,561	스킬, 메모리, 보안 검사 및 멀티 하네스 설치 지원

이 비교군에서 ECC는 301,561개로 스타 수가 가장 적고, morluto/rea가 453,579개로 가장 많습니다. 각 프로젝트가 지향하는 목표는 분명히 다릅니다. rea는 리버스 엔지니어링에 집중하고, mattpocock/skills는 단일 에이전트 디렉터리에서 스킬을 추출해 제공하며, obra/superpowers는 스킬 프레임워크와 개발 방법론을 제안합니다. 반면 ECC는 훅, 메모리, AgentShield를 아우르며 여러 하네스에 걸쳐 단일화된 설치 환경을 제공하는 데 초점을 둡니다.

한계점

모든 도구에서 완벽히 동일한 기능을 기대하기는 어렵습니다. Claude Code가 가장 완성도 높게 지원되며, 다른 하네스를 위한 어댑터는 기능이 일부 제한됩니다. 따라서 Cursor나 Gemini 사용자라면 Claude Code의 모든 에이전트나 훅이 그대로 제공될 것이라 생각해서는 안 됩니다.

설치 시 필수 도구를 갖춰야 합니다. Node.js 18 이상 버전이 없으면 유니버설 설치 프로그램을 구동할 수 없고, Git과 Claude Code 2.1 이상 버전이 PATH에 등록되어 있지 않으면 Claude 플러그인 설치를 완료할 수 없습니다. 또한 프로젝트 가이드에서는 대화형 설치 프로그램과 수동 Claude 전체 설치를 섞어 쓰지 말 것을 당부합니다.

배포 채널 관련 경고도 눈여겨봐야 합니다. 공식 안내된 출처만 프로젝트 팀에서 직접 관리합니다. 미러 사이트는 파일이 임의로 변조되었을 가능성이 있습니다. AgentShield가 로컬 프롬프트, 훅, MCP 설정, 권한, 시크릿, 에이전트 파일을 검사해 주지만, 사용자가 직접 설정을 꼼꼼히 검토하는 과정을 완전히 대신할 수는 없습니다.

열려 있는 이슈 수도 안정성을 가늠할 때 참고해야 합니다. 272개의 열린 이슈는 아직 해결되지 않은 스레드가 272건 남아 있다는 뜻입니다. 이 숫자가 모두 확인된 버그를 의미하는 것은 아니지만, 이슈 대기열이 여전히 활발히 돌아가고 있음을 보여줍니다.

유료 플랜의 범위는 명확히 분리되어 있습니다. 공개 MIT 코드는 앞으로도 무료로 유지됩니다. 비공개 저장소를 연동하는 ECC Pro 호스팅 플랜만 시트당 월 19달러부터 시작하므로, 공개 저장소만 활용하는 팀이라면 해당 유료 플랜을 결제할 필요가 없습니다.

ECC는 기존 에이전트 제품군 위에서 동작하는 워크플로우 레이어입니다. Claude Code나 Codex, Cursor 자체를 대체하는 도구가 아닙니다. 아울러 본 글에서 참고한 프로젝트 공식 문서에는 설치 전후의 작업 성공률을 비교한 벤치마크 데이터가 포함되어 있지 않습니다.

코딩 에이전트에 계획, 테스트, 리뷰, 메모리, 보안 검사로 이어지는 단일 루프를 도입하고 싶다면 ECC는 매우 실용적인 선택지입니다. 특히 Claude Code 환경에서 가장 안정적인 지원을 경험할 수 있습니다.

출처: GitHub 저장소 affaan-m/ECC (https://github.com/affaan-m/ECC).