Pokayoke: Zabezpečte svůj repozitář proti chybám způsobem přátelským pro AI agenty

Kdysi dávno, v šedesátých letech, přišel japonský průmyslový vizionář Shigeo Shingo s konceptem, který dnes známe jako pokayoke. Jeho cílem bylo vyřešit problém, se kterým se dodnes potýkáme i v softwarovém vývoji: jak zajistit, aby chyby prostě nemohly nastat, nebo aby byly okamžitě viditelné?

Princip je až překvapivě jednoduchý. Místo spoléhání na to, že lidé budou dokonale dodržovat pravidla, navrhujeme systémy, které odchylky zachytí automaticky. Zástrčka, která pasuje pouze jedním způsobem. Senzor, který zastaví výrobní linku při sebemenší nesrovnalosti. V manufaktuře to znamená, že vadné výrobky se k zákazníkům nikdy nedostanou. V softwaru zase konvenční úpadek nepronikne do produkce.

Nástroj pokayoke.codes přináší tuto filozofii přímo do vašeho repozitáře. Je navržen od základů pro éru vývoje s asistencí umělé inteligence.

Lintování nestačí: Politika jako dokumentace

Většina týmů už lintry má. ESLint hlídá nepoužívané proměnné. Prettier se stará o formátování. TypeScript chytá chyby typů. Tyto nástroje odvádějí svou práci dobře, ale nedokážou zachytit tacitní znalosti, které žijí v hlavách členů týmu. Jde o konvence, které všichni znají, ale nikdo je nikdy neformuloval.

Třeba vaše API endpointy používají specifické pojmenovávací vzory. Možná máte pravidla o tom, které balíčky jsou přípustné pro určité situace. Nebo existuje týmová dohoda o organizaci souborů, která ale nikde není vynucována.

Přesně tady přichází ke slovu pokayoke. Umožňuje vám zakódovat repozitářově specifické invarianty, které jsou mimo dosah tradičního lintování, ale přitom jsou stejně důležité pro konzistenci kódu.

Na prvním místě agenti

Tady přichází to nejzajímavější: pokayoke je postavené primárně pro AI agenty.

Moderní coding asistenti dokáží procházet váš kódový základ, psát nové funkce a refaktorovat stávající kód. Ale udržet je v souladu s konvencemi vašeho týmu? To je pořád manuální proces. Můžete přidat pravidla do system promptu, ale agenti zapomínají, halucinují, nebo prostě nevědí, co považujete za důležité.

Pokayoke tento problém řeší tím, že politiky a pravidla považuje za plnohodnotné občany, které agenti mohou číst, chápat a podle nich jednat. Příkaz pokayoke agent SKILL.md uvede agenty do provozu autonomně a samotná pravidla jsou navržena tak, aby je mohli psát a spravovat AI systémy — nejen lidé.

Pokud stavíte na Vibe Coding workflow, kde AI zvládá těžkou práci, pokayoke vám dává způsob, jak sdělit své standardy formou, která skutečně zůstane v paměti.

Bez konfliktu s vaším stackem

Jedna obava s přidáváním nových nástrojů je fragmentace. Už máte ESLint, Prettier, Husky a tucty dalších nástrojů, které udržují váš kód v kondici. Přidání pokayoke neznamená nahrazení čehokoli z toho — jde o rozšíření stávající pipeline.

Dokumentace zdůrazňuje, že pokayoke je nekonfliktní. Na formátování mu nezáleží (o to se stará Prettier), na obecnou kvalitu kódu také ne (to nechte na ESLint). Místo toho se soustředí na projektově specifické invarianty, které znáte jen vy.

TypeScript pravidla jsou lokální pro váš repozitář a kontrolují omezení relevantní pro vaši konkrétní konfiguraci. Berte to jako vlastní validační vrstvu nad standardními nástroji.

Jak začít

Chcete svůj repozitář zabezpečit proti chybám? Instalace je přímočará:

npx skills add rorz/pokayoke

Odtud můžete definovat pravidla, která zachycují konvence vašeho týmu. Pravidla jsou navržena tak, aby byla sama o sobě dokumentací — lidé i agenti je mohou číst a pochopit, jaké politiky platí a proč.

Širší kontext

Pokayoke představuje zajímavý posun v tom, jak přemýšlíme o nástrojích pro kvalitu kódu. Tradiční lintry vynucují syntaxi a styl. Statické analyzátory odhalují bugy. Ale s tím, jak se AI coding asistenti stávají primárními spolupracovníky, potřebujeme nové kategorie nástrojů, které komunikují záměr způsobem, který agenti skutečně dokážou přijmout a dodržovat.

Už nejde jen o odchytávání chyb. Jde o to, aby vaše standardy byly strojově čitelné, přátelské pro agenty a těžko porušitelné — ať už kód pochází od lidského vývojáře nebo od AI asistenta.

V tomto smyslu může být pokayoke jedním z prvních nástrojů cíleně postavených pro to, jak budeme všichni psát kód za pár let. Stojí za to jej sledovat.