ECC: 코딩 에이전트에 일하는 순서를 깔아 주는 하네스
npx 한 줄로 Claude Code가 계획, 실패하는 테스트, 통과, 새 눈 리뷰 순서로 일하게 만드는 하네스
- 누가
- Affaan Mustafa(@affaan)가 혼자 유지보수해요. Claude Code·Codex 같은 코딩 에이전트로 매일 일하는 개발자를 위한 것.
- 언제
- 2026년 1월 공개, 6월 v2.0.0, 최신 릴리스는 v2.2.3(2026-10-01).
- 어디서
- Claude Code에서 가장 잘 돌고 Codex·Qoder는 네이티브 플러그인, Cursor·OpenCode·Gemini·Zed 등은 기능이 줄어든 어댑터. 내 PC에서 돌아요.
이게 불편했어요
Claude Code에 「테스트 먼저 써 줘」라고 해도 대화가 길어지면 잊어버려요. 계획은 채팅 기록 속에 묻히고, 코드를 쓴 그 맥락이 그대로 자기 코드를 리뷰했어요. 새 세션을 열 때마다 어제 어디까지 했는지 다시 설명해야 했고요.
그래서 이렇게 풀어요
ECC는 그 순서를 프롬프트 대신 설치로 넣어요. 계획은 고칠 수 있는 문서가 되고, 테스트 먼저는 실패한 테스트를 증거로 남겨야 넘어가는 단계가 되고, 리뷰는 코드를 쓰지 않은 다른 에이전트가 맡아요. 결과는 코드만이 아니라 계획, 실패한 테스트, 통과한 테스트, 리뷰 지적, 마지막 검증까지 이어진 기록으로 남아요.

/ecc:plan "Add usage-based billing alerts"-> confirm or edit the plan-> activate tdd-workflow-> capture RED evidence before implementation-> implement until GREEN-> review from fresh context-> fix findings with regression tests-> verify build, lint, types, and tests
이걸로 만든 사람들
게임 팀원을 찾아 주는 Flutter 앱 Jynx(Dart 21만 4천 줄)를 Claude Code로 만들면서, 훅·스킬·규칙 셋업 가운데 instincts 시스템을 ECC에서 가져다 썼다고 Show HN에 적었어요. 앱은 App Store와 Play Store에 올라가 있어요.
22 hooks, 18 skills, 13 instincts, 8 rule files, custom subagents, slash commands, MCP servers and plugins (instincts system from Affaan's
안에서는 이렇게 돌아가요
- 1
나 → /ecc:plan
/ecc:plan "만들 기능"요구를 다시 정리하고 위험과 단계를 적은 계획을 내놓은 뒤, 내가 승인할 때까지 코드에 손대지 않아요.commands/plan.md - 2
/ecc:plan → tdd-workflow 스킬
승인된 *.plan.md계획의 작업마다 테스트를 정하고, 실패하는 테스트(RED)를 먼저 확인한 뒤 통과(GREEN)할 만큼만 구현해요.skills/tdd-workflow/SKILL.md - 3
tdd-workflow 스킬 → code-reviewer 에이전트
git diff따로 떨어진 맥락의 리뷰 에이전트가 바뀐 코드와 주변 파일을 읽고, 80% 넘게 확신하는 문제만 보고해요.agents/code-reviewer.md - 4
code-reviewer 에이전트 → Claude Code
CRITICAL부터 LOW까지 지적Claude Code가 지적을 고치고, 빌드·린트·타입·테스트로 마지막 검증을 해요. - 5
Claude Code → 세션 요약 파일
Stop 훅 → *-session.tmp응답이 끝날 때마다 대화 기록에서 요약을 뽑아 세션 파일에 쓰고, 다음 세션 시작 훅이 이걸 다시 불러와요.scripts/hooks/session-end.js
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- Claude Code로 기능을 만들면서 테스트와 리뷰를 매번 따로 부탁하고 있는 사람
- 긴 작업을 다음 날 새 세션에서 이어 가야 하는 사람
- Claude Code와 Codex를 같이 써서 같은 스킬을 양쪽에 두고 싶은 사람
- 훅, MCP 설정, 권한 같은 에이전트 설정 자체를 보안 점검하고 싶은 사람
이건 안 돼요
- 한 하네스에 설치 방법을 겹치면(플러그인 위에 전체 수동 설치) 스킬과 훅이 두 번 돌아요.
- Claude Code 플러그인으로는 rules를 배포할 수 없어서, 규칙은 저장소에서 직접 복사해야 해요.
- Cursor, OpenCode, Gemini 등은 기능이 제한된 어댑터라 Claude Code와 같은 기능을 기대하면 안 돼요.
- 비공개 저장소 분석과 PR 감사를 하는 호스팅 GitHub App(ECC Pro)은 유료예요. 오픈소스 쪽은 MIT로 무료예요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요