affaan-m/ECC

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

경고

공식 소스만 사용하세요. ECC는 검증된 채널인 GitHub 저장소 github.com/affaan-m/ECC, npm 패키지 ecc-universal 및 ecc-agentshield, GitHub App, 플러그인 슬러그 ecc@ecc, 그리고 프로젝트 웹사이트 ecc.tools를 통해서만 설치해야 합니다. 제3자가 재업로드한 파일이나 비공식 미러 사이트는 프로젝트 측에서 유지 관리하거나 검토하지 않으며, 멀웨어(malware)가 포함되어 있을 수 있습니다.

211.9K+ stars | 32.5K+ forks | 230+ contributors | 12+ 언어 생태계 | 교차 하네스(Cross-harness) 에이전트 워크플로우

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

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

에이전트 중심 작업(agentic work)을 위한 하네스 네이티브(harness-native) 운영체제. 실제 멀티 하네스 엔지니어링 워크플로우를 기반으로 구축되었습니다.

단순한 설정(configs)이 아닙니다. 기술(skills), 본능(instincts), 메모리 최적화(memory optimization), 지속적 학습(continuous learning), 보안 스캐닝(security scanning), 그리고 연구 우선 개발(research-first development)을 포함하는 완전한 시스템입니다. 실제 제품을 구축하며 10개월 이상의 집중적인 일상적 사용을 통해 진화한 프로덕션 준비 완료된 에이전트(agents), 기술(skills), 훅(hooks), 규칙(rules), MCP 설정, 그리고 레거시 명령 심(legacy command shims)을 제공합니다.

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

ECC v2.0.0은 해당 재사용 가능한 레이어 위에 공개적인 Hermes 운영자 스토리를 추가합니다. Hermes 설정 가이드로 시작하여, 2.0.0 릴리스 노트와 교차 하네스 아키텍처(cross-harness architecture)를 검토하십시오.

ECC Pro: Private repos · GitHub App · $19/seat/mo
|
Sponsor: OSS 후원 · From $5/mo
|
Community: Discussions · Q&A · Show & Tell
|
GitHub App: Install · PR audits · Free tier
|

비즈니스 스폰서

CodeRabbit
|
Greptile
|
Atlas Cloud
|

커뮤니티 스폰서: Mike Morgan · @jasonwu513 · @1anter · @massimotodaro · @meadmccabe

이 저장소는 순수 코드(raw code)만 포함하고 있습니다. 가이드에서 모든 것을 설명합니다.

요약 가이드 (The Shorthand Guide)
설정, 기초, 철학.
이것을 먼저 읽으세요. (thread) |
상세 가이드 (The Longform Guide)
토큰 최적화 (Token optimization), 메모리 지속성 (memory persistence), 평가 (evals), 병렬화 (parallelization). (thread)
|

주제	학습 내용
토큰 최적화 (Token Optimization)	모델 선택, 시스템 프롬프트 슬리밍 (system prompt slimming), 백그라운드 프로세스
...
2.0 라인의 안정적인 졸업: 261개의 스킬, 제어 패널 기질 (control-pane substrate) (세션 어댑터 + MCP 인벤토리), 워크트리 라이프사이클 (worktree-lifecycle) 서비스, orch-* 오케스트레이터 (orchestrator) 제품군, 그리고 ECC Discord 커뮤니티 출시. 전체 노트: docs/releases/2.0.0/release-notes.md.

대시보드 GUI (Dashboard GUI)— 다크/라이트 테마 전환, 글꼴 사용자 정의, 헤더 및 작업 표시줄의 프로젝트 로고를 포함한 새로운 Tkinter 기반 데스크톱 애플리케이션 (ecc_dashboard.py 또는 npm run dashboard).

라이브 저장소와 동기화된 공개 인터페이스 (Public surface synced to the live repo)— 메타데이터, 카탈로그 수, 플러그인 매니페스트(manifests), 설치용 문서가 이제 실제 오픈 소스(OSS) 인터페이스와 일치합니다: 66개의 에이전트, 268개의 스킬, 84개의 레거시 명령 심(command shims).

오퍼레이터 및 아웃바운드 워크플로우 확장 (Operator and outbound workflow expansion)— brand-voice, social-graph-ranker, connections-optimizer, customer-billing-ops, ecc-tools-cost-audit, google-workspace-ops, project-flow-ops, 그리고 workspace-surface-audit가 오퍼레이터 레인을 완성합니다.

미디어 및 출시 툴링 (Media and launch tooling)— manim-video, remotion-video-creation, 그리고 업그레이드된 소셜 퍼블리싱 인터페이스를 통해 기술 설명 영상과 출시 콘텐츠가 동일한 시스템의 일부가 되었습니다.

