Pokayoke: Få kontroll på kodekvalitet med verktøy som faktisk fungerer for AI-agenter

På 1960-tallet introduserte den japanske produksjonspioneren Shigeo Shingo et begrep som skulle revolusjonere industriell produksjon: pokayoke. Kort sagt handler det om å designe systemer der feil rett og slett ikke kan skje – eller i det minste blir umiddelbart synlige.

filosofien er elegant. I stedet for å stole på at mennesker følger regler perfekt hver gang, bygger du mekanismer som fanger opp avvik automatisk. En kontakt som bare passer én vei. En sensor som stopper samlebåndet hvis noe er feiljustert.

Pokayoke.codes tar denne tankegangen og overfører den til kodebasen din.

Mer enn bare linting

De fleste utviklingsteam har allerede linting-verktøy. ESLint fanger opp ubrukte variabler. Prettier håndterer formatering. TypeScript passer på typesikkerhet. Disse verktøyene gjør jobben sin bra, men de dekker ikke alt.

Det som mangler er ofte den implisitte kunnskapen som sitter i hodene til folk på teamet. Konvensjoner alle kjenner til, men som ingen har formalisert. Kanskje har API-endepunktene deres et bestemt navnemønster. Kanskje finnes det regler for hvilke pakker som er akseptable i ulike sammenhenger. Eller kanskje er det en uformell avtale om filorganisering som aldri er blitt skrevet ned.

Pokayoke fyller akkurat dette hullet. Verktøyet lar deg kodifisere repository-spesifikke invarianter som faller utenfor tradisjonell linting, men som betyr like mye for kodekonsistensen.

Bygget for agenter først

Det som virkelig skiller pokayoke fra mengden: verktøyet er designet for AI-agenter fra grunnen av.

Moderne kodeassistenter kan navigere kodebasen din, skrive nye funksjoner og refaktorere eksisterende kode. Men å holde dem på linje med teamets konvensjoner? Det er fremdeles en manuell prosess. Du legger til regler i system-prompten, men agentene glemmer, hallusinerer, eller vet rett og slett ikke hva du anser som viktig.

Pokayoke løser dette ved å behandle policy-regler som førsteklasses borgere som agentene kan lese, forstå og handle på. Med pokayoke agent SKILL.md får agentene alt de trenger for å komme i gang på egen hånd, og reglene er designet for å skrives og vedlikeholdes av AI – ikke bare av menneskelige utviklere.

Bygger du en Vibe Coding-arbeidsflyt der AI tar det tunge løftet? Da gir pokayoke deg en måte å kommunisere standardene dine på en måte som faktisk sitter.

Ingen konflikter med eksisterende verktøy

En bekymring når man legger til nytt verktøy er faren for fragmentering. Du har allerede ESLint, Prettier, Husky og en haug andre verktøy som holder kodebasen ryddig. Å legge til pokayoke betyr ikke å erstatte noe av det – det betyr å utvide den eksisterende pipelinen.

Dokumentasjonen understreker at pokayoke er upartisk. Det bryr seg ikke om formatering (det er Prettiers jobb) eller generell kodekvalitet (la ESLint håndtere det). I stedet fokuserer det på de prosjekt-spesifikke invariantene som bare ditt team kjenner til.

TypeScript-reglene er lokale for repoet ditt og sjekker mot begrensningene som matter for akkurat din oppsett. Tenk på det som et egendefinert validertingslag oppå standardverktøyene dine.

Slik kommer du i gang

Lyst til å få orden på kodekvaliteten? Installasjonen er rett frem:

npx skills add rorz/pokayoke

Derfra kan du definere regler som fanger opp teamets konvensjoner. Reglene er designet for å være selvdokumenterende – både mennesker og agenter kan lese dem for å forstå hvilke policyer som gjelder og hvorfor.

Det store bildet

Pokayoke representerer et interessant skifte i hvordan vi tenker om verktøy for kodekvalitet. Tradisjonelle linters håndhever syntaks og stil. Statiske analysatorer fanger bugs. Men ettersom AI-kodeassistenter blir primære samarbeidspartnere, trenger vi nye kategorier verktøy som kommuniserer intensjon på måter agenter faktisk kan tolke og følge.

Det handler ikke lenger bare om å fange feil. Det handler om å gjøre standardene dine maskinlesbare, agentvennlige, og vanskelige å bryte – enten koden kommer fra en menneskelig utvikler eller en AI-assistent.

I den forstand kan pokayoke være blant de første verktøyene som er bygget spesifikt for hvordan vi alle kommer til å skrive kode om noen få år. Verdt å følge med på.