Pokayoke: Slipp mänskliga missar i ditt repo

På 1960-talet myntade den japanske tillverkningspionjären Shigeo Shingo termen pokayoke. Idén var lika enkel som genial: bygg system som gör det omöjligt – eller åtminstone direkt uppenbart – att göra fel.

Tänk dig ett eluttag som bara passar ett enda håll. Eller en sensor som stoppar produktionslinjen så fort något är skevt. I tillverkning handlar det om att defekter aldrig når kunden. Inom mjukvaruutveckling handlar det om att konventionsavvikelser aldrig når produktion.

Pokayoke.codes tar denna filosofi och applicerar den på ditt repository – byggt från grunden för AI-assisterad utveckling.

Mer än bara linting

De flesta team har redan linters. ESLint hittar oanvända variabler. Prettier ser till att formateringen är konsekvent. TypeScript fångar typfel. Verktygen gör sitt jobb bra, men de fångar inte upp den tysta kunskap som bara finns i teamets huvuden – konventioner som alla känner till men som ingen formaliserat.

Kanske har era API-endpoints en specifik namngivningsstandard. Eller så finns det regler om vilka paket som är godkända för vissa sammanhang. Eller en överenskommelse om filstruktur som inte finns dokumenterad någonstans.

Här kommer pokayoke in i bilden. Verktyget låter dig kodifiera de repo-specifika invarianterna som faller utanför traditionell linting men som är lika viktiga för kodkonsistens.

Agent-first från start

Det som gör pokayoke intressant är att det är byggt för AI-agenter i första hand.

Moderna kodningsassistenter kan navigera din kodbas, skriva nya features och refaktorera befintlig kod. Men att hålla dem i linje med teamets konventioner? Det är fortfarande ett manuellt arbete. Du kanske lägger till regler i din systemprompt, men agenter glömmer, hittar på saker, eller helt enkelt inte vet vad du tycker är viktigt.

Pokayoke löser detta genom att behandla policyregler som förstklassiga medborgare – regler som agenter kan läsa, förstå och agera på. Med pokayoke agent SKILL.md får agenter igång autonomt, och reglerna är designade för att skrivas och underhållas av AI – inte bara för mänskliga utvecklare.

Bygger du en Vibe Coding-workflow där AI tar det tunga jobbet? Då ger pokayoke dig ett sätt att kommunicera dina standarder på ett sätt som faktiskt fastnar.

Spelar fint med din stack

En risk med nytt verktyg är fragmentering. Du har redan ESLint, Prettier, Husky och dussinet andra verktyg som håller din kodbas i schack. Att lägga till pokayoke betyder inte att ersätta någon av dem – det betyder att utöka din befintliga pipeline.

Dokumentationen betonar att pokayoke är obundet. Det bryr sig inte om formatering (det är Prettiers jobb) eller allmän kodkvalitet (låt ESLint sköta det). Istället fokuserar det på de projektspecifika invarianterna som bara ditt team känner till.

TypeScript-reglerna är lokala för ditt repo och kontrollerar mot de begränsningar som matter för just din setup. Tänk på det som ett anpassat valideringslager ovanpå ditt standardverktyg.

Kom igång

Redo att mistake-proofa ditt repository? Installationen är enkel:

npx skills add rorz/pokayoke

Därefter kan du definiera regler som fångar upp ditt teams konventioner. Reglerna är designade för att vara självdokumenterande – både människor och agenter kan läsa dem för att förstå vilka policies som gäller och varför.

Den större bilden

Pokayoke representerar ett intressant skifte i hur vi tänker kring kodkvalitetsverktyg. Traditionella linters hanterar syntax och stil. Statiska analysatorer hittar buggar. Men när AI-kodningsassistenter blir primära samarbetspartners behöver vi nya verktyg som kommunicerar intention på sätt som agenter faktiskt kan ta till sig och följa.

Det handlar inte längre bara om att fånga misstag. Det handlar om att göra dina standarder maskinläsbara, agentvänliga och svåra att bryta – oavsett om koden kommer från en mänsklig utvecklare eller en AI-assistent.

I den meningen kan pokayoke vara ett av de första verktygen som är byggt för hur vi alla kommer att skriva kod om ett par år. Värt att hålla ögonen på.