프레임워크 및 제품 인터페이스 성장 (Framework and product surface growth)— nestjs-patterns, 더욱 풍부해진 Codex/OpenCode 설치 인터페이스, 그리고 확장된 크로스 하네스(cross-harness) 패키징을 통해 Claude Code 단독 사용을 넘어 저장소를 활용할 수 있게 합니다.

Itô 예측 시장 스킬 팩 (Itô prediction-market skill pack)— 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 과금 체계와 분리하면서, 공공의 비자문형(non-advisory) 마켓/바스켓 워크플로우(workflows)를 추가합니다.

최적화 스킬 팩 (Optimization skill pack)—parallel-execution-optimizer, benchmark-optimization-loop, data-throughput-accelerator, latency-critical-systems, 그리고 recursive-decision-ledger는 반복되는 속도/재귀 프롬프트를 제한된 벤치마크(benchmark), 처리량(throughput), 그리고 의사결정 원장(decision-ledger) 워크플로우로 전환합니다.

ECC 2.0 alpha가 인트리(in-tree)에 포함되었습니다— ecc2/에 있는 Rust 컨트롤 플레인(control-plane) 프로토타입은 이제 로컬에서 빌드되며 dashboard, start, sessions, status, stop, resume, 그리고 daemon 명령어를 노출합니다. 이는 알파 버전으로서 사용 가능하며, 아직 일반 릴리스(general release) 단계는 아닙니다.

운영자 상태 스냅샷 (Operator status snapshots)— ecc status --markdown --write status.md는 로컬 상태 저장소(state store)를 준비 상태, 활성 세션, 스킬 실행 상태, 설치 상태, 대기 중인 거버넌스(governance) 이벤트, 그리고 Linear/GitHub/handoffs로부터 연결된 작업 항목(work items)을 포함하는 휴대 가능한 인계(handoff) 자료로 변환합니다. 수동 입력을 위해서는 ecc work-items upsert ...를, PR/이슈 큐(queue) 상태를 위해서는 ecc work-items sync-github --repo owner/repo를 사용하며, 준비 상태에 주의가 필요할 때 자동화를 실패시키려면 ecc status --exit-code를 사용하세요.

생태계 강화 (Ecosystem hardening)— AgentShield, ECC Tools 비용 제어, 과금 포털 작업, 그리고 웹사이트 리프레시 작업이 별도의 사일로(silos)로 분리되지 않고 핵심 플러그인을 중심으로 계속 배포되고 있습니다.

선택적 설치 아키텍처 (Selective install architecture)— 대상 컴포넌트 설치를 위해 install-plan.js 및 install-apply.js를 사용하는 매니페스트(Manifest) 기반 설치 파이프라인을 제공합니다. 상태 저장소(State store)는 설치된 항목을 추적하고 점진적 업데이트(incremental updates)를 가능하게 합니다.

6개의 새로운 에이전트 (6 new agents)— typescript-reviewer, pytorch-build-resolver, java-build-resolver, java-reviewer, kotlin-reviewer, kotlin-build-resolver가 추가되어 언어 지원 범위가 10개 언어로 확장되었습니다.

새로운 스킬 (New skills)— 딥러닝 워크플로우를 위한 pytorch-patterns, API 참조 조사를 위한 documentation-lookup, 현대적인 JS 툴체인(toolchains)을 위한 bun-runtime 및 nextjs-turbopack, 그리고 8개의 운영 도메인 스킬과 mcp-server-patterns가 추가되었습니다.

세션 및 상태 인프라 (Session & state infrastructure)— 쿼리 CLI를 갖춘 SQLite 상태 저장소 (state store), 구조화된 기록을 위한 세션 어댑터 (session adapters), 자기 개선 기술 (self-improving skills)을 위한 기술 진화 기반 (skill evolution foundation).

오케스트레이션 개편 (Orchestration overhaul)— Harness 감사 점수 (audit scoring)의 결정론적 (deterministic) 구현, 오케스트레이션 상태 및 런처 호환성 강화, 5단계 가드 (5-layer guard)를 통한 옵저버 루프 (observer loop) 방지.

옵저버 신뢰성 (Observer reliability)— 스로틀링 (throttling) 및 테일 샘플링 (tail sampling)을 통한 메모리 폭발 해결, 샌드박스 (sandbox) 액세스 수정, 지연 시작 (lazy-start) 로직 및 재진입 가드 (re-entrancy guard).

12개 언어 생태계 (12 language ecosystems)— Java, PHP, Perl, Kotlin/Android/KMP, C++, Rust를 위한 새로운 규칙이 기존의 TypeScript, Python, Go 및 공통 규칙에 추가되었습니다.

커뮤니티 기여 (Community contributions)— 한국어 및 중국어 번역, biome 훅 (hook) 최적화, 비디오 처리 기술 (video processing skills), 운영 기술 (operational skills), PowerShell 설치 프로그램, Antigravity IDE 지원.

