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.

GitHub에서 열기 ↗ ai-agentsanthropicclaudeclaude-codedeveloper-toolsllmmcpproductivity
228,058
GitHub 스타
34,983
포크
JavaScript
언어
MIT
라이선스
2026.07.09
최근 푸시
2026.06.03
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
에이전트 기반 개발 워크플로를 최적화하고자 하는 개발자에게 적합합니다. 특히 여러 AI 하네스를 사용하거나 고급 스킬, 메모리 관리, 보안 기능이 필요한 팀에 유용합니다.

강점

  • 매우 높은 스타 수(211.9K+)와 포크 수(32.5K+)로 커뮤니티 검증 및 신뢰도가 높습니다.
  • 다양한 AI 에이전트 하네스(Claude Code, Codex, Cursor 등)를 지원하며, 스킬, 메모리, 보안 등 포괄적인 기능을 제공합니다.
  • MIT 라이선스로 오픈소스이며, 활발한 개발(매주 업데이트)과 다양한 언어 번역을 지원합니다.

약점

  • README가 매우 길고 상세하여 초보자가 처음 접근하기에 부담스러울 수 있습니다.
  • 일부 기능(예: ECC Pro, Hermes 운영자)은 유료 구독 또는 추가 설정이 필요합니다.
  • Rust 기반 ECC 2.0 알파는 아직 일반 릴리스가 아니므로 안정성이 보장되지 않습니다.

주의사항

  • 공식 소스(깃허브, npm, 공식 웹사이트)를 통해서만 설치해야 하며, 타사 재업로드는 악성 코드 위험이 있습니다.
  • v2.0.0-rc.1과 같은 릴리스 후보 버전은 프로덕션에서 사용 시 주의가 필요합니다.
  • Itô 예측 시장 스킬 팩은 라이브 API 액세스가 게이트 처리되어 있어 추가 설정이 필요할 수 있습니다.

시작 가이드

  • 단축 가이드(the-shortform-guide.md)를 먼저 읽어 프로젝트의 기본 철학과 설정 방법을 이해하세요.
  • 공식 채널(npm 패키지 ecc-universal 또는 GitHub 저장소)을 통해 ECC를 설치하세요.
  • 사용 중인 AI 하네스(예: Claude Code, Cursor)에 맞는 설치 표면을 확인하고 적용하세요.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

언어: English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย | Deutsch | Español

!ECC — the agent harness operating system

[!WARNING]

공식 소스만 사용하세요. ECC는 검증된 채널(깃허브 저장소 github.com/affaan-m/ECC, npm 패키지 ecc-universalecc-agentshield, GitHub App, 플러그인 슬러그 ecc@ecc, 프로젝트 웹사이트 ecc.tools)을 통해서만 설치하세요. 타사 재업로드 및 비공식 미러는 프로젝트에서 유지 관리하거나 검토하지 않으며 악성 코드를 포함할 수 있습니다.

211.9K+ 스타 | 32.5K+ 포크 | 230+ 기여자 | 12+ 언어 생태계 | 교차 하네스 에이전트 워크플로


<div align="center">

Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ / Idioma

English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย | Deutsch | Español

</div>


에이전트 작업을 위한 하네스 네이티브 운영자 시스템입니다. 실제 다중 하네스 엔지니어링 워크플로에서 구축되었습니다.

단순한 설정이 아닙니다. 완전한 시스템입니다: 스킬, 본능, 메모리 최적화, 지속적 학습, 보안 스캐닝, 연구 우선 개발. 실제 제품을 구축하는 10개월 이상의 집중적인 일일 사용을 통해 진화한 프로덕션 준비 에이전트, 스킬, 훅, 규칙, MCP 구성 및 레거시 명령어 심(shim)입니다.

Codex, Claude Code, Cursor, OpenCode, Gemini, Zed, GitHub Copilot 및 기타 AI 에이전트 하네스에서 작동합니다.

ECC v2.0.0은 재사용 가능한 레이어 위에 공개 Hermes 운영자 스토리를 추가합니다: Hermes 설정 가이드로 시작한 다음 2.0.0 릴리스 노트와 교차 하네스 아키텍처를 검토하세요.


<table> <tr> <td width="25%" align="center"> <a href="https://ecc.tools/pricing"> <strong> ECC Pro</strong><br /> <sub>비공개 저장소 · GitHub App · $19/좌석/월</sub> </a> </td> <td width="25%" align="center"> <a href="https://github.com/sponsors/affaan-m"> <strong> 스폰서</strong><br /> <sub>OSS 자금 지원 · 월 $5부터</sub> </a> </td> <td width="25%" align="center"> <a href="https://github.com/affaan-m/ECC/discussions"> <strong>커뮤니티</strong> <br /> <sub>토론 · Q&A · 쇼앤텔</sub> </a> </td> <td width="25%" align="center"> <a href="https://github.com/apps/ecc-tools"> <strong> GitHub App</strong><br /> <sub>설치 · PR 감사 · 무료 티어</sub> </a> </td> </tr> </table>

