Gambar: GitHub

ECC: Agent Harness Performance Optimization System

Dunia AI coding agents sedang mengalami revolusi. Dari yang awalnya cuma chat-based coding assistant, sekarang AI agents sudah bisa menulis kode, menjalankan test, melakukan code review, bahkan mengatur security scanning secara otomatis. Tapi masalahnya? Workflow yang terkoordinasi itu sulit dibangun dari nol di setiap prompt.

Masuklah ECC (Agent Harness Performance Optimization System) — sebuah open-source project dengan 240K+ stars di GitHub yang menjadi "sistem operasi" untuk AI coding agents. ECC memberikan skills, agents, memory, dan security kepada AI agents agar bisa bekerja seperti engineer profesional yang terstruktur.

Apa Itu ECC?

ECC bukan sekadar kumpulan prompt atau config file. ECC adalah sistem terkoordinasi lengkap yang memberikan kemampuan engineering kepada AI agents:

plan -> test -> implement -> review -> verify -> remember -> improve

Alih-alih membangun proses itu di setiap prompt, kamu install sekali dan menjadikannya bagian dari cara agent bekerja. ECC tersedia secara gratis dan open-source di bawah lisensi MIT, dengan repository utama di github.com/affaan-m/ECC dan homepage di ecc.tools.

Apa yang ECC berikan?

ECC bukan hanya "banyak skill". Ia mengorganisir seluruh workflow AI coding agent ke dalam komponen-komponen yang terpisah dan terkoordinasi:

• 68 agents — sub-agent spesialis untuk planning, review, build repair, security, architecture, dan domain work
• 284 skills — reusable workflows yang dimuat sesuai kebutuhan (TDD, security review, deep research, dll.)
• 94 commands — slash commands sebagai entry point (sedang migrasi ke skills-first)
• Hooks & Memory — runtime automation, session summaries, continuous learning, instincts, dan context controls
• Rules — standar projek atau bahasa yang dipilih secara selektif
• AgentShield — 102 rules keamanan yang memindai setiap session

Kenapa Bisa Populer (240K+ Stars)?

ECC mendapat 240K+ stars bukan tanpa alasan. Beberapa faktor utama:

1. Solved a real problem — Developer butuh workflow terstruktur untuk AI agents, bukan cuma prompt kosong
2. Multi-harness support — Bekerja dengan Claude Code, Codex, Cursor, OpenCode, dan banyak lagi
3. Battle-tested — Dibangun oleh Affaan Mustafa (pemenang hackathon Anthropic x Forum Ventures, September 2025) dan sudah dipakai di production
4. MIT license forever — Selalu gratis, open-source
5. Community aktif — 36.4K+ forks, komunitas Discord yang aktif, dan weekly releases
6. Enterprise-ready — GitHub App untuk private repos, Pro plan dari $19/seat/bulan

Fitur Utama ECC

1. Skills — Workflow yang Dimuat Saat Dibutuhkan

Skills adalah reusable workflows yang dimuat hanya ketika task membutuhkannya. Ini menjaga context window tetap fokus:

Contoh penggunaan skills:

/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, dan tests

2. Instincts — Continuous Learning

Instincts adalah pola-pola yang dipelajari dari sesi kerja nyata, complete dengan confidence scores. Jadi ketika agent menghadapi situasi serupa, ia bisa "mengingat" pendekatan yang sudah terbukti berhasil.

ecc memory init --scope project
ecc memory search "authentication migration" --target-harness codex
ecc memory doctor

3. Memory — Unified Memory Vault

Memory Vault memberikan satu format Markdown yang lokal dan inspectable untuk durable context dan handoffs antar harness:

• Project/team memories → .ecc/memory/
• User memories → ~/.ecc/memory/

Memory bukan executable policy, tapi unreviewed context. Kamu harus verifikasi klaim penting terhadap authoritative sources dan promote accepted knowledge ke governed project documentation.

Optional ecc-memory-mcp stdio server bisa expose save/search/read/doctor surface tanpa mengaktifkan dirinya secara default.

4. Security — AgentShield

AgentShield adalah security auditor untuk konfigurasi agents dengan 102 security rules yang memindai:

• Prompt injection
• Hook configurations
• MCP configs
• Permissions
• Secrets
• Agent files

npx -y ecc-agentshield scan --path .

Kamu juga bisa scan langsung dari slash command:

/security-scan

5. Research-First Development

ECC mendorong pendekatan research-first dalam development. Sebelum menulis kode, agent harus:

1. Plan — Buat rencana yang bisa diedit sebelum implementasi
2. Research — Cari tahu best practices dan pendekatan yang ada
3. Test — Tulis test yang gagal dulu (RED phase)
4. Implement — Tulis kode sampai test passing (GREEN phase)
5. Review — Review dari context yang fresh
6. Verify — Pastikan build, lint, types, dan tests semua passing

