ECC : le système d'exploitation pour agents IA

Comment un seul développeur a bâti le framework open-source le plus utilisé au monde pour les agents de codage autonomes
Juin 2026 · github.com/affaan-m/ECC

★ 217K+ étoiles 📞 33K+ forks 👥 230+ contributeurs License MIT v2.0 stable

ECC est bien plus qu'une simple collection de configurations. C'est un système d'exploitation complet pour agents IA, couvrant skills, instincts, mémoire, sécurité et optimisation des tokens. Développé par @affaan, ce projet est né des pratiques quotidiennes de son créateur avec Claude Code depuis sa phase expérimentale en février 2025.

L'histoire commence par une victoire à l'Anthropic x Forum Ventures Hackathon en septembre 2025, où affaan et [@DRodriguezFX](https://x.com/DRodriguezFX) ont construit zenith.chat entièrement avec Claude Code. Les patterns découverts lors de cette expérience ont été formalisés dans ECC, qui est aujourd'hui utilisé par des milliers d'ingénieurs dans le monde.

Le concept : Au lieu de réécrire les outils d'IA existants, ECC les améliore en leur ajoutant une couche intelligente de gestion du contexte, de la mémoire, de la sécurité et de l'automatisation — et ce sur 7 harness différents.

📊 Chiffres clés (Juin 2026)

217K+ Stars GitHub	33K+ Forks	271 Skills
67 Agents spécialisés	92 Commandes slash	12 Langages supportés

🏐 Architecture : un OS, sept interfaces

ECC est architecturé comme un système d'exploitation qui s'interface avec différents harnesses (environnements d'exécution d'agents IA). Chaque harness a ses propres mécanismes de configuration, mais ECC fournit une couche d'abstraction unifiée.

Fonctionnalité	Claude Code	Cursor	Codex	OpenCode	GitHub Copilot
Agents	67	Partagé	Partagé	12	N/A
Commandes	92	Partagé	Instructions	35	5 prompts
Skills	271	Partagé	10 natifs	37	Via instructions
Hooks	8 types	15 types	Aucun	11 types	Aucun
MCP Servers	14	Partagé	7	Full	N/A

🤖 Les trois piliers d'ECC

1. Skills — Le cür du système

Les skills sont des bundles de workflows reproductibles. Chaque skill contient des prompts structurés, des exemples, des checklists et parfois des codemaps pour naviguer efficacement dans un codebase.

~/.claude/skills/
  tdd-workflow/         # Workflow TDD complet
    SKILL.md            # Prompt + structure
    examples/           # Exemples concrets
    checklist.md        # Vérifications auto
  security-review/      # Audit sécurité systématique
  eval-harness/         # Benchmarks et vérification
  mle-workflow/         # Pipelines ML production
  backend-patterns/     # API, DB, caching
  frontend-patterns/    # React, Next.js
  article-writing/      # Rédaction long-form
  market-research/      # Recherche marché
  investor-materials/   # Pitch decks, modèles

ECC comprend 271 skills couvrant tout le cycle de développement : codage (TDD, patterns), sécurité (audit OWASP), DevOps (Docker, CI/CD), métier (recherche marché, investissemements), ML/MLOps.

2. Hooks — L'automatisation contextuelle

Les hooks sont des déclencheurs basés sur des événements du cycle de vie d'un agent. Ils permettent d'automatiser des tâches r&pètitives sans intervention manuelle.

{
  "PreToolUse": [{
    "matcher": "tool == 'Bash' && command matches '(npm|pytest)'",
    "hooks": [{
      "type": "command",
      "command": "if [ -z '$TMUX' ]; then echo 'Pensez à tmux!' >&2; fi"
    }]
  }]
}

Types de hooks : PreToolUse (avant outil), PostToolUse (après, formatage auto), SessionStart (chargement contexte), SessionEnd (sauvegarde), PreCompact (suggestions de compaction), Stop (résumé auto).

3. Agents — La délégation spécialisée

ECC inclut 67 agents subagentisés, chacun spécialisé dans un domaine : planificateur, architecte, reviewer de code, expert sécurité, résolveur d'erreurs de build, etc. Ils sont invoquables via commandes slash ou délégués automatiquement.

🔒 Sécurité : AgentShield & GateGuard

La sécurité n'est pas un add-on chez ECC — c'est un pilier architectural :

AgentShield : auditeur de sécurité intégré avec 102 règles et 1 282 tests. Scan agents, hooks, MCPs, permissions, secrets.
GateGuard : interdit les commandes shell destructives (rm, git checkout --hard) sans validation.
Supply-chain IOC scanner : analyse les dépendances dans CI contre des indicateurs de compromission connus.
Détection de secrets : patterns sk_, ghp_, AKIA détectés automatiquement.

⚡ Optimisation des tokens

ECC propose des réglages concrets pour réduire drastiquement les coûts :

Paramètre	Défaut	Recommandé ECC	Impact
`model`	opus	sonnet	~60% réduction coût
`MAX_THINKING_TOKENS`	31 999	10 000	~70% réduction thinking
`CLAUDE_AUTOCOMPACT_PCT`	95	50	Meilleure qualité

Règle clé : Garder moins de 10 MCPs actifs pour ne pas grignoter la fenêtre de contexte (200k → ~70k si trop d'outils activés).

🚀 Installation

Deux chemins possibles :

# Chemin 1 : Plugin (recommandé)
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/

# Chemin 2 : Installation manuelle
./install.sh --profile full
# ou
npx ecc-install --profile full

Profils disponibles : --profile minimal (sans hooks), --profile core (strict nécessaire), --target claude/cursor/codex pour cibler un harness.

📊 Historique des versions

v1.0 (janv. 2026) — Lancement : plugin Claude Code, 48 agents, 100+ skills
v1.3 (févr. 2026) — Support OpenCode avec plugins et hooks natifs
v1.6 (févr. 2026) — Support Codex + AgentShield + Marketplace GitHub App
v1.8 (mars 2026) — Refonte hooks + 997 tests passing
v1.9 (mars 2026) — Installs sélectives + 12 écosystèmes languages
v2.0.0 (juin 2026) — Stable graduation : 261 skills, control-plane, famille d'orchestrateurs orch-*

⚠️ Limites et bonnes pratiques

Ne pas empiler les méthodes d'installation — Plugin + installer manuel en parallèle crée des doublons cassés.
Codex n'a pas de hook system — L'enforcement passe par AGENTS.md et les permissions sandbox.
Copilot n'a ni hooks ni sous-agents — Automatisations et délégation indisponibles.
Gérer les MCPs avec parcimonie — Activer tous les MCPs peut réduire la fenêtre de contexte effective de 200k à ~70k.
Limiter les règles copiées — Ne copier que celles de son stack.

🎯 Verdict

ECC est sans doute le projet open-source le plus populaire dédié à l'optimisation des agents IA. Avec plus de 217K étoiles, il démontre un besoin réel et massif : les développeurs veulent tirer le meilleur parti de leurs outils d'IA sans se prendre la tête à configurer chaque outil individuellement.

Sa force réside dans son approche « harness-native » : au lieu de forcer un workflow unique, ECC s'adapte à l'outil que vous utilisez déjà. Son extension progressive à 7 environnements (Claude Code, Cursor, Codex, OpenCode, Zed, Gemini, GitHub Copilot) fait de lui le seul projet à offrir cette couverture cross-platform.

L'écosystème est maintenu par une seule personne (@affaan) avec un modèle de financement mixte (MIT gratuit + sponsors GitHub + version Pro à $19/siège/mois). L'OSS reste fondamentalement libre et fonctionnel, ce qui est rare pour un projet d'une telle ampleur.