Impeccable : directives de conception pour les agents de codage IA

Directives de conception pour agents de codage IA

Impeccable est un package de directives de conception pour agents de codage IA. Selon le README, il se présente sous la forme d'une compétence, de 23 commandes, d'une itération navigateur en direct et de 59 règles de détection déterministes pour la conception frontend générée par IA. Le démarrage rapide comporte deux étapes : exécutez `npx impeccable install` à la racine du projet, puis `/impeccable init` dans votre outil de codage IA. La documentation complète se trouve sur impeccable.style.

Pourquoi il existe

Impeccable est né de la compétence frontend-design d'Anthropic, que le README qualifie de première compétence de conception largement utilisée pour Claude. Le README indique que les modèles entraînés sur les mêmes modèles SaaS produisent des signes récurrents : Inter partout, dégradés violet à bleu, cartes dans des cartes, texte gris sur fond coloré et la tuile d'icône carrée arrondie au-dessus de chaque titre. Impeccable ajoute un flux de configuration unifié, un vocabulaire de commandes partagé et 59 règles de détection déterministes plus des vérifications de critique réservées aux LLM. Les règles déterministes s'exécutent sans LLM ni clé API.

Voies d'installation

Le README documente cinq voies d'installation. L'installateur CLI recommandé exécute `npx impeccable install`, détecte les dossiers de harnais comme `~/.claude` ou `.cursor` local au projet, et permet de personnaliser les fournisseurs ou la portée. `npx impeccable update` actualise une installation existante. Les équipes peuvent intégrer le dépôt comme sous-module Git et lier les builds de fournisseurs compilés. Des installations par plugin existent pour Claude Code et Grok Build. Vous pouvez également télécharger un ZIP depuis impeccable.style ou copier directement les dossiers de compétences depuis le dépôt pour des outils spécifiques. Le README note que les utilisateurs de Codex doivent ouvrir `/hooks` et approuver le hook de projet après l'installation, et que Grok Build nécessite la confiance du dossier de projet.

L'ensemble de commandes

Toutes les commandes passent par `/impeccable`. `init` demande si la surface est une marque ou un produit, puis écrit le contexte de conception que les commandes ultérieures lisent. Les autres commandes incluent `craft`, `document`, `extract`, `shape`, `critique`, `audit`, `polish`, `bolder`, `quieter`, `distill`, `harden`, `onboard`, `animate`, `colorize`, `typeset`, `layout`, `delight`, `overdrive`, `clarify`, `adapt`, `optimize` et `live`. Vous pouvez épingler une commande avec `/impeccable pin <command>` pour créer des raccourcis autonomes. Le README liste également les anti-modèles à éviter, tels que les polices surutilisées, le texte gris sur fond coloré, le noir/gris pur sans teinte, la surutilisation des cartes et l'assouplissement rebondissant.

Règles de détection et CLI autonome

Impeccable inclut une CLI autonome pour détecter les anti-modèles sans harnais IA. `npx impeccable detect src/` scanne un répertoire, un fichier HTML ou une URL avec Puppeteer. `--json` fournit une sortie adaptée à l'IC. Le détecteur capture 59 problèmes déterministes dans le slop IA et la qualité de conception générale, notamment les bordures d'onglets latéraux, les dégradés violets, l'assouplissement rebondissant, les lueurs sombres, la longueur de ligne, le remplissage serré, les petites cibles tactiles et les titres sautés. Il respecte les paramètres de détection `.impeccable/config.json` et `config.local.json`, et prend en charge les commentaires d'ignorance en ligne limités à un fichier ou une ligne.

Intégration du hook de conception

Sur Claude Code, GitHub Copilot, Codex, Cursor et Grok Build, `npx impeccable install` et `update` installent un manifeste de hook natif du fournisseur avec la compétence. Le hook exécute le détecteur de conception sur les modifications directes de fichiers UI et renvoie les résultats dans le flux de l'agent. Cursor bloque les écritures proposées incorrectes avant qu'elles n'atterrissent. L'installateur préserve les entrées de hook non liées, et un manifeste malformé interrompt sauf si vous réexécutez avec `--force`. Le cycle de vie du hook est configurable via `.impeccable/config.json` ; vous pouvez définir `hook.auditLog` sur un chemin pour journaliser chaque invocation en NDJSON. Codex exige une approbation manuelle du hook de projet après l'installation.

Fichiers de travail et .gitignore

L'exécution de commandes écrit des fichiers de travail sous `.impeccable/` : captures d'écran de critique et de polissage, état de session et d'aperçu en mode direct, caches d'exécution et configuration par développeur. La plupart sont éphémères et ne doivent pas être commités. Le README fournit un bloc `.gitignore` enveloppé de marqueurs, avec des modèles non ancrés pour couvrir les espaces de travail imbriqués comme `apps/web/.impeccable/`. Conservez ces fichiers suivis : `.impeccable/config.json`, `.impeccable/live/config.json`, `.impeccable/design.json` et `.impeccable/critique/*.md`. Si un fichier éphémère a été commité auparavant, utilisez `git rm --cached <path>`.

Outils pris en charge et communauté

Le README liste la prise en charge de Cursor, Claude Code, GitHub Copilot, Gemini CLI, Codex CLI, Grok Build, OpenCode, Pi, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe et Google Antigravity. Les canaux communautaires et écosystémiques incluent GitHub Discussions, le package npm et un compte Twitter. Les directives de contribution se trouvent dans `docs/DEVELOP.md`. Le projet est sous licence Apache 2.0.

Conclusion éditoriale

Le README documente cinq voies d'installation, une compétence de 23 commandes, une CLI de détection autonome et un hook de conception pour plusieurs outils de codage IA. Le projet est sous licence Apache 2.0.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes