Pokayoke: Tartsd rendben a repód hibamentes szabályrendszerrel

Shigeo Shingo japán gyártási zseni az 1960-as években alkotta meg a pokayoke fogalmát. A probléma pedig pont olyan, amivel a mai szoftverfejlesztők is küzdenek: hogyan tehetjük lehetetlenné a hibákat, vagy legalábbis azonnal láthatóvá?

Az ötlet elegánsan egyszerű. Ne emberekre bízzuk, hogy tökéletesen betartsanak minden szabályt – tervezzünk olyan rendszereket, amik automatikusan észlelik a eltéréseket. Egy dugó, ami csak egyféleképpen illeszkedik. Egy érzékelő, ami megállítja a futószalagot, ha valami nem stimmel. A gyártásban ez megakadályozza, hogy a hibás termékek eljussanak a vevőkhöz. A szoftverfejlesztésben pedig azt akadályozzuk meg, hogy a kód el飘íások becsúszzanak a productionba.

A pokayoke.codes ezt a filozófiát hozza el a projektedbe, egy eszközzel, ami eleve az AI-asszisztált fejlesztés korára lett tervezve.

A linting-en túl: a szabályok mint dokumentáció

A legtöbb csapatnak már van linting eszköze. Az ESLint jelzi a felhasználatlan változókat. A Prettier kényszeríti a formázást. A TypeScript elkapja a típushibákat. Ezek jól végzik a dolgukat, de nem ragadják meg azt a hallgatólagos tudást, ami a csapattagok fejében él – azokat a konvenciókat, amiket mindenki ismer, de senki nem írta még le.

Lehet, hogy az API endpointjaid egy bizonyos elnevezési mintát követnek. Talán vannak szabályaitok arról, mely csomagok használhatók bizonyos környezetekben. Vagy van egy megállapodásotok a fájlszervezésről, amit sehol nem kényszerítenek ki.

Ez az a rés, amit a pokayoke betölt. Lehetővé teszi, hogy kodifikáld azokat a repository-specifikus invariánsokat, amik kívül esnek a hagyományos linting hatókörén, de éppoly fontosak a kód konzisztenciájához.

Eleve ügynökbarát

Itt jön a lényeg: a pokayoke nem embereknek, hanem AI ügynököknek készült először.

A modern coding assistantok képesek navigálni a kódbázisban, új funkciókat írni, meglévő kódot refaktorálni. De hogyan tartsd őket a csapatod konvencióihoz igazítva? Az még mindig manuális folyamat. Beletéved a rendszerszintű promptba, de az ügynökök elfelejtik, hallucinálnak, vagy egyszerűen nem tudják, mi fontos neked.

A pokayoke ezt úgy oldja meg, hogy a szabályokat első osztályú polgárokká teszi – az ügynökök képesek elolvasni, megérteni és követni őket. A pokayoke agent SKILL.md parancs önállóan elindítja az ügynököket, és maguk a szabályok is úgy lettek tervezve, hogy AI írja és karbantartsa őket – nem csak emberek számára.

Ha Vibe Coding workflow-t építesz, ahol az AI végzi a nehéz munkát, a pokayoke egy módot ad arra, hogy a standardsaidat olyan formában kommunikáld, amit az valóban megjegyez.

Jól kijön a meglévő eszközeiddel

Egy újabb tool bevezetésénél félő, hogy szétaprózódik az infrastruktúrátok. Már van ESLint-etek, Prettier-etek, Huskytok és vagy tucatnyi más eszközötök, amik rendben tartják a kódot. A pokayoke hozzáadása nem jelenti azt, hogy bármit lecserélsz – azt jelenti, hogy kiterjeszted a meglévő pipeline-t.

A dokumentáció hangsúlyozza, hogy a pokayoke nem véleményes. Nem törődik a formázással (az a Prettier dolga) vagy az általános kódminőséggel (azt az ESLint kezeli). Ehelyett arra fókuszál, amit csak a te csapatod tud: a projekt-specifikus invariánsokra.

A TypeScript szabályok lokálisak a repóban, és azokat a megszorításokat ellenőrzik, amik a te konkrét felállásodhoz számítanak. Gondolj rá úgy, mint egy egyedi validációs réteger a standard eszközeid tetején.

Elkezdeni

Készen állsz, hogy hibamentessé tedd a repód? A telepítés pofonegyszerű:

npx skills add rorz/pokayoke

Onnantól kezdve definiálhatsz szabályokat, amik rögzítik a csapatod konvencióit. A szabályok öndokumentálóak – emberek és ügynökök egyaránt elolvashatják őket, hogy megértsék, milyen policy-k vannak érvényben és miért.

A nagyobb kép

A pokayoke egy érdekes eltolódást képvisel abban, ahogy a kódminőségi eszközökre gondolunk. A hagyományos linterek a szintaxist és stílust kényszerítik ki. A statikus elemzők hibákat kapnak el. De ahogy az AI coding assistantok elsődleges munkatársakká válnak, új eszközkategóriákra van szükség, amik az intenciót olyan módon kommunikálják, amit az ügynökök valóban megértenek és követni tudnak.

Nem csak arról van szó, hogy elkapjuk a hibákat. Arról van szó, hogy a standardjainkat gép által olvashatóvá, ügynökbaráttá és nehezen megsérthetővé tesszük – függetlenül attól, hogy emberi fejlesztő vagy AI assistant írta a kódot.

Ebben az értelemben a pokayoke az egyik első eszköz lehet, ami eleve arra lett építve, ahogy mindannyian fogunk majd kódot írni pár év múlva. Érdemes figyelni rá.