Pokayoke : comment rendre votre dépôt infaillible (et copain avec les agents IA)

Shigeo Shingo, ce génie japonais du manufacturing, a inventé le concept de pokayoke dans les années 60. Son ambition ? Rendre les erreurs impossibles à commettre. Ou au minimum, impossible à louper.

La logique est limpide. Au lieu de compter sur la vigilance humaine, tu conçois des systèmes qui repèrent les écarts tout seuls. Une prise qui ne s'enfiche que dans un seul sens. Un capteur qui arrête la ligne si quelque chose dépasse.

Dans l'industrie automobile, ça évite les pièces défectueuses chez le client. En développement, ça empêche le chaos conventionnel d'atterrir en production.

Pokayoke.codes transpose cette philosophie directement dans ton dépôt Git. Un outil pensés dès le départ pour l'ère du développement assisté par IA.

Pourquoi les linters ne suffisent plus

Concrètement, tu utilises déjà des linters. ESLint chope les variables inutilisées. Prettier impose le style. TypeScript hurle sur les erreurs de typage.

Ces outils rendent bien service. Mais ils ne capturent pas le savoir implicite de ton équipe. Ces conventions que tout le monde connaît mais que personne n'a jamais formalisées nulle part.

Par exemple :

• Tes endpoints API suivent un pattern de nommage précis
• Certains packages sont interdits dans certains contextes
• La structure des dossiers obéit à des règles non écrites

C'est exactement ce vide que pokayoke comble. L'outil te permet de codifier ces invariants spécifiques à ton projet. Ceux qui dépassent le cadre du linting classique mais qui comptent autant pour la cohérence du code.

Conçu pour les agents IA en priorité

Voilà ce qui rend pokayoke vraiment intéressant : c'est pensé pour les agents IA avant tout.

Les assistants de codage modernes naviguent dans ton codebase, rédigent des features, refactorent du code existant. Mais les maintenir alignés avec les conventions de ton équipe ? Ça reste du travail manuel. Tu ajoutes des règles dans ton system prompt, mais les agents oublient, hallucinent, ou ignorent simplement ce qui compte pour toi.

Pokayoke règle ça en traitant les règles de politique comme des citoyens de première classe. Les agents peuvent les lire, les comprendre, et agir en conséquence. Avec pokayoke agent SKILL.md, tu rends tes agents autonomes rapidement. Et cerise sur le gâteau : les règles sont conçues pour être écrites et maintenues par IA. Pas juste pour les humains.

Tu veux faire du Vibe Coding avec une IA qui gère l'essentiel ? Pokayoke te donne un moyen de communiquer tes standards dans un format qui reste en place.

Compatible avec ton écosystème existant

Une inquiétude légitime : ajouter un nouvel outil, c'est risquer la fragmentation.

Tu as déjà ESLint, Prettier, Husky, et une ribambelle d'autres outils pour garder ton code propre. Pokayoke ne remplace rien. Il étend ton pipeline existant.

La doc est claire : pokayoke reste non-opinionné. Le formattage ? C'est le job de Prettier. La qualité générale du code ? Laisse ESLint s'en charger. Pokayoke se concentre sur les invariants spécifiques à ton projet. Ceux que personne d'autre ne connaît.

Les règles TypeScript sont locales à ton dépôt et vérifient uniquement les contraintes qui comptent pour ta configuration. Considère ça comme une couche de validation personnalisée au-dessus de ton outillage standard.

Par où commencer ?

Tu veux rendre ton dépôt infaillible ? L'installation se fait en une ligne :

npx skills add rorz/pokayoke

Ensuite, définis les règles qui capturent les conventions de ton équipe. Les règles sont faites pour être autodocumentées. Les humains comme les agents peuvent les lire pour comprendre quelles politiques sont en place et pourquoi.

Le tableau d'ensemble

Pokayoke incarne un changement interesting dans notre façon d'approcher les outils de qualité de code.

Les linters traditionnels vérifient la syntaxe et le style. Les analyseurs statiques repèrent les bugs. Mais à mesure que les assistants IA deviennent des collaborateurs à part entière, on a besoin de nouvelles catégories d'outils. Des outils qui communiquent l'intention de manière lisible et actionnable par les agents.

Le sujet n'est plus juste de choper les erreurs. C'est de rendre tes standards lisibles par une machine, digestes pour un agent, et difficiles à enfreindre. Que le code vienne d'un développeur humain ou d'une IA.

Dans cette optique, pokayoke pourrait bien être l'un des premiers outils conçus exprès pour la façon dont on codera tous dans quelques années. À surveiller de près.