ECC : L’Optimisation des Systèmes d’Agents
Les agents autonomes génèrent du code. Cependant, sans structure d’encadrement, ils manquent de méthode, oublient les règles de base et gaspillent la fenêtre de contexte. ECC (Enterprise Context Control) transforme cette dynamique brute en une mécanique d’ingénierie prévisible.
Le système injecte un outillage complet au sein de votre environnement : planification préalable, validation par tests, relecture via un contexte isolé, persistance mémorielle et transformation des succès répétés en compétences réutilisables.
Cycle opératoire fondamental :
plan -> test -> implement -> review -> verify -> remember -> improve
Cette approche évite la reconstruction fastidieuse des invites de commande à chaque session. Vous installez ECC une seule fois ; vos assistants intègrent cette rigueur dans leur fonctionnement natif.
Architecture et Inventaire des Ressources
ECC fonctionne sous licence open source MIT. Le projet propose un écosystème modulaire composé de briques spécialisées :
| Composant | Volume | Rôle et Bénéfices |
|---|---|---|
| Agents | 68 agents | Planification, relecture, réparation de build, sécurité, architecture et tâches de domaine. |
| Compétences (Skills) | 286 skills | TDD, recherche approfondie, sécurité, documentation, frontend, data, ML, opérations. |
| Commandes | 94 commandes | Points d’entrée rapides assurant la transition vers l’interface axée sur les compétences. |
| Hooks & Mémoire | Runtime | Application des règles, résumés de session, apprentissage continu, instincts et gestion du contexte. |
| Règles | Sélectif | Standards chargés selon le langage ou le projet ciblé. |
| AgentShield | Inclus | Audit des invites, hooks, configurations MCP, permissions, secrets et fichiers d’agents. |
L’arborescence du dépôt centralise ces ressources :
ECC/
|-- agents/ # 68 sous-agents pour la délégation
|-- skills/ # 284 flux réutilisables chargés à la demande
|-- commands/ # 94 relais de commandes slash
|-- rules/ # Standards généraux et langages au choix
|-- hooks/ # Automatisation runtime et contrôle
|-- scripts/ # Installation, réparation, synchronisation, vérifications
|-- .claude-plugin/ # Manifeste marketplace Claude Code
|-- .codex/ # Configuration de référence et rôles Codex
|-- .opencode/ # Plugin, commandes et instructions OpenCode
|-- .cursor/ # Règles Cursor et adaptateur de hooks
|-- docs/ # Guides d'architecture et d'exploitationCanaux Officiels et Précautions de Sécurité
Installez ECC depuis les canaux vérifiés du projet pour éviter les dépôts tiers non maintenus pouvant contenir du code malveillant :
- Dépôt GitHub officiel : github.com/affaan-m/ECC
- Paquets npm certifiés :
ecc-universaletecc-agentshield - Application GitHub : ECC Tools
- Slug de plugin :
ecc@ecc - Site web du projet : ecc.tools
Guide d’Installation par Environnement (Harness)
Choisissez un seul mode d’installation par environnement. Le cumul des méthodes sur un même outil provoque des doublons au niveau des hooks et des commandes.
1. Claude Code
Exécutez ces instructions dans l’invite de Claude Code :
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@eccCette commande active les compétences, les agents, les commandes et les hooks gérés par le plugin. Arrêtez-vous là. N’exécutez pas d’installation manuelle en parallèle.
Les plugins Claude Code ne distribuant pas les règles statiques, importez manuellement celles requises par votre projet :
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/ # Adaptez selon votre pile techniqueAprès l’installation, la commande interne /ecc:configure-ecc permet de reconfigurer les options en toute sécurité.
2. Codex App et CLI
Codex prend en charge ECC via sa place de marché de dépôts native. Cette méthode charge le manifeste, les scripts, la configuration MCP et les hooks :
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
node scripts/codex/check-plugin-cache.jsPour mettre à jour votre version :
codex plugin marketplace upgrade ecc
codex plugin add ecc@eccPour l’ancienne méthode de synchronisation vers ~/.codex (déconseillée pour les nouvelles installations) :
git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
bash scripts/sync-ecc-to-codex.shPour inspecter ou désinstaller cette couche sans altérer les conversations Codex :
node scripts/ecc.js uninstall --legacy-codex-sync --dry-run
node scripts/ecc.js uninstall --legacy-codex-sync3. Cursor IDE
L’installation sur Cursor déploie les règles, agents, compétences et un adaptateur de hooks dédié :
# macOS / Linux
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php
# Windows PowerShell
.\install.ps1 --target cursor typescript
.\install.ps1 --target cursor python golang swift phpL’adaptateur .cursor/hooks/adapter.js convertit le format JSON de Cursor vers la structure attendue par les scripts partagés d’ECC :
Cursor stdin JSON -> adapter.js -> scripts/hooks/*.jsPour éviter les conflits de mémoire entre Claude Code et Cursor, le hook de session injecte un chemin isolé. Vous pouvez définir ce répertoire à la main :
export ECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"4. Kimi Code & Infrastructure Itô
L’adaptateur Kimi Code fonctionne avec la version 0.31.x (@moonshot-ai/kimi-code). ECC configure l’espace projet local sans toucher au fichier global ~/.kimi-code/config.toml :
bash ./install.sh --target kimi --profile minimal
node scripts/ecc.js doctor --target kimi
kimiSi vous hébergez un modèle Kimi sur vos propres cartes graphiques, le pont CLI Itô permet la gestion des demandes de cotation (RFQ) :
# Construction locale du client Itô
cd cli/ito-compute-cli
npm ci
npm run check
export ECC_ITO_CLI_EXECUTABLE="/chemin/absolu/vers/dist/bin/ito.js"
# Authentification et recherche de puissance GPU
ecc ito login --no-browser
ecc ito auth
ecc ito find5. Aperçu de l’Assistant d’Installation Universel (Version 2.2.0)
La version 2.2.0 introduira une commande interactive pour orchestrer l’ensemble des environnements :
npx ecc-universal install --guided \
--harness claude --harness codex --harness kimi \
--claude-scope local --claude-hooks standard \
--profile core --yesNouveautés et Écosystème ECC 2.1
Plan Canvas
L’outil ecc-plan-canvas ouvre le plan de l’agent dans une interface web locale. Vous inspectez les diagrammes Mermaid, placez des annotations numérotées sur le texte, dialoguez avec le modèle depuis un panneau latéral et validez ou rejetez les propositions sans ressaisie terminale.
Unified Memory Vault
Le coffre de mémoire unifié standardise le stockage du contexte sous forme de fichiers Markdown locaux, lisibles et partageables entre Claude, Codex, Kimi, Hermes et OpenClaw.
npm install -g ecc-universal
ecc memory init --scope project
ecc memory search "migration auth" --target-harness codex
ecc memory doctorLa mémoire constitue un contexte indicatif sans valeur de règle stricte. Vérifiez les faits cruciaux auprès des sources faisant autorité.
AgentShield : Audit de Sécurité
Développé lors du Hackathon Claude Code (Cerebral Valley x Anthropic), AgentShield inspecte vos fichiers CLAUDE.md, settings.json, configurations MCP, hooks et définitions d’agents à l’aide de 102 règles d’analyse statique.
# Analyse rapide
npx ecc-agentshield scan
# Correction des problèmes mineurs
npx ecc-agentshield scan --fix
# Analyse contradictoire approfondie (pipeline de 3 agents Opus 4.6)
npx ecc-agentshield scan --opus --stream
# Initialisation d'une configuration sécurisée
npx ecc-agentshield initContinuous Learning v2 et Skill Creator
Le système extrait les habitudes de développement depuis l’historique Git pour générer des règles et des instincts :
# Création de compétences depuis l'historique Git
/skill-create --instincts
# Consultation des instincts acquis
/instinct-status
# Synthèse des instincts en compétences
/evolveFlux de Travail et Cas Pratiques
Tableau des Commandes Quotidiennes
| Action | Commande |
|---|---|
| Conception d’une fonctionnalité | /ecc:plan "description" puis tdd-workflow |
| Correction d’un bug | Écrire un test rouge, puis lancer tdd-workflow |
| Relecture de code isolé | /code-review |
| Réparation de compilation | /build-fix |
| Nettoyage de code | /refactor-clean |
| Gestion de la fenêtre de contexte | /context-budget |
| Clôture de session | /save-session ou /learn-eval |
| Reprise du travail | /resume-session |
| Audit de sécurité | /security-scan |
Déroulement d’un Cycle TDD Complet
Je structure chaque tâche selon ce protocole rigoureux :
- Définition du besoin :
/ecc:plan "Ajout alertes facturation". - Validation du plan via l’interface terminal ou Plan Canvas.
- Activation du module
tdd-workflow. - Écriture d’un test qui échoue (preuve ROUGE enregistrée).
- Implémentation du code jusqu’au passage des tests (VERT).
- Relecture critique par un sous-agent dédié dans un contexte neuf.
- Vérification globale du build, du typage, du linter et de la suite de tests.
Optimisation de la Fenêtre de Contexte
L’accumulation de serveurs MCP sature rapidement la mémoire de travail de votre modèle. Chaque outil exposé consomme des jetons, réduisant parfois un espace de 200k à 70k disponibles.
- Conservez moins de 10 serveurs MCP actifs et moins de 80 outils déclarés simultanément.
- Désactivez les serveurs inutiles avec la commande
/mcp(les modifications sont enregistrées dans~/.claude.json). - Ajustez la taille du contexte de démarrage au besoin :
export ECC_SESSION_START_MAX_CHARS=4000 # Ou désactivation totale pour petits modèles : export ECC_SESSION_START_CONTEXT=off
Matrice de Support et Limites Connues
| Plateforme / Outil | Statut | Limites et Particularités |
|---|---|---|
| Claude Code | Stable (Cible principale) | Charge l’inventaire complet dans le modèle ; préférez un profil minimal si le contexte sature. |
| Codex | Supporté (sync) / Bêta (market) | Pas de runtime pour les hooks ECC. Utilisez le script de synchronisation pour plus de fiabilité. |
| Cursor | Bêta | La détection des agents dépend de la version de Cursor. Les hooks transitent par l’adaptateur Node.js. |
| OpenCode | Bêta | Modèles Anthropic fixés par défaut dans la configuration de référence (#2617). |
| GitHub Copilot | Instructions seules | Pas de hooks, pas d’agents runtime, pas de délégation dynamique. Fichiers Markdown statiques. |
| Windows Natif | Support partiel | Problèmes identifiés sur le démon d’observation (#2489) et l’écriture dans le vault (#2626). Utilisez WSL. |
| macOS | Supporté | Le script shell GAN autonome échoue avec Bash 3.2 système et souffre d’un défaut de parsing (#2674). |
| Linux | Supporté | Certaines fonctions optionnelles requièrent Python ou des binaires spécifiques. |
Dépannage et Résolution d’Incidents
Exécution en double des hooks ou composants dupliqués
Ce problème survient après l’installation du plugin natif combinée au script ./install.sh --profile full.
- Désinstallez le plugin dans Claude Code.
- Nettoyez le système depuis votre clone ECC :
node scripts/ecc.js uninstall --dry-run node scripts/ecc.js uninstall - Supprimez les règles superflues dans
~/.claude/rules/ecc/. - Reprenez l’installation en appliquant une unique méthode.
Erreur « Duplicate hooks file »
Ne déclarez aucun champ "hooks" au sein du fichier .claude-plugin/plugin.json. Claude Code lit directement le fichier hooks/hooks.json. Une déclaration explicite crée un conflit de chargement.
Exécution des tests internes du projet
Pour contrôler l’intégrité de votre installation locale d’ECC :
# Exécution de l'ensemble des tests
node tests/run-all.js
# Tests unitaires ciblés
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js