Pokayoke: Slip for fejl i dit repository med regler, som AI-agenter forstår

Da den japanske produktionspioner Shigeo Shingo introducerede begrebet pokayoke i 1960'erne, løste han et problem, som softwareudviklere kender alt for godt: hvordan får man fejl til at blive umulige – eller i det mindste øjeblikkeligt synlige?

Konceptet er elegant i sin enkelhed. I stedet for at stole på, at mennesker følger regler perfekt, designer man systemer, der automatisk fanger afvigelser. En stikprop der kun passer én vej. En sensor der standser produktionen, hvis noget ikke eraligneret. I produktion forhindrer det fejl i at nå ud til kunderne. I software forhindrer det konventionsdrift i at nå ud i produktion.

Pokayoke.codes bringer denne filosofi ind i dit repository med et værktøj, der er designet fra bunden til AI-assisteret udvikling.

Mere end linting: Politik som dokumentation

De fleste teams har allerede linters. ESLint fanger ubrugte variabler. Prettier håndhæver formatering. TypeScript opdager typefejl. Disse værktøjer gør deres arbejde godt, men de indfanger ikke den implicitte viden, der bor i团队ens hoveder – konventioner som alle kender, men som ingen nogensinde har formaliseret.

Måske følger dine API-endpoints et bestemt navngivningsmønster. Måske har I regler om, hvilke pakker der er acceptable i bestemte sammenhænge. Eller måske findes der en team-aftale om filorganisering, som ikke håndhæves noget sted.

Det er her, pokayoke kommer ind i billedet. Værktøjet lader dig kode repository-specifikke invariantter, der falder uden for traditionel linting, men som betyder lige så meget for kodekonsistens.

Agent-first fra starten

Det, der gør pokayoke virkelig interessant, er at det er bygget til AI-agenter først.

Moderne kodeassistenter kan navigere i din kodebase, skrive nye features og refaktorere eksisterende kode. Men at holde dem aligned med dit teams konventioner? Det er stadig en manuel proces. Du kan tilføje regler til din system prompt, men agenter glemmer, hallucinerer eller kender simpelthen ikke til det, du betragter som vigtigt.

Pokayoke løser dette ved at behandle politiske regler som førsteklasses borgere, som agenter kan læse, forstå og handle på. Kommandoen pokayoke agent SKILL.md får agenter op at køre autonomt, og reglerne selv er designet til at blive skrevet og vedligeholdt af AI – ikke kun for menneskelige udviklere.

Hvis du bygger en Vibe Coding-arbejdsgang, hvor AI klarer det tunge arbejde, giver pokayoke dig en måde at kommunikere dine standarder på en måde, der faktisk holder.

Spiller fint med din stack

En bekymring ved at tilføje nye værktøjer er risikoen for fragmentering. Du har allerede ESLint, Prettier, Husky og dusinvis af andre værktøjer, der holder din kodebase på rette spor. At tilføje pokayoke betyder ikke at erstatte noget af det – det betyder at udvide din eksisterende pipeline.

Dokumentationen understreger, at pokayoke er unopinioneret. Det bekymrer sig ikke om formatering (det er Prettiers opgave) eller generel kodekvalitet (lad ESLint håndtere det). I stedet fokuserer det på de projekt-specifikke invariantter, som kun dit team kender.

TypeScript-reglerne er lokale for dit repo og tjekker mod de begrænsninger, der betyder noget for din specifikke opsætning. Tænk på det som et brugerdefineret valideringslag bygget oven på din standard-værktøjskæde.

Kom i gang

Klar til at fejlsikre dit repository? Installationen er ligetil:

npx skills add rorz/pokayoke

Herefter kan du definere regler, der indfanger dit teams konventioner. Reglerne er designet til at være selvdokumenterende – både mennesker og agenter kan læse dem for at forstå, hvilke politikker der er i kraft, og hvorfor.

Det store billede

Pokayoke repræsenterer en interessant skift i, hvordan vi tænker om kodekvalitetsværktøjer. Traditionelle linters håndhæver syntaks og stil. Statiske analyseværktøjer fanger bugs. Men efterhånden som AI-kodeassistenter bliver primære samarbejdspartnere, har vi brug for nye kategorier af værktøjer, der kommunikerer intention på måder, agenter faktisk kan indtage og følge.

Det handler ikke længere bare om at fange fejl. Det handler om at gøre dine standarder maskinlæsbare, agent-venlige og svære at overtræde – uanset om koden kommer fra en menneskelig udvikler eller en AI-assistent.

I den forstand kan pokayoke være et af de første værktøjer, der er bygget med det formål at passe til den måde, vi alle vil skrive kode om et par år. værd at holde øje med.