Pokayoke: Πώς να Κάνεις το Repo σου Αλάνθαστο (και Φιλικό προς τους Agents)

Ο Shigeo Shingo, ο πρωτοπόρος της ιαπωνικής βιομηχανίας, επινόησε τον όρο pokayoke στη δεκαετία του '60. Το πρόβλημα που έλυνε; Το ίδιο που απασχολεί τους προγραμματιστές: πώς κάνεις τα λάθη αδύνατα—ή τουλάχιστον, εμφανή από την πρώτη στιγμή;

Η λογική είναι απλή. Αντί να βασίζεσαι στην τέλεια συμμόρφωση, σχεδιάζεις συστήματα που πιάνουν τις αποκλίσεις αυτόματα. Ένα βύσμα που μπαίνει μόνο από μία μεριά. Ένας αισθητήρας που σταματά τη γραμμή όταν κάτι δεν είναι στη θέση του. Στη βιομηχανία, αυτό εμποδίζει τα ελαττωματικά προϊόντα να φτάσουν στον πελάτη. Στο software, εμποδίζει την απόκλιση από τις συμβάσεις να φτάσει στην παραγωγή.

Το pokayoke.codes φέρνει αυτή τη φιλοσοφία στο repository σου, με ένα εργαλείο σχεδιασμένο εξ αρχής για την εποχή της AI-assisted ανάπτυξης.

Πέρα από το Linting: Οι Πολιτικές ως Documentation

Οι περισσότερες ομάδες έχουν ήδη linters. Το ESLint βρίσκει αχρησιμοποίητες μεταβλητές. Το Prettier επιβάλλει formatting. Το TypeScript πιάνει λάθη τύπων. Καλά εργαλεία—αλλά δεν καλύπτουν την άτυπη γνώση που υπάρχει μόνο στο μυαλό της ομάδας. Συμβάσεις που όλοι ξέρουν αλλά κανείς δεν έχει γράψει κάπου.

Μπορεί τα API endpoints σου να ακολουθούν ένα συγκεκριμένο naming pattern. Ίσως υπάρχουν κανόνες για το ποιες βιβλιοθήκες επιτρέπονται σε συγκεκριμένα contexts. Ή μια συμφωνία για την οργάνωση αρχείων που δεν επιβάλλεται πουθενά.

Εδώ είναι το κενό που γεμίζει το pokayoke. Σου επιτρέπει να κωδικοποιήσεις invariants ειδικά για το repository σου—πράγματα που δεν αφορούν το παραδοσιακό linting αλλά έχουν την ίδια σημασία για τη συνέπεια του κώδικα.

Agent-First by Design

Εδώ γίνεται ενδιαφέρον. Το pokayoke είναι χτισμένο για AI agents πρώτα.

Τα σύγχρονα coding assistants μπορούν να πλοηγηθούν στον κώδικά σου, να γράψουν νέα features, να κάνουν refactoring. Αλλά να τα κρατήσεις ευθυγραμμισμένα με τις συμβάσεις της ομάδας; Αυτό παραμένει χειροκίνητο. Μπορεί να προσθέσεις κανόνες στο system prompt, αλλά οι agents ξεχνάνε, κάνουν hallucinations, ή απλά δεν ξέρουν τι θεωρείς εσύ σημαντικό.

Το pokayoke λύνει αυτό αντιμετωπίζοντας τους κανόνες πολιτικής ως first-class citizens που οι agents μπορούν να διαβάσουν, να καταλάβουν, και να ακολουθήσουν. Το pokayoke agent SKILL.md θέτει τους agents σε λειτουργία αυτόνομα, και οι κανόνες είναι σχεδιασμένοι να γράφονται και να συντηρούνται από AI—όχι μόνο για ανθρώπους.

Αν χτίζεις ένα Vibe Coding workflow όπου το AI κάνει τη βαριά δουλειά, το pokayoke σου δίνει τρόπο να επικοινωνήσεις τα standards σου σε format που πραγματικά κολλάει.

Παίζει Καλά με το Stack σου

Ένας προβληματισμός με κάθε νέο εργαλείο είναι ο κατακερματισμός. Έχεις ήδη ESLint, Prettier, Husky, και δεκάδες άλλα tools. Το να προσθέσεις pokayoke δεν σημαίνει να αντικαταστήσεις τίποτα—σημαίνει να επεκτείνεις τον υπάρχοντα pipeline.

Η τεκμηρίωση τονίζει ότι το pokayoke είναι unopinionated. Δεν ασχολείται με formatting (Prettier's job) ή γενική ποιότητα κώδικα (ESLint). Αντίθετα, εστιάζει στα project-specific invariants που μόνο η ομάδα σου γνωρίζει.

Οι TypeScript κανόνες είναι τοπικοί στο repo σου και ελέγχουν τους περιορισμούς που έχουν σημασία για τη δική σου setup. Σκέψου το ως ένα custom validation layer πάνω από τα standard tools.

Πώς Ξεκινάς

Έτοιμος να κάνεις το repo σου αλάνθαστο; Η εγκατάσταση είναι απλή:

npx skills add rorz/pokayoke

Από εκεί και πέρα, μπορείς να ορίσεις κανόνες που αποτυπώνουν τις συμβάσεις της ομάδας σου. Οι κανόνες είναι σχεδιασμένοι να είναι self-documenting—τόσο άνθρωποι όσο και agents μπορούν να τους διαβάσουν και να καταλάβουν ποιες πολιτικές ισχύουν και γιατί.

Η Μεγάλη Εικόνα

Το pokayoke αντιπροσωπεύει μια ενδιαφέρουσα στροφή στο πώς σκεφτόμαστε τα tools ποιότητας κώδικα. Τα παραδοσιακά linters επιβάλλουν σύνταξη και στυλ. Οι static analyzers πιάνουν bugs. Αλλά καθώς τα AI coding assistants γίνονται βασικοί συνεργάτες, χρειαζόμαστε νέες κατηγορίες εργαλείων που επικοινωνούν intent με τρόπο που οι agents μπορούν πραγματικά να καταναλώσουν και να ακολουθήσουν.

Δεν πρόκειται απλά για το να πιάσεις λάθη. Πρόκειται να κάνεις τα standards σου machine-readable, agent-friendly, και δύσκολο να παραβιαστούν—είτε ο κώδικας προέρχεται από άνθρωπο είτε από AI assistant.

Σε αυτή την έννοια, το pokayoke είναι ίσως ένα από τα πρώτα εργαλεία built εξ ολοκληρου για το πώς θα γράφουμε όλοι κώδικα σε λίγα χρόνια. Αξίζει να το παρακολουθείς.