<sub>OSS는 무료로 유지됩니다. 이 저장소는 영원히 MIT 라이선스입니다. ECC Pro는 비공개 저장소를 위한 호스팅 GitHub App입니다. <a href="https://github.com/sponsors/affaan-m">스폰서</a>와 <a href="https://ecc.tools/pricing">Pro 구독자</a>가 작업 자금을 지원합니다. 이것이 단일 관리자가 7개의 하네스에 걸쳐 매주 업데이트를 제공하는 이유입니다.</sub>

<div align="center">

<sub><strong>비즈니스 스폰서</strong></sub>

<table> <tr> <td align="center" width="220"> <a href="https://www.coderabbit.ai"> <img src="assets/images/sponsors/coderabbit.png" width="96" alt="CodeRabbit 로고" /><br /> <strong>CodeRabbit</strong> </a> </td> <td align="center" width="220"> <a href="https://www.greptile.com/go/ecc"> <img src="assets/images/sponsors/greptile.png" width="96" alt="Greptile 로고" /><br /> <strong>Greptile</strong> </a> </td> <td align="center" width="220"> <a href="https://www.atlascloud.ai/?utmsource=github&utmmedium=link&utm_campaign=ECC"> <img src="assets/images/sponsors/atlascloud.png" width="96" alt="Atlas Cloud 로고" /><br /> <strong>Atlas Cloud</strong> </a> </td> </tr> </table>

<sub><strong>커뮤니티 스폰서:</strong> <a href="https://github.com/mikejmorgan-ai">Mike Morgan</a> · <a href="https://github.com/jasonwu513">@jasonwu513</a> · <a href="https://github.com/1anter">@1anter</a> · <a href="https://github.com/massimotodaro">@massimotodaro</a> · <a href="https://github.com/meadmccabe">@meadmccabe</a></sub>

<sub><a href="https://github.com/sponsors/affaan-m"><strong>스폰서 되기</strong></a> · <a href="SPONSORS.md">스폰서 등급</a> · <a href="SPONSORING.md">스폰서십 프로그램</a></sub>

</div>


가이드

이 저장소는 원시 코드만 포함합니다. 가이드가 모든 것을 설명합니다.

<table> <tr> <td width="50%" align="center"> <a href="./the-shortform-guide.md"> <img src="./assets/images/shortform/00-header.png" width="420" alt="ECC 단축 가이드" /><br /> <b>단축 가이드</b> </a> <br /><sub>설정, 기초, 철학. <b>이것을 먼저 읽으세요.</b> (<a href="https://x.com/affaan/status/2012378465664745795">스레드</a>)</sub> </td> <td width="50%" align="center"> <a href="./the-longform-guide.md"> <img src="./assets/images/longform/01-header.png" width="420" alt="ECC 장문 가이드" /><br /> <b>장문 가이드</b> </a> <br /><sub>토큰 최적화, 메모리 지속성, 평가, 병렬화. (<a href="https://x.com/affaan/status/2014040193557471352">스레드</a>)</sub> </td> </tr> </table>

<div align="center"> <a href="./the-security-guide.md"> <img src="./assets/images/security/security-guide-header.png" width="420" alt="모든 에이전트 보안에 대한 단축 가이드" /><br /> <b>보안 가이드</b> </a> <br /><sub>공격 벡터, 샌드박싱, 살균, CVE, AgentShield. (<a href="https://x.com/affaan/status/2033263813387223421">스레드</a>)</sub> </div>

주제 배울 내용
토큰 최적화 모델 선택, 시스템 프롬프트 축소, 백그라운드 프로세스
메모리 지속성 세션 간 컨텍스트를 자동으로 저장/로드하는 훅
지속적 학습 세션에서 패턴을 자동 추출하여 재사용 가능한 스킬로 변환
검증 루프 체크포인트 vs 연속 평가, 채점자 유형, pass@k 메트릭
병렬화 Git 워크트리, 캐스케이드 방식, 인스턴스 확장 시기
서브에이전트 오케스트레이션 컨텍스트 문제, 반복 검색 패턴

새로운 기능

v2.0.0 — 에이전트 하네스 운영 체제 (2026년 6월)

2.0 라인의 안정적인 버전: 261개의 스킬, 제어판 기반(세션 어댑터 + MCP 인벤토리), 워크트리 수명주기 서비스, orch-* 오케스트레이터 제품군, ECC Discord 커뮤니티 출시. 전체 노트: docs/releases/2.0.0/release-notes.md.

