ECC : Le Agent Harness Operating System pour vos projets IA

affaan-m/ECC

Le concept de ce projet : agir comme un véritable système d'exploitation pour agent harness, entièrement personnalisable. AAu 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.

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

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

Contrairement aux configurations IDE basiques qui se contentent de quelques fichiers de règles épars, 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.

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

• Une connaissance implicite rendue explicite : Lchaque 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 : Evia 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.

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

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 cœur 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 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 à 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 IA 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

Et pour les développeurs qui exploitent déjà des IDEs ou des CLI disposant de leur propre couche harness (Antigravity en est l'exemple parfait) le couplage devient redoutablement malin. 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, ou injecter les blocs ECC voulus directement dans la session Gemini via Antigravity pour obtenir des réponses d'une précision chirurgicale, sans gaspiller la moindre miette de capacité de raisonnement du modèle.

En reprenant le contrôle manuel sur ce que l'agent peut voir et comprendre, on maximise la pertinence des réponses tout en protégeant de la surconsommation de tokens. Un des meilleurs repo pour le développement agentique actuel. Peut être associer à vos agents et skills personnels, ou à 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