engineering / skill

ECC

A collection of agents, skills, hooks and rules that adds a plan, test, review and memory workflow to Claude Code, Codex and other coding agents.

Repository owner affaan-m

Not rated yet
0 comments

Like 0 Save

Published 11 Oct 2026Listing updated 12 Oct 2026

At a glance

Purpose: A collection of agents, skills, hooks and rules that adds a plan, test, review and memory workflow to Claude Code, Codex and other coding agents.
Runs in: Local agent with shell, MCP server
Operating systems: macOS, Linux, Windows
Needs: Runtime: Node.js 18+; Git for Claude plugin setup; Needs internet: Not stated; Needs accounts or API keys beyond your agent: Not stated
Files and data: Reads files: Yes; Writes files: Yes; Sends data to other services: Yes
Tool type: Skill
Delivery: From GitHub
Version: Latest on the main branch
Access: Code on GitHub
Compatibility: Claude Code (the README says ECC works best there today), Codex, Kimi Code, Cursor, Antigravity, Gemini, OpenCode, CodeBuddy, JoyCode, Qwen, Zed, Hermes, OpenClaw and GitHub Copilot, according to the README. The README says guided package setup covers Claude Code, Codex and Kimi Code, and that other agents use install script targets with adapter limits.
External costs: The repository is MIT-licensed, and the README describes the open-source repository as free. It also describes ECC Pro, a paid hosted GitHub App for private repositories. Your coding agent or model provider may charge for usage.
Permissions: The skills act through your coding agent with the access you give it. According to the README, the installers write agents, skills, commands, rules and hook scripts into your agent's folders, for example under ~/.claude, and register hook entries in ~/.claude/settings.json. The README says hooks handle enforcement, session summaries, continuous learning and context controls, and that the installer prints what hooks can do and stops until you choose to enable or disable them. AgentShield scans prompts, hooks, MCP configuration, permissions, secrets and agent files, according to the README. The Codex plugin carries MCP configuration and a hook runtime, and Codex asks you to trust its hooks.
Usage terms: MIT License, as stated in the repository. See its LICENSE file for the exact terms.

Code on GitHub

affaan-m/ECC

MIT

JavaScript277,934 stars41,437 forksLast pushed 12 Oct 2026 UTC

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

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

Public GitHub data fetched 13 Oct 2026 UTC · 0 days old

View on GitHub ↗

What it does

ECC is a collection of agents, skills, commands, hooks and rules for coding agents. According to the README, it gives an agent a coordinated engineering system. The README says the agent plans before it builds, verifies changes with tests, reviews its own work from a fresh context, remembers what matters, and turns repeated wins into reusable skills and workflows.

The README also lists hooks for enforcement, session summaries, continuous learning and context controls, rules you choose by language or project, and AgentShield, which it describes as scanning prompts, hooks, MCP configuration, permissions, secrets and agent files. The README says the skills cover areas such as TDD, research, security, docs, frontend, data, ML and operations.

The README says ECC works best with Claude Code today, has a native Codex plugin route (it calls its older Codex sync script a deprecated compatibility option), and has capability-limited adapters for Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, Qwen and other harnesses. It points to a support status matrix and warns against assuming feature parity.

Who it is for

People who use Claude Code, Codex or another supported coding agent and want a prebuilt set of agents, skills, hooks and rules.

Example tasks

Run the guided setup to install ECC for Claude Code.
Ask the packaged advisor which components match your work, such as security reviews.
Install only chosen skills, such as tdd-workflow and security-review.
Add rule packs for your language or project to Claude Code.
Install ECC without the hook runtime for a low-context setup.

Getting started

The README recommends a guided setup for the Claude Code plugin: npx ecc-universal@2.2.3 setup. For Claude Code, Codex and Kimi Code together it gives npx ecc-universal@2.2.3 install --guided. Inside Claude Code it also gives /plugin install ecc@ecc after adding its marketplace. For Codex it gives codex plugin marketplace add affaan-m/ECC and codex plugin add ecc@ecc. Other agents use ./install.sh with a profile and a target, such as ./install.sh --profile minimal --target cursor. The README tells you to install only from its official channels and to choose one install method per harness. The README has the exact commands.

Limitations

It needs a coding agent. The README says ECC works best with Claude Code today, has a native Codex plugin route, and provides capability-limited adapters for other harnesses, so features differ by harness. The universal package needs Node.js 18 or newer. Claude plugin setup also needs Git and Claude Code 2.1 or newer on PATH. The README says to pick one install path per harness and not to stack install methods, because that can duplicate skills, commands, hooks or configuration. It says Claude Code plugins cannot distribute rules, so you copy the rule packs you want by hand. It says any install that includes the hook runtime needs an explicit choice between enabling and disabling hooks. The repository can change at any time; check its README before you install.

Data practices

For install trouble, the README points to a problem form and the ecc feedback command, and says ECC never uploads diagnostics automatically. The opening sections of the README do not describe where session summaries, memory or learned instincts are stored, or what the optional hosted GitHub App does with data. What is sent where depends on your coding agent and model provider.

ECC