Pokayoke: Cum să faci greșelile imposibile în repository-ul tău

Există un concept vechi din industria japoneză de manufacturing, inventat de pionierul Shigeo Shingo în anii '60, care sună surprinzător de familiar pentru oricine lucrează în software. Se numește pokayoke.

Ideea e simplă: în loc să te bazezi pe oameni să urmeze regulile perfect, proiectezi sisteme care detectează automat când ceva nu merge. Un cablu care se potrivește doar într-un singur fel. Un senzor care oprește linia de producție când ceva e aliniat greșit. În fabrici, asta înseamnă că produsele defecte nu ajung la clienți. În software, înseamnă că deviațiile de la convenții nu ajung în producție.

Pokayoke.codes aduce această filozofie direct în repository-ul tău, cu o unealtă gândită de la zero pentru era dezvoltării asistate de AI.

Mai mult decât un linter

Să fie clar: majoritatea echipelor au deja lintere. ESLint prinde variabile nefolosite. Prettier impune formatarea. TypeScript detectează erori de tip. Sunt instrumente bune la ce fac, dar nu pot captura cunoștințele implicite care trăiesc în capul echipei tale.

Poate endpointurile API urmează un pattern specific de nume. Poate ai reguli despre ce pachete sunt acceptabile în anumite contexte. Sau poate există o înțelegere tacită despre organizarea fișierelor care nu e impusă nicăieri.

Aici intră pokayoke. Îți permite să codifici invariante specifice repository-ului, lucruri care nu intră în aria de acțiune a linting-ului tradițional, dar care contează la fel de mult pentru consistența codului.

construit pentru Agenți, nu doar pentru Oameni

Ceea ce face pokayoke cu adevărat interesant: e construit pentru agenți AI pe primul loc.

Asistenții de cod moderni pot naviga prin codebase, scrie features noi, refactoriza cod existent. Dar să-i menții aliniați cu convențiile echipei tale? Asta rămâne un proces manual. Poți adăuga reguli în system prompt, dar agenții uită, halucinează, sau pur și simplu nu știu ce consideri tu important.

Pokayoke rezolvă asta tratând regulile de politică drept cetățeni de rangul întâi. Agenții le pot citi, înțelege și acționa în consecință. Comanda pokayoke agent SKILL.md îi ajută să pornească autonom, iar regulile în sine sunt gândite să fie scrise și menținute de AI — nu doar pentru dezvoltatori umani.

Dacă construiești un workflow de Vibe Coding unde AI-ul se ocupă de munca grea, pokayoke îți oferă o modalitate să comunici standardele tale într-un format care chiar rămâne.

Se integrează cu stack-ul tău

Un gând legitim: încă o unealtă nouă înseamnă fragmentare? Ai deja ESLint, Prettier, Husky și o duzină de alte instrumente care țin codebase-ul în frâu. Adăugând pokayoke nu înseamnă să le înlocuiești — înseamnă să extinzi pipeline-ul existent.

Documentația subliniază că pokayoke nu e opiniat. Nu-l interesează formatarea (asta e treaba Prettier) sau calitatea generală a codului (lasă asta pe seama ESLint). În schimb, se concentrează pe invariante specifice proiectului — lucruri pe care doar echipa ta le știe.

Regulile TypeScript sunt locale repository-ului și verifică constrângerile care contează pentru setup-ul tău particular. Gândește-te la el ca la un strat de validare personalizat peste tooling-ul standard.

Cum să începi

Pregătit să faci greșelile imposibile? Instalarea e simplă:

npx skills add rorz/pokayoke

De acolo, poți defini reguli care capturează convențiile echipei tale. Regulile sunt gândite să fie auto-documentate — atât oamenii cât și agenții le pot citi pentru a înțelege ce politici sunt în vigoare și de ce.

Imaginea de ansamblu

Pokayoke reprezintă o schimbare interesantă în felul în care gândim despre uneltele de calitate a codului. Linterele tradiționale impun sintaxă și stil. Analizatorii statice prind bug-uri. Dar pe măsură ce asistenții de cod AI devin colaboratori principali, avem nevoie de categorii noi de instrumente care comunică intenția în moduri pe care agenții chiar le pot consuma și urma.

Nu e doar despre a prinde greșeli. E despre a face standardele tale machine-readable, prietenoase cu agenții, și greu de încălcat — indiferent dacă vin de la un dezvoltator uman sau de la un asistent AI.

În acest sens, pokayoke ar putea fi una dintre primele unelte construite special pentru cum vom scrie cu toții cod peste câțiva ani. Merită să-l ai pe radar.