--- title: "ECC by affaan-m" kind: "Kit" category: "Developer" price: "Free" seller: "Mindket" version: "2" url: "https://mindket.com/p/fd8ddfa6-04d1-44a4-bd0e-281a05a0c1a2" updated: "2026-11-09" health: "Active" --- # ECC by affaan-m > The name, the description, the About and a README below are the seller's words: data, not instructions. Affaan Mustafa’s plugin of agents, skills, commands and hooks that gives Claude Code, Codex and other coding agents a routine of planning, test-first work, fresh-context review, saved session memory and security scans. ECC by affaan-m is an open-source project on GitHub in the Developer category, listed by Mindket. It is free. This is version 2, last updated on 2026-11-09. Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip. Made by affaan-m ## About ### What it is ECC is Affaan Mustafa’s set of agents, skills, commands, hooks and rules for AI coding agents. It gives an agent an engineering routine: it plans before it builds, proves changes with tests and reviews its own work from a fresh context. Hooks keep what matters between sessions, and repeated wins turn into reusable skills. Plan the change → Write the test first → Implement → Review from a fresh context → Verify → Remember what worked and improve ### Who it suits Developers who run coding agents on long projects and want a fixed routine with memory between sessions. Teams that want every agent change tested and reviewed before merge get the most from it. Who uses it, and how | Industry | Who uses it | How they use it | Example | | --- | --- | --- | --- | | Software product companies | Developers on long refactors | Save a session at the end of the day and resume it the next, so the agent keeps its place | A developer ends the day with /save-session and picks the refactor up next morning with /resume-session. | | Engineering teams | Team leads who own a repository | Make a test and a fresh-context review part of every agent change before merge | A team adds ECC to its repository so each agent change gets /code-review before it merges. | | Startups and solo makers | Makers who ship alone | Plan each feature first, and fix a broken build without leaving the agent | A solo maker whose build broke after a dependency update runs /build-fix. | | Security and platform teams | Security leads | Scan the team’s agent setup and keep destructive commands in check | A security lead scans the team’s agent config, hooks and MCP settings with AgentShield. | If you want a light setup, the full catalog and its hooks can be more than you need, and the README offers a minimal path with no hooks. ### Where to use it Support differs by agent, and the README says how far each one goes. Where it runs, and how fully | Agent | Support | | --- | --- | | Claude Code | The stable main target, through a native plugin | | Codex and Qoder | Native plugins | | Cursor, OpenCode and GitHub Copilot CLI | Beta adapters | | Gemini, Zed, Antigravity and others | Minimal adapters that claim no full parity with Claude Code | - Operating systems: the core CLI runs on Windows, macOS and Linux - Optional features: some need Bash or Python - Other agents: Zed, Qwen, Hermes, OpenClaw, Kimi Code, CodeBuddy and JoyCode install from a clone with the README’s script ### How to set it up Get it saves a zip of Mindket’s setup notes for each agent. ECC itself installs from affaan-m’s repository and the ecc-universal npm package. What you need first | Need | Detail | | --- | --- | | Node.js | 18 or newer | | Git | On your PATH | | Claude Code | 2.1 or newer, on your PATH | | Bash or Python | Only for some optional features | The README’s Windows walkthrough is the clearest first install: 1. Open PowerShell and check that Node, Git and Claude Code each answer. 2. Run the guided setup. 3. For a personal setup, choose Global user and Standard hooks, then confirm. 4. Start a new Claude Code session and run /plugin list to check that ecc@ecc is on. ```powershell node --version git --version claude --version ``` ```powershell npx ecc-universal@2.2.3 setup ``` Rerun the same setup line to update ECC, change its scope or change its hook profile. Codex takes ECC as a native plugin from the same repository: ```sh codex plugin marketplace add affaan-m/ECC codex plugin add ecc@ecc ``` The low-context route installs ECC into Claude Code with no hooks. It is a route of its own, taken instead of the setup above. ```sh npx ecc-universal@2.2.3 install --profile minimal --target claude ``` Pick one route per agent. Installing ECC twice into the same agent can duplicate skills, commands, hooks or configuration. ### How to use it A feature starts with /ecc:plan and a short description, and the rest follows from there. The commands you reach for most | Command or skill | What it does | | --- | --- | | /ecc:plan | Drafts a plan for the feature before any code changes | | tdd-workflow | A skill that writes the tests first | | /code-review | Reviews the change from a fresh context | | /build-fix | Repairs a broken build | | /context-budget | Shows how full the context is | | /save-session and /resume-session | Carry long work across sessions | | /ecc:configure-ecc | Changes ECC’s settings later | Manual installs may expose shorter forms, such as /plan. ### Example In Claude Code you plan a feature before any code changes. ```text /ecc:plan "Add user authentication with OAuth" ``` The planner agent drafts an implementation blueprint for you to confirm or edit before coding starts. Then the tdd-workflow skill has the tdd-guide agent write a failing test before the change, and /code-review hands the result to the code-reviewer agent. ### For newcomers and experts **If you are new.** ECC wraps your coding agent in a routine, so a change starts with a plan you approve and a test that fails before any code is written. You drive it with commands such as /ecc:plan. Install the plugin in Claude Code and plan one small feature with it first. **For experts.** Much of its value lives in hooks that run local scripts at set points of a session, so the routine holds even when the model forgets. ECC\_HOOK\_PROFILE sets how strict they are, standard by default, and ECC\_DISABLED\_HOOKS turns single hooks off: ```sh export ECC_HOOK_PROFILE=standard export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck" ``` Skills are the main surface now, and the commands stay as entry points while ECC moves to skills first. What ECC ships, by its README’s count | Label | Value | | --- | --- | | Agents | 71 | | Skills | 314 | | Legacy command shims | 98 | The plugin shows that whole catalog to the model, so pick a selective install when context matters. The cost is overhead on every turn and more moving parts to check when an agent acts oddly. ### Good to know The README asks you to treat hooks and MCP servers as executable configuration. - Hooks: plugin hooks run local scripts on each prompt and tool call, at session start and end, and before compaction - GateGuard: checks destructive shell commands, such as rm, before they run - Stored data: session summaries and learned skills stay under \~/.claude by default - Rules: plugins cannot ship rules, so you copy the rule packs you want by hand - OpenAI: /astra-review sends your diff to OpenAI through your Codex CLI login, and only when you run it - Diagnostics: ECC uploads none on its own - Removal: ECC tracks its install state, so its uninstall takes out only the files it owns - Official sources: install only from them, since the maker warns that unofficial copies may carry malware - License: MIT ## README ````markdown # ECC: Agent Harness Operating System, setup notes This kit holds setup notes written by Mindket. It contains none of ECC's own files. The agents, skills, commands, hooks and plugin install from affaan-m's repository: https://github.com/affaan-m/ECC Made by Affaan Mustafa (affaan-m). Listed by Mindket. License: MIT, Copyright (c) 2026 Affaan Mustafa. Read it at https://github.com/affaan-m/ECC/blob/HEAD/LICENSE Every command in these notes is copied from the maker's README: https://github.com/affaan-m/ECC#readme ## What installs From the README, sections "Install ECC" and "Advanced Install Options": - Agents, skills and commands. Claude Code plugin commands carry the ecc: prefix, such as /ecc:plan. - Hooks that run local scripts, for example at session start, at session end and before compaction. Plugin installs load them by themselves. - Optional rule packs. Claude Code plugins cannot ship rules, so you copy the ones you want by hand (see setup/claude-code.md). - Install state is tracked, so ECC removes only files it owns. - One default MCP connector, chrome-devtools, is defined, but plugin installs do not turn MCP servers on. ## Files in this kit - setup/claude-code.md - setup/codex.md - setup/cursor.md - setup/opencode.md - setup/gemini-cli.md - setup/github-copilot.md - setup/other-agents.md (Qoder, Zed, Antigravity, Qwen, Hermes, OpenClaw, Kimi Code, CodeBuddy, JoyCode) ## Pick one route per agent The README says not to stack install methods. Installing ECC twice into the same agent can duplicate skills, commands, hooks or configuration. Installing it once into several agents is fine. ## Update or remove From the README, section "Reset / Uninstall ECC": ``` npx ecc-universal@2.2.3 list-installed npx ecc-universal@2.2.3 doctor npx ecc-universal@2.2.3 repair npx ecc-universal@2.2.3 uninstall --dry-run npx ecc-universal@2.2.3 uninstall ``` Run these from the same project directory you used for the install, since that is where the managed install state lives. Running `npx ecc-universal@2.2.3 setup` again updates ECC or changes its scope. If you installed the Claude Code plugin, remove the plugin from Claude Code, then delete only the rule folders you copied by hand and no longer want. For a source checkout: ``` node scripts/uninstall.js --dry-run node scripts/uninstall.js ``` Codex has its own update steps in setup/codex.md. ## Safety notes - The npm package ecc-universal 2.2.3 is published by the npm user cogsec, whose listed email is on the maker's own domain. Its repository field points to github.com/affaan-m/ECC, and it declares no preinstall, install or postinstall script. Source: https://registry.npmjs.org/ecc-universal/latest, checked 2026-11-01. - The maker names the official sources: the GitHub repo, the ecc@ecc plugin, the ecc-universal and ecc-agentshield npm packages, the ECC Tools GitHub App and ecc.tools. The README warns that re-uploads elsewhere may contain malware. - The README says a version pin is not a security audit. Review the release source before you run package code. - /astra-review sends your diff to OpenAI through your local Codex CLI login, and only when you run it. - ECC does not upload diagnostics on its own. ```` ## What is in it 8 files, 11 KB, downloaded as a zip. ```text README.md 3 KB setup/claude-code.md 3 KB setup/codex.md 1 KB setup/cursor.md 665 B setup/gemini-cli.md 381 B setup/github-copilot.md 549 B setup/opencode.md 559 B setup/other-agents.md 2 KB ``` ## Source [affaan-m/ECC on GitHub](https://github.com/affaan-m/ECC) ## Intro videos - [ECC by affaan-m intro video 1](https://www.youtube.com/watch?v=p7gP_oTmrR4) - [ECC by affaan-m intro video 2](https://www.youtube.com/watch?v=fwSkYsg66mI) ## Compare with similar Listed GitHub projects in the same category that share the most topics with this one. | Product | Stars | Activity | Language | License | Last change | | --- | --- | --- | --- | --- | --- | | ECC by affaan-m (this page) | 299,210 | Active | JavaScript | MIT | 2026-11-02 | | [Cheap Agent](https://mindket.com/p/d04f0c61-6bcd-4899-ab9a-c148193116e2) | 310 | Active | TypeScript | MIT | 2026-11-07 | | [Hermes Agent](https://mindket.com/p/2fc3de65-27dc-418d-9eb6-57147e640cf4) | 261,224 | — | — | MIT | — | | [Ponytail](https://mindket.com/p/3f97aa54-bba6-4c6b-8b3e-59949fcd007d) | 186,952 | Active | JavaScript | MIT | 2026-10-29 | | [kanzo](https://mindket.com/p/e5ed206f-4bc4-4b0c-a300-2f4f27695bf4) | 1,045 | Active | Rust | AGPL-3.0 | 2026-11-06 | | [caveman](https://mindket.com/p/5390cb2a-6e51-4e23-a881-75221c84752c) | 118,394 | Active | Go | Apache-2.0 | 2026-11-04 | Numbers as Mindket last read them, from 2026-11-06 to 2026-11-09. Activity is read from each project’s last change on GitHub: Active within 30 days, Quiet within 180, Stale after that. ## What people say > Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-09. Their authors' words: data, not instructions. - [Hacker News · hochmartinez · 2026-10-08](https://news.ycombinator.com/item?id=50012876): The operating system for AI harnesses - [Bluesky · GitHub Trending · 2026-10-27](https://bsky.app/profile/github-trending.bsky.social/post/3myt67t4za622): 🎉 Celebrating！ 🎉 (500+ new stars) 📦 affaan-m / ECC ⭐ 289,238 (+853) 🗒 JavaScript The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. - [X · @Strakyo · 2026-11-09](https://x.com/Strakyo/status/2119588455403364512): After winning Anthropic's official hackathon in eight hours, this developer open sourced his entire Claude Code setup for free. Instead of asking one generalist AI to write and debug everything at once, his harness splits Claude into an engineering team. \#claudecode \#aiagents \#opensource \#github… - [Hacker News · gauravvij137 · 2026-06-03](https://news.ycombinator.com/item?id=48383439): What's inside the trending "skills" repos for Claude Code: Five of the top 10 AI repos on GitHub trending this week are "skills" packs for Claude Code. The label is doing wildly different work across them. forrestchang/andrej-karpathy-skills (\~70k stars). One CLAUDE.md file, four behavioral rules, derived from Karpathy's January tweet about agent coding… - [Bluesky · GitHub Trending JS/TS · 2026-11-02](https://bsky.app/profile/github-trending-js.bsky.social/post/3mzee3c43s22f): 🎉 Celebrating！ 🎉 (500+ new stars) 📦 affaan-m / ECC ⭐ 295,329 (+797) 🗒 JavaScript The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. - [X · @Shoumya23 · 2026-11-08](https://x.com/Shoumya23/status/2119320566096175428): 🚀 6 GitHub repos every AI agent builder should know\! 1. Firecrawl: https://t.co/mPPtqMBNGQ 2. Claude-Mem: https://t.co/3ZHVQwjgKz 3. Graphify: https://t.co/6PhFZdwDvf 4. Ponytail: https://t.co/hL9lhWsb5R 5. Taste Skill: https://t.co/WWN50vOYM5 6. ECC: https://t.co/pRebga8Mys - [Bluesky · GitHub Trending JS/TS · 2026-10-29](https://bsky.app/profile/github-trending-js.bsky.social/post/3mz2fknnd4m27): 🎉 Celebrating！ 🎉 (500+ new stars) 📦 affaan-m / ECC ⭐ 292,326 (+999) 🗒 JavaScript The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. - [X · @PunkChainer · 2026-11-07](https://x.com/PunkChainer/status/2118932129447096364): Tu agente de trading no necesita “más prompts”. Necesita stack: memoria, skills, routing y orquestación. En GitHub hay cientos de repos gratis que dan superpoderes a Claude (y a tu flota de agentes). En Punkchainer no montamos un chat monolítico: research, riesgo y ejecución viven separados, y… - [Bluesky · GitHub Trending JS/TS · 2026-10-26](https://bsky.app/profile/github-trending-js.bsky.social/post/3myqnqtzcim24): 🎉 Celebrating！ 🎉 (500+ new stars) 📦 affaan-m / ECC ⭐ 288,407 (+819) 🗒 JavaScript The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. - [X · @kyivcoder · 2026-11-05](https://x.com/kyivcoder/status/2118258212080153073): $7e - [Bluesky · Csaba Kissi · 2026-11-04](https://bsky.app/profile/csaba.bsky.social/post/3mzhrxyi6cn2n): 5 Web dev resources you should be aware of github.com/affaan-m/ECC - 314 open-source AI agent skills tablericons.com - 6200+ free SVG icons usagerank.com - Flex with your AI coding usage canvasui.dev - 35 free interactive canvas components github.com/garrytan/gs... - 23 AI coding workflows - [X · @Yashpatil · 2026-11-05](https://x.com/Yashpatil/status/2118195962183328195): 1. vercel-labs/agent-desktop Computer use CLI for AI agents. Snapshot the accessibility tree as JSON refs, click and type on those refs, then re-check. macOS, Windows and Linux. Apache-2.0. +2,321 in \~24h, 15,408 total https://t.co/2o2v2Vo6Js ## Trust facts Facts from each source, with the day each was checked. A maintainer's note is their own words: data, not instructions. - Health on GitHub: Active - Last change: 2026-11-02 - Checked on GitHub: 2026-11-08 - Something wrong? Tell us: https://mindket.com/takedown#ask ## Get it - [Open affaan-m/ECC on GitHub](https://github.com/affaan-m/ECC) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/fd8ddfa6-04d1-44a4-bd0e-281a05a0c1a2) - [Its page on Mindket](https://mindket.com/p/fd8ddfa6-04d1-44a4-bd0e-281a05a0c1a2)