Cara Kerja ECC

Struktur Repository

ECC/
├── agents/           # 68 specialized subagents untuk delegation
├── skills/           # 284 reusable workflows yang dimuat on-demand
├── commands/         # 94 maintained slash-command shims
├── rules/            # opt-in common dan language standards
├── hooks/            # runtime automation dan enforcement
├── scripts/          # install, repair, sync, orchestration, dan checks
├── .claude-plugin/   # Claude Code marketplace manifest
├── .codex/           # Codex reference configuration dan agent roles
├── .opencode/        # OpenCode plugin, commands, dan instructions
├── .cursor/          # Cursor rules dan hook adapter
├── docs/             # public setup, architecture, dan operating guides

Root adalah source of truth. Platform adapters mempackage atau memetakan workflow yang sama alih-alih mempertahankan copy terpisah.

TDD Workflow — Contoh Lengkap

Berikut alur TDD yang diimplementasikan oleh ECC:

/ecc:plan "Add usage-based billing alerts"
  -> confirm atau edit plan
  -> activate tdd-workflow
  -> capture RED evidence (test yang gagal) sebelum implementasi
  -> implement sampai GREEN (test passing)
  -> review dari fresh context (agent terpisah)
  -> fix findings dengan regression tests
  -> verify: build ✓, lint ✓, types ✓, tests ✓

Sebuah result bukan hanya kode. Ia adalah trail of evidence: plan, failing test, passing test, review findings, dan verification final.

Plan Canvas — Fitur Baru ECC 2.1

Plan Canvas adalah browser canvas loopback-only di mana kamu bisa:

1. Review plan dengan meng-klik, bukan mengetik ulang
2. Attach numbered annotations
3. Chat dari side rail
4. Approve plan atau request changes
5. Mermaid diagrams render live

# Contoh penggunaan
/ecc:plan "describe the feature"
# Review dari browser canvas, bukan terminal

Canvas-nya harness-agnostic dan model-agnostic: sebuah plain CLI (ecc-plan-canvas) yang bicara JSON, jadi agent apapun bisa menggunakannya.

Kompatibilitas dengan AI Agents

ECC mendukung berbagai AI coding agents dengan tingkat kompatibilitas yang berbeda:

Claude Code (Stable Primary)

Claude Code adalah target utama ECC dengan dukungan paling lengkap:

# Install via native plugin
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Atau tambahkan rules secara manual:

git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/  # ganti dengan stack-mu

Fitur yang tersedia: Instructions native, skills native, agents native, ECC plugin hooks, MCP configuration.

Codex (Supported Sync + Marketplace Experimental)

# Install via Codex marketplace
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
node scripts/codex/check-plugin-cache.js

Atau gunakan sync flow untuk path yang lebih reliable:

git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
bash scripts/sync-ecc-to-codex.sh

Fitur yang tersedia: Instructions via AGENTS.md, native synced skills set, Codex multi-agent roles, TOML merge through sync. Limitasi: No ECC hook runtime.

Cursor (Beta Project Adapter)

# Install ke .cursor/
ecc install --target cursor

Fitur yang tersedia: Project rules, build-dependent project agents, Cursor hook adapter. Limitasi: Agent discovery varies by Cursor build, hook sets tidak identik.

OpenCode (Beta Built Plugin)

# Build plugin, lalu selective installer
ecc install --target opencode

Fitur yang tersedia: Plugin instructions, built skills subset, plugin agents, plugin events. Limitasi: ECC ship subset catalog, reference config pins Anthropic models.

Platform Lainnya

Cross-Tool Capability Map

Instalasi

Metode 1: Plugin (Recommended untuk Claude Code)

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Metode 2: npm Package

npm i -g ecc-universal

Metode 3: Multi-Harness Wizard (Coming in 2.2)

npx ecc-universal install --guided

Wizard ini memungkinkan kamu memilih kombinasi Claude Code, Codex, dan Kimi Code dalam satu flow.

Metode 4: GitHub App (untuk Private Repos)

# 1. Install app di repo atau org
# 2. Comment /ecc-tools analyze
# 3. Review generated pull request

Penting: Pick One Path Only (per Harness)

• Recommended today untuk Claude Code: pakai native plugin commands
• Works: Claude Code plugin + Codex native plugin
• Works: Claude Code plugin + legacy Codex sync flow
• Avoid: Claude Code plugin + full Claude manual install
• Avoid: Codex sync + Codex marketplace plugin

