Pokayoke: Maak Fouten Onmogelijk met Beleid dat AI Begrijpt

In de jaren zestig bedacht Shigeo Shingo, een pionier in Japanse productie, de term pokayoke. Zijn doel? Fouten onmogelijk maken, of op z'n minst direct zichtbaar. Ontwikkelaars herkennen het probleem meteen.

De gedachte is verrassend eenvoudig. In plaats van te vertrouwen op perfecte regelnaleving, bouw je systemen die automatisch afwijkingen opvangen. Een stekker die maar op één manier past. Een sensor die de lijn stopt wanneer iets niet klopt. In de fabriek voorkomt dit defecte producten. In code voorkomt het dat team's afspraken langzaam erodeer richting productie.

Pokayoke.codes brengt dit gedachtegoed naar je repository, speciaal gebouwd voor het tijdperk van AI-gestuurde ontwikkeling.

Meer Dan Linters: Beleid Als Documentatie

De meeste teams gebruiken allang linters. ESLint spot unused variables. Prettier dwingt formatting af. TypeScript vangt typefouten af. Nuttige tools, geen twijfel. Maar ze missen allemaal hetzelfde: de stilzwijgende kennis die alleen in je team's hoofd leeft.

Misschien hebben jullie afspraken over hoe API-endpoints heten. Of regels over welke packages acceptabel zijn. Of een teamconventie over bestandsorganisatie die nergens is vastgelegd.

Hier komt pokayoke om de hoek kijken. Het codificeert repository-specifieke invarianten die buiten traditionele linting vallen, maar net zo belangrijk zijn voor consistente code.

Speciaal Gebouwd Voor AI Agents

Dit is waar pokayoke echt interessant wordt: het is vanaf de basis ontworpen voor AI agents.

Moderne coding assistants kunnen door je codebase navigeren, features schrijven, en code refactoren. Maar ze in lijn houden met jouw team's conventies? Dat is nog steeds handwerk. Je kunt regels in je system prompt zetten, maar agents vergeten, hallucineren, of weten simpelweg niet wat jij belangrijk vindt.

Pokayoke lost dit op door beleidsregels te behandelen als eerste klasse burgers. Agents kunnen ze lezen, begrijpen, en ernaar handelen. Met pokayoke agent SKILL.md krijgen agents autonome开局, en de regels zelf zijn ontworpen om door AI geschreven en onderhouden te worden—niet alleen voor mensen.

Bouw je aan een Vibe Coding workflow waar AI het zware werk doet? Dan geeft pokayoke je een manier om je standaarden te communiceren in een formaat dat echt blijft plakken.

Past Perfect in Je Stack

Een risico bij nieuwe tooling is fragmentatie. Je hebt al ESLint, Prettier, Husky, en tientallen andere tools. Pokayoke vervangt niets van dat alles—het verlengt je pipeline.

De documentatie benadrukt dat pokayoke onpartijdig is. Het interesseert zich niet voor formatting (daar is Prettier) of algemene codekwaliteit (daar is ESLint). In plaats daarvan focust het op de project-specifieke invarianten die alleen jouw team kent.

De TypeScript-regels zijn lokaal voor je repo en controleren tegen constraints die relevant zijn voor jullie specifieke setup. Denk aan het als een custom validatielaag bovenop je standaard tooling.

Aan de Slag

Wil je je repository beveiligen tegen fouten? Installatie is simpel:

npx skills add rorz/pokayoke

Daarna kun je regels definiëren die de conventies van je team vastleggen. De regels documenteren zichzelf—zowel mensen als agents kunnen ze lezen om te begrijpen welk beleid geldt en waarom.

Het Grotere Plaatje

Pokayoke vertegenwoordigt een interessante verschuiving in hoe we denken over codekwaliteitstools. Traditionele linters handhaven syntax en stijl. Statische analyzers vangen bugs. Maar nu AI coding assistants primaire samenwerkers worden, hebben we nieuwe categorieën tools nodig die intent communiceren op manieren die agents echt kunnen begrijpen en volgen.

Het gaat niet meer alleen om fouten opsporen. Het gaat om je standaarden machine-readable, agent-friendly, en moeilijk te overtreden maken—of de code nu van een menselijke developer komt of van een AI assistant.

In dat opzicht is pokayoke misschien wel een van de eerste tools specifiek gebouwd voor hoe we over een paar jaar allemaal code gaan schrijven. De moeite waard om in de gaten te houden.