ECC : Le Agent Harness Operating System pour vos projets IA

affaan-m/ECC

Le projet à pour but d'agir comme un véritable système d'exploitation pour agent harness, entièrement personnalisable. Au lieu de laisser l'IA dériver session après session sans mémoire de vos conventions, ECC fournit des agents spécialisés, des skills de workflow, des hooks de cycle de vie et des règles précises. Tout ce qu'il faut pour que l'agent sache comment travailler dans votre stack avant même la première ligne de code. Un véritable "prêt à porter" pour votre agent harness.

Voyons comment ça fonctionne et pourquoi il faut l'adopter pour ses propres projets.

1. Le Concept : Un système d'exploitation pour agent

ECC fournit une architecture complète et cohérente : skills, agents, hooks, règles, manifests MCP. Issu de plus de 10 mois d'utilisation quotidienne intensive sur de vrais produits, il porte 271 skills, 67 agents spécialisés, 92 scripts de commandes, et supporte 12 écosystèmes de langages. Tout cela vient ce greffer directement à votre agent harness (claude code, codex...) pour avoir un très bon cadre, personnalisable, pour vos projets, rajouter des "fonctionnalités" non native à votre agent harness, et ainsi augmenter votre productivité en tant que développeur.

L'utilité majeure d'un tel Harness OS réside dans la profondeur de ce qu'il couvre :

• Une connaissance implicite rendue explicite : Chaque codebase accumule des décisions d'architecture, des conventions de nommage, des patterns de tests: ECC les rend lisibles par l'agent dès le début de la session, au lieu de repartir de zéro à chaque fois.
• Le respect des limites de la machine : Via le contrôle fin du contexte (ECC_SESSION_START_MAX_CHARS, ECC_CONTEXT_MONITOR_COST_WARNINGS) et le skill strategic-compact, la pression sur la fenêtre de contexte du modèle est réduite activement.
• Une base brute à s'approprier : ECC est conçu pour être cloné et adapté. Pour PHP avec Laravel, il y a laravel-patterns, laravel-tdd, laravel-security, laravel-verification. Même logique pour Python et Django, Typescript, Go, Rust, Swift.

• Plug & Play : Très rapide à mettre en place grace à tout ses skills de qualité et son architecture de communication propre à l'Operating System : Pas besoin de passer des jours à créer le flux parfait dans votre agent harness, ECC le fait pour vous contre un minimum de personnalisation.

2. Le Fonctionnement : Ce qu'ECC apporte réellement à l'agent harness

ECC repose sur quatre surfaces qui travaillent ensemble. Quand il est installé et qu'une session démarre, voici ce qui se passe concrètement :

Les Skills, le coeur du système

Les 271 skills sont la surface principale. Ce ne sont pas de simples snippets : ce sont des définitions de workflow complets que l'agent charge et applique selon la tâche. Par exemple, deployment-patterns couvre le CI/CD, Docker, le health checks, les rollbacks. api-design normalise les réponses REST, la pagination, la gestion d'erreurs. C'est là que vit la connaissance métier que vous ne voulez pas réexpliquer à chaque session.

Les Agents spécialisés

67 sous-agents peuvent être invoqués pour des tâches déléguées précises : planner, architect, tdd-guide, code-reviewer, security-reviewer, database-reviewer, refactor-cleaner, loop-operator… Un développeur senior n'utilise pas le même profil pour débugger une requête SQL complexe et pour refactoriser un composant UI. ECC reflète exactement cette réalité.

Les Hooks, l'automatisation du cycle de vie

C'est là qu'ECC fait la différence sur la durée. Les hooks SessionStart, PreToolUse, PostToolUse et Stop automatisent ce que vous feriez ou deviez configurer manuellement : charger le contexte de session précédent, détecter les secrets avant qu'ils fuient, déclencher le typecheck après chaque édition, extraire les patterns appris en fin de session. Le tout contrôlable finement avec ECC_HOOK_PROFILE=minimal|standard|strict et ECC_DISABLED_HOOKS pour ne pas subir ce qui n'est pas pertinent.

Le Continuous Learning

Le système apprend de vos sessions. Via /learn-eval, il extrait automatiquement les patterns émergents avec un score de confiance, les stocke comme instincts, et les fait évoluer vers de vrais skills réutilisables avec /evolve. Ce cycle de rétention transforme chaque session en investissement pour les suivantes.

3. La Personnalisation : Adapter le Harness OS à sa propre stack

La grande force de ECC, c'est qu'il ne demande qu'à être hacké. L'architecture d'installation sélective via manifests permet d'installer exactement ce dont on a besoin, sans pollution.

En adaptant les règles et skills chargés, on crée des profils de contexte à la volée :

• Profil Backend : rules/php, laravel-patterns, laravel-tdd, database-reviewer, deployment-patterns.
• Profil Front/UI : frontend-patterns, react-patterns, nextjs-turbopack, e2e-testing...
• Profil Audit/Sécurité : On utilise les skills security-reviewer, AgentShield...

Cette approche chirurgicale garantit que l'agent harness et le llm en route dispose toujours de la vérité textuelle maximale sur la zone concernée, sans subir la charge mentale du reste de l'application.

4. Le couplage intelligent avec d'autres outils

Pour les développeurs qui exploitent déjà des agents harness (IDEs agentiques, outils CLI comme Clode code, Codex, Antigravity...) le couplage devient redoutablement malin. Par exemple, ECC liste explicitement Antigravity comme cible compatible dans sa documentation, ce qui ouvre deux stratégies complémentaires : utiliser ECC comme socle de skills et règles tout en laissant Antigravity gérer sa propre couche de contrôle d'accès et de permissions, de mémoires etc, ou injecter les blocs ECC voulus directement dans la session Gemini via Antigravity pour granularisé exactement la configuration souhaité. Je prend l'exemple d'Antigravity ici car avec les un an d'abonnement pro offert aux étudiants, c'est une bonne porte d'entrée pour tester ECC.

5. Faire son propre workflow par l'exemple

ECC propose un cadre très vaste et complet pour être utiliser dans de nombreux projets, utilisant des langages et des frameworks différent. C'est un projet à explorer très interessant même si vous souhaitez une granularité ultra-fine via un workflow totalement personnalisé pour vous ou votre entreprise. En comprenant sa structure, son fonctionnement, et en regardant ses skills de qualité, vous pouvez totalement vous en inspirer pour créer ou améliorer vos propres outils IA professionnel.

En conclusion, un des meilleurs repo "tout en un" à greffer sur votre agent harness préféré pour le développement agentique actuel. Profitez aussi d'un outil comme Ponytail pour brider l'over-engineering de l'IA tout en profitant de la puissance de l'Harness d'ECC : un combo gagnant du workflow agentique moderne.

affaan-m/ECC