v2.0.0-rc.1 — 표면 개선, 운영자 워크플로 및 ECC 2.0 알파 (2026년 4월)

  • 대시보드 GUI — 새로운 Tkinter 기반 데스크톱 애플리케이션 (ecc_dashboard.py 또는 npm run dashboard), 다크/라이트 테마 전환, 글꼴 사용자 지정, 헤더 및 작업 표시줄의 프로젝트 로고.
  • 공개 표면이 라이브 저장소와 동기화됨 — 메타데이터, 카탈로그 수, 플러그인 매니페스트 및 설치 관련 문서가 실제 OSS 표면과 일치: 66개 에이전트, 268개 스킬, 84개 레거시 명령어 심.
  • 운영자 및 아웃바운드 워크플로 확장brand-voice, social-graph-ranker, connections-optimizer, customer-billing-ops, ecc-tools-cost-audit, google-workspace-ops, project-flow-ops, workspace-surface-audit이 운영자 영역을 완성합니다.
  • 미디어 및 출시 도구manim-video, remotion-video-creation 및 업그레이드된 소셜 게시 표면으로 기술 설명자와 출시 콘텐츠를 동일한 시스템의 일부로 만듭니다.
  • 프레임워크 및 제품 표면 성장nestjs-patterns, 더 풍부한 Codex/OpenCode 설치 표면, 확장된 교차 하네스 패키징으로 저장소를 Claude Code 이상에서 사용할 수 있습니다.
  • Itô 예측 시장 스킬 팩ito-market-intelligence, ito-basket-compare, ito-trade-planner, ito-data-atlas-agent, prediction-market-oracle-research, prediction-market-risk-review는 공개 비자문 시장/바스켓 워크플로를 추가하면서 라이브 Itô API 액세스를 게이트 처리하고 ECC Tools 청구와 분리합니다.
  • 최적화 스킬 팩parallel-execution-optimizer, benchmark-optimization-loop, data-throughput-accelerator, latency-critical-systems, recursive-decision-ledger는 반복적인 속도/재귀 프롬프트를 제한된 벤치마크, 처리량 및 결정 원장 워크플로로 전환합니다.
  • ECC 2.0 알파가 트리에 포함됨ecc2/의 Rust 제어판 프로토타입이 이제 로컬에서 빌드되며 dashboard, start, sessions, status, stop, resume, daemon 명령어를 노출합니다. 알파로 사용 가능하며 아직 일반 릴리스는 아닙니다.
  • 운영자 상태 스냅샷ecc status --markdown --write status.md는 로컬 상태 저장소를 준비 상태, 활성 세션, 스킬 실행 상태, 설치 상태, 보류 중인 거버넌스 이벤트 및 Linear/GitHub/핸드오프의 연결된 작업 항목을 다루는 이식 가능한 핸드오프로 전환합니다. 수동 항목에는 ecc work-items upsert...를, PR/이슈 큐 상태에는 ecc work-items sync-github --repo owner/repo를, 자동화가 준비 상태에 주의가 필요할 때 실패하도록 ecc status --exit-code를 사용하세요.
  • 생태계 강화 — AgentShield, ECC Tools 비용 제어, 결제 포털 작업 및 웹사이트 새로 고침이 핵심 플러그인 주변에서 계속 제공됩니다.

v1.9.0 — 선택적 설치 및 언어 확장 (2026년 3월)

  • 선택적 설치 아키텍처 — 매니페스트 기반 설치 파이프라인, 대상 구성 요소 설치를 위한 install-plan.jsinstall-apply.js. 상태 저장소는 설치된 항목을 추적하고 증분 업데이트를 가능하게 합니다.
  • 6개의 새로운 에이전트typescript-reviewer, pytorch-build-resolver, java-build-resolver, java-reviewer, kotlin-reviewer, kotlin-build-resolver가 언어 범위를 10개 언어로 확장합니다.
  • 새로운 스킬 — 딥러닝 워크플로를 위한 pytorch-patterns, API 참조 연구를 위한 documentation-lookup, 최신 JS 도구 체인을 위한 bun-runtimenextjs-turbopack, 8개의 운영 도메인 스킬 및 mcp-server-patterns.
  • 세션 및 상태 인프라 — 쿼리 CLI가 있는 SQLite 상태 저장소, 구조화된 기록을 위한 세션 어댑터, 자기 개선 스킬을 위한 스킬 진화 기반.
  • 오케스트레이션 개편 — 하네스 감사 점수가 결정론적으로 만들어지고, 오케스트레이션 상태 및 런처 호환성이 강화되고, 5계층 가드로 관찰자 루프 방지.
  • 관찰자 안정성 — 스로틀링 및 테일 샘플링을 통한 메모리 폭발 수정, 샌드박스 액세스 수정, 지연 시작 로직 및 재진입 가드.
  • 12개 언어 생태계 — Java, PHP, Perl, Kotlin/Android/KMP, C++, Rust에 대한 새로운 규칙이 기존 TypeScript, Python, Go 및 공통 규칙에 합류합니다.
  • 커뮤니티 기여 — 한국어 및 중국어 번역, biome 훅 최적화, 비디오 처리 스킬, 운영 스킬, PowerShell 설치 프로그램, Antigravity IDE 지원.
  • CI 강화 — 19개의 테스트 실패 수정, 카탈로그 수 강제, 설치 매니페스트 검증 및 전체 테스트 스위트 통과.

v1.8.0 — 하네스 성능

[...생략...]

원본 저장소: affaan-m/ECC

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.