Vous le connaissez. Cheveux longs attachés en queue de cheval. Lunettes ovales. Il est dans la boîte depuis plus longtemps que l’historique Git. Un junior lui présente cinquante lignes de code complexe pour gérer une sélection de dates ; le senior regarde l’écran en silence, efface tout, et tape une seule ligne HTML. Ça fonctionne immédiatement.
Le projet open-source ponytail injecte cet état d’esprit directement dans vos agents IA. Les modèles de langage actuels souffrent d’un biais d’action systématique : dès qu’un problème survient, ils créent des classes intermédiaires, installent des paquets npm superflus et réinventent la roue.
Ponytail inverse cette tendance en forçant l’agent à adopter le principe fondamental de l’ingénierie logicielle : le meilleur code est celui qu’on n’écrit jamais.
Résultats mesurés sur du code réel
Nous avons testé Ponytail en conditions réelles avec Claude Code sur le dépôt full-stack-fastapi-template de Tiangolo (FastAPI + React). L’évaluation porte sur 12 tickets de fonctionnalités distincts, avec 4 répétitions par tâche (modèle Haiku 4.5), en comparant le diff produit avec et sans le plugin.
| Configuration | Lignes de code (LOC) | Tokens | Coût | Latence | Sécurité |
|---|---|---|---|---|---|
| ponytail | -54% | -22% | -20% | -27% | 100% |
| caveman (contrôle prose terse) | -20% | +7% | +3% | +2% | 100% |
| Prompt “YAGNI + one-liner” brut | -33% | -14% | -21% | -30% | 95% |
La réduction atteint 94% sur les tâches propices au surdéveloppement. Pour un sélecteur de date, l’agent sans skill écrit 404 lignes en important une bibliothèque tierce, contre 23 lignes avec Ponytail en exploitant la balise standard. Sur du code déjà minimal, la réduction est proche de zéro.
La nuance capitale réside dans la sécurité. Un prompt simpliste de type “fais des one-liners” sacrifie la gestion d’erreurs dans 5% des cas adversariaux. Ponytail conserve l’intégralité des validations aux frontières de confiance, la gestion des pertes de données et l’accessibilité.
L’échelle de décision en sept échelons
Avant de produire la moindre ligne, l’agent parcourt le code existant, analyse le flux réel, puis s’arrête au premier échelon suffisant :
- Nécessité absolue : Cette fonctionnalité doit-elle exister ? Si non, abandonner (YAGNI).
- Réutilisation locale : Existe-t-il déjà une fonction similaire dans le dépôt ? Réutiliser, ne pas réécrire.
- Bibliothèque standard : Le langage fournit-il l’outil en natif ? L’utiliser.
- Plateforme hôte : Le navigateur, le système d’exploitation ou le moteur SQL le gère-t-il nativement ? L’utiliser.
- Dépendances existantes : Une bibliothèque déjà installée dans
package.jsonoupyproject.tomlle fait-elle ? L’utiliser sans ajouter de nouveau paquet. - Formulation concise : Est-ce faisable proprement en une ligne ? L’écrire en une ligne.
- Solution minimale : Si aucun échelon précédent ne suffit, coder le strict minimum fonctionnel.
Paresseux sur la solution, jamais sur la lecture du code existant.
Installation par environnement
Ponytail s’adapte à plus de vingt environnements d’agents IA. Pour Claude Code et Codex, Node.js doit être présent dans le PATH de votre shell non-interactif pour exécuter les hooks de cycle de vie.
# Claude Code (terminal ou application Desktop)
/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytail
# Codex CLI & Desktop
codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail
# GitHub Copilot CLI
copilot plugin marketplace add DietrichGebert/ponytail
copilot plugin install ponytail@ponytail
# Pi Agent Harness
pi install git:github.com/DietrichGebert/ponytail
# Gemini CLI / Antigravity CLI
gemini extensions install https://github.com/DietrichGebert/ponytail
agy plugin install https://github.com/DietrichGebert/ponytail
# Hermes Agent
hermes plugins install DietrichGebert/ponytail --enable
# Devin CLI
devin plugins install DietrichGebert/ponytail
# OpenClaw (via ClawHub)
clawhub install ponytail
# Grok Build
grok plugin install DietrichGebert/ponytail --trust
# Swival
swival skills add --global https://github.com/DietrichGebert/ponytail
swival skills add ponytailPour OpenCode, ajoutez la référence dans votre fichier opencode.json :
{
"plugin": ["@dietrichgebert/ponytail"]
}Pour les éditeurs fonctionnant par injection de règles sans moteur de plugins (Cursor, Windsurf, Cline, GitHub Copilot Chat, Aider, Kiro, Zed, CodeWhale, Qoder, Junie, Amp, Jules), copiez simplement le fichier AGENTS.md ou les règles spécifiques situées dans les dossiers .cursor/rules/, .windsurf/rules/, .clinerules/, .github/copilot-instructions.md ou .kiro/steering/ponytail.md à la racine de votre projet ou dans votre répertoire utilisateur.
Commandes et modes d’exécution
Sur les plateformes supportant les skills interactifs, six commandes structurent l’analyse :
/ponytail [lite | full | ultra | off]: Règle l’intensité ou affiche le mode actif./ponytail-review: Examine le git diff actuel pour traquer le surdéveloppement et renvoie une liste de suppressions./ponytail-audit: Analyse l’intégralité du dépôt à la recherche de code inutile ou de dépendances redondantes./ponytail-debt: Consigne les raccourcis et simplifications reportés dans un registre dédié pour éviter l’oubli./ponytail-gain: Affiche le tableau d’impact estimé en volume de code, coût et vitesse./ponytail-help: Résumé de l’aide interactive.
Le niveau par défaut se configure via la variable d’environnement PONYTAIL_DEFAULT_MODE ou dans ~/.config/ponytail/config.json :
{
"defaultMode": "full"
}Pour contrôler l’injection du prompt dans les sous-agents créés dynamiquement, définissez PONYTAIL_SUBAGENT_MATCHER avec une expression régulière non ancrée (par exemple explore|general ou ^general$).
Catalogue des alternatives natives directes
Voici les équivalences que Ponytail applique systématiquement pour remplacer des dépendances externes lourdes par des primitives système.
Contrôles HTML et interface :
| Besoin courant | Solution native |
|---|---|
| Sélecteur de date | <input type="date"> |
| Sélecteur de couleur | <input type="color"> |
| Boîte modale complexe | <dialog> avec dialog.showModal() |
| Menu accordéon / FAQ | <details><summary>Titre</summary>Contenu</details> |
| Menu déroulant avec recherche | <input list="id"><datalist id="id"> |
| Zone de texte extensible | CSS field-sizing: content |
JavaScript et APIs navigateur :
| Bibliothèque superflue | Alternative native |
|---|---|
lodash.clonedeep | structuredClone(obj) |
lodash.groupby | Object.groupBy(arr, fn) |
uuid (v4) | crypto.randomUUID() |
query-string / qs | new URLSearchParams(window.location.search) |
date-fns/format | new Intl.DateTimeFormat("fr-FR", { dateStyle: "long" }).format(date) |
| Bibliothèque de défilement infini | new IntersectionObserver(callback).observe(cible) |
Timeout sur fetch | fetch(url, { signal: AbortSignal.timeout(5000) }) |
Pour un anti-rebond (debounce), trois lignes suffisent sans importer de dépendance :
let timer;
const debounce = (fn, delay) => (...args) => {
clearTimeout(timer);
timer = setTimeout(() => fn(...args), delay);
};Écosystème Node.js :
- Au lieu de
mkdirpoumake-dir:fs.mkdirSync(path, { recursive: true }). - Au lieu de
rimraf:fs.rmSync(path, { recursive: true, force: true }). - Au lieu de
path-exists:fs.existsSync(path). - Au lieu de
array-uniq:[...new Set(arr)]. - Au lieu de
load-json-file:JSON.parse(fs.readFileSync(path, "utf8")).
Écosystème Python :
- Au lieu de
pytz: module standardzoneinfo.ZoneInfo("Europe/Paris")(Python 3.9+). - Au lieu de
attrspour des structures basiques :@dataclass. - Au lieu de
python-dateutilpour l’ISO :datetime.fromisoformat(). - Au lieu de
mergedeep: fusion nativedict_a | dict_b. - Au lieu de
six,pathlib2ouenum34: obsolètes, le standard Python 3 intègre tout.
Moteur de base de données contre code applicatif :
- Totaux cumulés : fonctions de fenêtrage SQL
SUM(...) OVER (ORDER BY date). - Arborescences : requêtes récursives
WITH RECURSIVE. - Recherche textuelle simple : index
tsvector(Postgres) ouFTS5(SQLite). - Garantie d’unicité et contraintes de valeurs : contraintes SQL
UNIQUEetCHECK (prix > 0)au lieu de validations manuelles dans l’application.
Désinstallation propre et maintenance
Pour supprimer l’extension de votre machine, exécutez le script de nettoyage avant de désinstaller le paquet de l’agent. Ce script efface l’entrée statusLine dans ~/.claude/settings.json si elle pointe vers Ponytail, ainsi que le dossier de configuration utilisateur.
# Nettoyage des résidus locaux
node scripts/uninstall.js
# Suppression selon l'agent
/plugin remove ponytail # Claude Code
codex plugin remove ponytail # Codex
devin plugins remove ponytail # Devin
grok plugin uninstall ponytail # Grok
pi uninstall ponytail # PiPour les contributeurs modifiant les règles, synchronisez les fichiers d’instructions via le script de vérification :
node scripts/check-rule-copies.js
npm test
node scripts/build-openclaw-skills.jsLimites et compromis
La réduction systématique de code comporte des exceptions précises :
- Modèles à raisonnement dense : Sur des architectures comme GPT-5.5, le modèle peut consommer un nombre élevé de tokens de réflexion interne pour évaluer chaque barreau de l’échelle, compensant en partie le gain économique sur les tokens de sortie.
- Besoins graphiques ou ergonomiques complexes : Un sélecteur de date natif
<input type="date">dépend du moteur du navigateur. Si le produit impose une sélection de plages tarifaires sur calendrier double avec affichage dynamique des prix, une bibliothèque spécialisée devient légitime. - Compatibilité ascendante : Les fonctionnalités CSS et JS modernes (comme
:has()oufield-sizing) exigent des environnements d’exécution récents.
Ponytail ne refuse pas l’installation d’une bibliothèque lourde lorsque la contrainte métier l’exige formellement. Mais il oblige l’agent à prouver son utilité avant de polluer votre arbre de dépendances.