CI 강화 (CI hardening)— 19개의 테스트 실패 수정, 카탈로그 수 강제 적용, 설치 매니페스트 (install manifest) 검증, 전체 테스트 스위트 통과 (green).

Harness 우선 릴리스 (Harness-first release)— ECC는 이제 단순한 설정 팩 (config pack)이 아니라, 명시적으로 에이전트 하네스 성능 시스템 (agent harness performance system)으로 정의됩니다.

훅 신뢰성 개편 (Hook reliability overhaul)— SessionStart 루트 폴백 (fallback), 중지 단계 (Stop-phase) 세션 요약, 그리고 취약한 인라인 원라이너 (inline one-liners)를 대체하는 스크립트 기반 훅 (script-based hooks).

훅 런타임 제어 (Hook runtime controls)— 훅 파일을 수정하지 않고도 런타임 게이팅 (runtime gating)을 할 수 있도록 ECC_HOOK_PROFILE=minimal|standard|strict 및 ECC_DISABLED_HOOKS=... 지원.

새로운 하네스 명령 (New harness commands)— /harness-audit, /loop-start, /loop-status, /quality-gate, /model-route.

NanoClaw v2— 모델 라우팅 (model routing), 기술 핫로드 (skill hot-load), 세션 브랜치/검색/내보내기/압축/메트릭 (session branch/search/export/compact/metrics).

교차 하네스 동등성 (Cross-harness parity)— Claude Code, Cursor, OpenCode, Codex 앱/CLI 전반에 걸쳐 동작 강화.

997개 내부 테스트 통과 (997 internal tests passing)— 훅/런타임 리팩터링 (refactor) 및 호환성 업데이트 이후 전체 스위트 통과 (green).

Codex 앱 + CLI 지원 (Codex app + CLI support)— AGENTS.md 기반의 직접적인 Codex 지원, 설치 프로그램 타겟팅, 그리고 Codex 문서— PPTX 변환 가이드 및 엄격한 뷰포트 맞춤 (viewport-fit) 규칙을 갖춘 의존성 없는 HTML 프레젠테이션 빌더 frontend-slides.

5개의 새로운 범용 비즈니스/콘텐츠 기술 (skills)—article-writing (기사 작성), content-engine (콘텐츠 엔진), market-research (시장 조사), investor-materials (투자자 자료), investor-outreach (투자자 아웃리치)

더 넓은 도구 커버리지 (Broader tool coverage)— Cursor, Codex, OpenCode 지원이 강화되어 동일한 저장소(repo)가 모든 주요 하네스(harnesses)에서 깔끔하게 배포됩니다.

992개의 내부 테스트 (internal tests)— 플러그인, 훅 (hooks), 기술 (skills), 패키징 전반에 걸쳐 검증 및 회귀 테스트 (regression) 커버리지를 확장했습니다.

Codex CLI 지원 (Codex CLI support)— 새로운 /codex-setup 명령어가 OpenAI Codex CLI 호환성을 위한 codex.md를 생성합니다.

7개의 새로운 기술 (7 new skills)— search-first (검색 우선), swift-actor-persistence (Swift 액터 지속성), swift-protocol-di-testing (Swift 프로토콜 DI 테스트), regex-vs-llm-structured-text (정규 표현식 vs LLM 구조화된 텍스트), content-hash-cache-pattern (콘텐츠 해시 캐시 패턴), cost-aware-llm-pipeline (비용 인식 LLM 파이프라인), skill-stocktake (기술 재고 조사)

AgentShield 통합 (AgentShield integration)— /security-scan 기술이 Claude Code에서 AgentShield를 직접 실행합니다; 1282개의 테스트, 102개의 규칙 적용.

GitHub Marketplace— ECC Tools GitHub App이 github.com/marketplace/ecc-tools에서 무료/Pro/Enterprise 티어로 출시되었습니다.

30개 이상의 커뮤니티 PR 병합 (30+ community PRs merged)— 6개 언어에 걸쳐 30명의 기여자가 참여했습니다.

978개의 내부 테스트 (978 internal tests)— 에이전트 (agents), 기술 (skills), 명령 (commands), 훅 (hooks), 규칙 (rules) 전반에 걸쳐 검증 스위트 (validation suite)를 확장했습니다.

