프레임워크

ECC로 Claude Code·Codex를 위한复用형 Agent Harness 만들기

ECC는 Skills, Memory, Security를 하나의 공통 계층으로 묶어 Claude Code, Codex 같은 코딩 Agent의 작업 흐름을 표준화한다. 연구 우선 개발부터 권한 관리와 프로젝트 기억까지, 여러 도구에서 재사용할 수 있는 Agent 엔지니어링 구조를 제공한다.

글자 크기

코딩 Agent에서 가장 큰 문제는 대개 모델 자체가 아니라 안정적인 엔지니어링 계층이 없다는 데 있다. Claude Code는 특정 지시 형식을 사용하고 Codex는 다른 체계를 쓰기 때문에, 프로젝트를 옮길 때마다 permissions, memory, safety rules를 다시 설정해야 한다. 같은 작업의 반복이다.

ECC(Everything Claude Code)는 이 계층을 공통 구성요소로 분리하려는 프로젝트다. Agent가 코드를 작성하기 전에 먼저 조사하고 위험을 평가한 뒤, 재사용 가능한 개발 흐름을 실행하도록 구성한다. 주요 대상은 Claude Code, Codex, OpenCode, Cursor다.

무엇을解决的问题인가

코딩 Agent를 사용해 본 개발자라면 다음과 같은 상황을 한 번씩 경험했을 것이다.

  • 프로젝트 A에서 잘 맞춘 지시문을 프로젝트 B에 옮기면 다시 작성해야 한다.
  • Agent마다 .cursorrules, .claude/, AGENTS.md를 읽는 방식이 다르다.
  • 코드를 쓰기 전에 의존성 감사를 먼저 실행하고 싶지만, 공통 hook을 연결할 방법이 없다.
  • 보안 규칙을 prompt에 “secret을 건드리지 마”라고만 적어 두고 실제로 검증하지 않는다.

ECC는 이 요소들을 하나의 Agent Harness로 묶는다. Agent Harness는 설정, workflow, Convention의 집합으로, 위 문제를 재사용하고 버전 관리할 수 있는 자산으로 바꾼다. 저장소는 주로 Markdown 설정과 문서로 구성되며 설치 스크립트와 adapter도 함께 제공한다.

사용 방법

먼저 저장소를 clone한 다음 README에서 현재 사용 중인 도구에 맞는 설치 명령을 확인한다.

# 1. 获取项目
git clone https://github.com/affaan-m/ECC.git
cd ECC

# 2. 阅读当前工具适配说明
cat README.md

# 3. 按 README 安装对应配置后,在项目中测试
# 示例工作流:先研究,再规划,再编码
研究目标 -> 资料与依赖审查 -> 风险清单
风险清单 -> 最小实现计划 -> 测试命令
测试命令 -> 失败原因 -> 写入项目记忆

일반적인 사용 순서는 다음과 같다.

  1. 설치를 진행한다(./install.sh 또는 유사한 스크립트).
  2. skills를 해당 Agent 디렉터리에 복사한다.
  3. 프로젝트 루트 디렉터리에서 Agent를 실행한다.
  4. 먼저 research-first 흐름을 한 번 실행하도록 한다.

구체적인 명령, 디렉터리 이름, adapter 목록은 저장소의 현재 README를 기준으로 삼아야 한다. 이 프로젝트는 빠르게 바뀌므로, 설치 단계를 코드에 하드코딩하면 곧 낡은 정보가 되기 쉽다.

동작 방식과 구조

ECC는 네 개의 계층으로 나눌 수 있다.

┌───────────────────────────────┐
│  工作流层(user-facing flow)  │
├───────────────────────────────┤
│  Skills(任务模板与流程拆解)   │
├───────────────────────────────┤
│  Memory + Instincts(持久化)  │
├───────────────────────────────┤
│  Security(权限与边界)        │
└───────────────────────────────┘
  • 워크플로 계층: 사용자에게 제공되는 개발 흐름으로, “research-first”, “security-first” 같은 방식이 포함된다.
  • Skills: 한 종류의 작업을 반복 가능한 단계로 나눈다. PR review나 의존성 감사 등이 여기에 해당한다.
  • Memory + Instincts: 프로젝트 배경, 장기적인 선호, 행동 제약을 저장한다.
  • Security: 권한 경계, 민감 정보, 도구 실행 범위를 관리한다.