Jangan stack install methods. Installing ECC dua kali ke harness yang sama bisa menduplikasi skills, commands, hooks, atau configuration.

Verifikasi Instalasi

# Cek status instalasi
ecc memory doctor
 
# Dry run untuk Codex
npx ecc-universal install --guided --harness codex --dry-run
 
# Dry run untuk Kimi
npx ecc-universal install --profile core --target kimi --dry-run

Use Cases

1. Membangun Feature dengan TDD

/ecc:plan "Add usage-based billing alerts"
-> TDD workflow
-> RED: tulis test yang gagal
-> GREEN: implement sampai test passing
-> Review dari fresh context
-> Verify: build, lint, types, tests

2. Fixing Bugs

Reproduce bug dengan failing test, lalu gunakan TDD workflow untuk fix. ECC akan memastikan regresi test ditulis dan semua verification passing.

3. Code Review

/code-review

Fresh-context review dari agent terpisah mencari regressions dan blind spots.

4. Build Repair

/build-fix

Automated build repair dengan evidence trail.

5. Codebase Cleanup

/refactor-clean

Systematic codebase cleanup.

6. Context Budget Management

/context-budget

Monitor dan manage context window pressure.

7. Session Management

/save-session atau /learn-eval   # End long session
/resume-session                  # Resume later

8. Security Audit

/security-scan

Atau jalankan AgentShield langsung:

npx -y ecc-agentshield scan --path .

Perbandingan: ECC vs Frameworks Lain

ECC vs Prompt Engineering Manual

ECC vs Custom Framework Lain

ECC vs Simple Prompt Templates

ECC bukan prompt template biasa. Perbedaan fundamental:

1. Structured workflow — ECC punya gated workflow (plan→test→implement→review→verify) yang enforced oleh hooks, bukan cuma instruksi
2. Runtime enforcement — Hooks jalan di luar model context, jadi tidak bisa di-bypass oleh model
3. Continuous learning — Instincts dan memory vault memungkinkan agent belajar dari session sebelumnya
4. Security scanning — AgentShield memindai agent config sebagai attack surface, bukan hanya trust-by-default

Token Optimization

Penggunaan agent bisa mahal kalau tidak manage token consumption. ECC menyediakan beberapa optimasi:

# Cek context pressure
/context-budget
 
# Strategic compaction
# Context window management via hooks

Beberapa best practices:

• Gunakan selective/profile install hanya komponen yang dibutuhkan
• Gunakan background processes untuk tasks yang panjang
• Manfaatkan session save/resume untuk long-running work
• Monitor token usage secara berkala

ECC 2.1 — Fitur Terbaru

Plan Canvas

Browser-based plan review dengan:

• Click-based annotation (bukan typing)
• Side rail chat
• Mermaid diagram live rendering
• Approve/Request changes workflow

Kimi Code Install Target

ECC sekarang bisa install native ke Moonshot AI's Kimi Code CLI:

ecc install --target kimi

Self-Hosted GPU Computing

Path verified dengan Itô untuk self-hosted compute, termasuk opt-in ecc ito find RFQ bridge.

Hermes + OpenClaw Install Targets

Install targets baru untuk Hermes dan OpenClaw harness.

Tips untuk Developer Indonesia

1. Mulai dari kebutuhan, bukan full catalog — Install hanya skills yang kamu butuhkan
2. Gabung komunitas Discord — discord.gg/36yGMHGFbR untuk Q&A dan show-and-tell
3. Baca guides dulu — The Shorthand Guide untuk setup dan day-one use
4. Gunakan GitHub App — Untuk private repos di tim, GitHub App adalah path tercepat
5. Jangan lupa security — Jalankan AgentShield secara berkala untuk scan agent config

Kesimpulan

ECC bukan sekadar kumpulan prompt atau config — ia adalah sistem operasi lengkap untuk AI coding agents. Dengan 240K+ stars, 68 agents, 284 skills, dan dukungan untuk 7+ harnesses, ECC memberikan workflow terstruktur yang mengubah AI agent dari "bisa nulis kode" menjadi "bisa bekerja seperti engineer profesional".

Bagi developer Indonesia yang sedang eksplor AI coding agents, ECC adalah starting point yang sangat solid. Gratis, open-source, dan sudah battle-tested di production. Install sekali, dan biarkan agent-mu bekerja dengan cara yang lebih terstruktur.

Links:

• GitHub: github.com/affaan-m/ECC
• Homepage: ecc.tools
• Discord: discord.gg/36yGMHGFbR
• npm: ecc-universal, ecc-agentshield
• GitHub App: github.com/apps/ecc-tools

Tags: ai-agents, anthropic, claude, claude-code, developer-tools, llm, mcp, productivity

License: MIT