instinct 임포트 콘텐츠 손실 수정 (Fixed instinct import content loss)— /instinct-import 실행 중 parse_instinct_file()이 프런트매터 (frontmatter) 이후의 모든 콘텐츠(Action, Evidence, Examples 섹션)를 조용히 누락시키던 문제를 수정했습니다. (#148, #161)

대화형 설치 마법사 (Interactive installation wizard)— 새로운 configure-ecc 기술이 병합/덮어쓰기 감지 기능이 포함된 가이드형 설정을 제공합니다.

PM2 및 멀티 에이전트 오케스트레이션 (PM2 & multi-agent orchestration)— 복잡한 멀티 서비스 워크플로 관리를 위한 6개의 새로운 명령어 (/pm2, /multi-plan, /multi-execute, /multi-backend, /multi-frontend, /multi-workflow)가 추가되었습니다.

다중 언어 규칙 아키텍처 (Multi-language rules architecture)— 규칙 구조를 평면 파일 (flat files)에서 common/ + typescript/ + python/ + golang/ 형태로 재구성했습니다.

디렉토리입니다. 필요한 언어만 설치하세요.중국어 (zh-CN) 번역— 모든 에이전트 (agents), 명령어 (commands), 스킬 (skills), 규칙 (rules)에 대한 완전한 번역 (80개 이상의 파일)GitHub Sponsors 지원— GitHub Sponsors를 통해 프로젝트를 후원하세요강화된 CONTRIBUTING.md— 각 기여 유형에 대한 상세한 PR 템플릿

전체 OpenCode 통합— OpenCode의 플러그인 시스템을 통해 12개의 에이전트 (agents), 24개의 명령어 (commands), 16개의 스킬 (skills) 및 훅 (hook) 지원 (20개 이상의 이벤트 유형)
3개의 네이티브 커스텀 도구 (custom tools)— run-tests, check-coverage, security-audit
LLM 문서화— llms.txt (포괄적인 OpenCode 문서를 위해)

Python/Django 지원— Django 패턴, 보안, TDD 및 검증 스킬
Java Spring Boot 스킬— Spring Boot를 위한 패턴, 보안, TDD 및 검증
세션 관리 (Session management)— 세션 기록을 위한 /sessions 명령어
지속적 학습 (Continuous learning) v2— 신뢰도 점수 (confidence scoring), 가져오기/내보내기 (import/export), 진화 (evolution) 기능이 포함된 본능 기반 학습

전체 변경 로그는 Releases에서 확인하세요.

2분 안에 시작하기:

대부분의 Claude Code 사용자는 정확히 하나의 설치 경로를 사용해야 합니다:

권장 기본값: Claude Code 플러그인을 설치한 다음, 실제로 원하는 규칙 (rule) 폴더만 복사하세요.
수동 설치 프로그램을 사용하는 경우: 더 세밀한 제어를 원하거나, 플러그인 경로를 완전히 피하고 싶거나, 사용 중인 Claude Code 빌드에서 셀프 호스팅 마켓플레이스 항목을 해결하는 데 문제가 있는 경우에만 사용하세요.
설치 방법을 중복해서 사용하지 마세요. 가장 흔하게 발생하는 오류 설정은 다음과 같습니다:
먼저 /plugin install을 실행한 후,
그다음에 install.sh --profile full 또는 npx ecc-install --profile full을 실행하는 경우입니다.

이미 여러 설치를 겹쳐서 진행하여 항목이 중복되어 보인다면, 바로 ECC 초기화 / 삭제 (Reset / Uninstall ECC) 단계로 넘어가세요.

훅 (hooks)이 너무 전역적이라고 느껴지거나 ECC의 규칙 (rules), 에이전트 (agents), 명령어 (commands), 핵심 워크플로우 스킬 (workflow skills)만 원하는 경우, 플러그인을 건너뛰고 최소한의 수동 프로필 (minimal manual profile)을 사용하세요:

./install.sh --profile minimal --target claude

.\install.ps1 --profile minimal --target claude
# 또는
npx ecc-install --profile minimal --target claude

이 프로필은 의도적으로 hooks-runtime을 제외합니다.

일반적인 core 프로필을 원하지만 hooks를 끄고 싶다면 다음을 사용하세요:

./install.sh --profile core --without baseline:hooks --target claude

런타임 강제 적용 (runtime enforcement)이 필요한 경우에만 나중에 hooks를 추가하세요:

./install.sh --target claude --modules hooks-runtime

어떤 ECC 프로필이나 컴포넌트 (component)를 설치해야 할지 확실하지 않다면, 어떤 프로젝트에서든 패키징된 어드바이저 (advisor)에게 물어보세요:

npx ecc consult "security reviews" --target claude

이 명령은 일치하는 컴포넌트, 관련 프로필, 그리고 미리보기/설치 명령어를 반환합니다. 정확한 파일 계획을 검토하고 싶다면 설치 전에 미리보기 (preview) 명령어를 사용하세요.

프로덕션 (production) ML/MLOps 워크플로우의 경우, 설치 시 선택 사항 (opt-in)을 유지하고 컴포넌트 범위 (component-scoped)로 관리하세요:

npx ecc consult "mlops training model deployment" --target claude
npx ecc install --profile minimal --target claude --with capability:machine-learning