일반적인 요청 처리 과정은 다음과 같다.

  1. 사용자가 작업을 요청한다.
  2. Agent가 먼저 자료를 조사하고 코드와 의존성을 확인한다.
  3. 해결方案과 위험 목록을 작성한다.
  4. 관련 Skills를 호출해 작업을 실행한다.
  5. 결과를 Memory 또는 Instincts에 기록한다.
  6. 검토, rollback, commit 중 적절한 절차를 수행한다.

여러 Agent 프런트엔드를 지원하지만, 도구마다 디렉터리와 파일 형식을 읽는 방식이 완전히 같지는 않다. 따라서 여러 도구에서 별도 수정 없이 재사용하려면 adapter 작업이 필요하다.

장점과 한계

장점:

  • 조사, 기억, 보안, 행동 규칙을 하나의 설정으로 묶어 이전과 버전 관리를 쉽게 한다.
  • 불확실한 기술 선택, 의존성 감사, 복잡한 코드베이스에서 research-first 방식이 특히 유용하다.
  • 분산된 prompt 템플릿보다 재사용성이 높고 git으로 관리하기 쉽다.

한계:

  • 완전한 Agent runtime이 아니라 ‘설정 + 워크플로 모음’에 가깝다.
  • 대상 도구에 맞는 adapter가 없으면 파일을 복사해 와도 동작하지 않을 수 있다.
  • 텍스트로 된 규칙이 많기 때문에 기존 AGENTS.md, CI, 권한 정책과 충돌할 수 있다.
  • star 수가 높다는 것은 관심도를 뜻할 뿐, 부하 테스트와 코드 리뷰를 대신하지 못한다.

간단히 검증해 본 결과

최소한의 검증을 진행했다. 로컬 예제 프로젝트에서 Agent가 ‘자료 찾기 — 스크립트 수정 — 테스트 실행 — 결론 기록’ 작업을 10회 연속 수행하도록 했다.

비교 설정은 다음과 같다.

  • 첫 번째 실행: 기본 설정만 사용하고 소요 시간을 측정한다.
  • 두 번째 실행: ECC의 연구, 기억, 보안 지침을 적용한다.

측정 항목은 다음과 같다.

  • wall time(종단 간 소요 시간)
  • 도구 호출 횟수
  • 반복 지시 횟수(Agent가 “다시 한 번 실행해야 한다”고 되돌아오는 경우)
  • 실패율

결과 수치는 여기서 공개하지 않는다. 이번 검증에는 저장소 소스, 버전, 벤치마크 스크립트, 모델 temperature 기록이 없었기 때문에 “3배 빨라졌다”거나 “성공률이 95%다”고 말하는 것은 의미 있는 비교가 아니다.

ECC의 가치를 제대로 검증하려면 다음과 같은 방식으로 실험해야 한다.

  • 동일한 모델과 temperature를 고정한다.
  • 동일한 작업 세트를 고정한다. 예를 들어 실제 소규모 리팩터링, 의존성 업그레이드, bug 수정 10개를 사용할 수 있다.
  • 도구 권한을 동일하게 고정한다.
  • ECC 설정을 적용한 그룹과 기본 Agent 그룹을 비교한다.

중점적으로 볼 지표는 단일 답변에 대한 주관적인 인상보다 안정성의 차이다.

사용하기 좋은 대상

적합한 대상:

  • 이미 Claude Code, Codex, OpenCode, Cursor를 사용하는 팀
  • 연구 흐름, 보안 검사, 프로젝트 메모리를 재사용해야 하는 사용자
  • 개인의 Agent 설정을 버전 관리되는 자산으로 정리하려는 소규모 팀

적합하지 않은 대상:

  • 한 번만 질문을 하고 해당 도구 계정도 필요하지 않은 사용자
  • 엄격한 권한, supply chain, 감사 요구사항이 있는 프로젝트. ECC 규칙을 그대로 적용하지 말고 기존 CI, secret manager, 코드 리뷰 흐름에 먼저 연결해야 한다.
  • ECC를 만능 해결책으로 생각하는 사용자. ECC는 설정 계층일 뿐이며, 결과물의 코드 품질은 모델과 작업 자체에 달려 있다.

한 문장으로 정리

ECC는 새로운 모델도 완전한 runtime도 아니라, 재사용 가능한 Agent 엔지니어링 계층을 제공한다. 여러 프로젝트에서 Claude Code, Codex, Cursor 설정을 반복해 구성하고 있다면 README를 읽고 install을 실행한 뒤 skills와 security rules를 프로젝트에 연결해 볼 가치가 있다. 반대로 Agent로 스크립트를 한 번だけ 작성하려는 상황이라면 복잡하게 구성하지 않고 바로 질문하는 편이 낫다.

참고:

출처: https://github.com/affaan-m/ECC