ΤΕΥΧΟΣ 024  ·  28 ΟΚΤΩΒΡΙΟΥ 2026 RSS
CodeCity
ΣΧΕΔΙΑΣΜΟΣ № 0001

Impeccable — σχεδιαστική κρίση για τον AI coding agent σου

Ένα layer σχεδιαστικής καθοδήγησης για AI coding agents, με εξήντα ντετερμινιστικούς κανόνες που πιάνουν τα σημάδια του αυτόματου σχεδιασμού. Το δοκιμάσαμε σε πραγματικό αρχείο.

Impeccable — σχεδιαστική κρίση για τον AI coding agent σου

Τι κάνει

Ο agent σου ξέρει να γράφει κώδικα. Δεν ξέρει να κρίνει design. Το Impeccable του δίνει αυτή την κρίση.

Είναι ένα skill. Δεν είναι plugin, δεν είναι framework. Κάθεται δίπλα στο εργαλείο σου και του δίνει λεξιλόγιο και όρια.

Γιατί χρειάζεται; Τα μοντέλα μεγάλωσαν με τα ίδια SaaS templates. Το αποτέλεσμα το έχεις δει. Inter παντού. Μωβ προς μπλε gradients. Κάρτες μέσα σε κάρτες. Γκρι κείμενο πάνω σε χρωματιστό φόντο.

Το Impeccable δεν κόβει τη δημιουργικότητα. Της βάζει φρένο στα κλισέ.

Μαζί του έρχονται 24 εντολές και 60 detector rules. Οι κανόνες δεν χρειάζονται LLM ούτε API key. Άρα τρέχουν και σε CI.

Για ποιον είναι

Για όποιον παραδίδει UI με AI agent. Για όποιον έχει κουραστεί να ελπίζει ότι το μοντέλο θα θυμηθεί να κοιτάξει την αντίθεση του κειμένου.

Εγκατάσταση

Τρέξε αυτό από τη ρίζα του project:

npx impeccable install

Ο installer ψάχνει τα harness folders που υπάρχουν (~/.claude, ~/.codex, .cursor). Ρωτά αν θέλεις project-local ή global. Γράφει τα σωστά skill files για κάθε εργαλείο.

Μετά μπες στο εργαλείο σου και τρέξε:

/impeccable init

Αυτό φτιάχνει το PRODUCT.md. Εκεί γράφεις ποιοι είναι οι χρήστες, τι κάνει το προϊόν, τι δεν είναι. Αν το παραλείψεις, οι εντολές βγάζουν generic αποτέλεσμα.

Χρήση σε κάθε LLM

Claude Code

Είναι ο πιο απλός δρόμος. Δύο επιλογές.

Με τον installer:

npx impeccable install --providers=claude

Στήνει μόνο το κομμάτι του Claude Code.

Ή μέσω plugin marketplace:

/plugin marketplace add pbakaus/impeccable

Κατεβάζει το plugin. Μετά το εγκαθιστάς μέσα από το /plugin.

Ο installer γράφει επίσης hook manifest στο .claude/settings.local.json. Ο hook τρέχει τον detector σε κάθε edit αρχείου UI και σου γυρίζει τα findings. Προσοχή σε ένα σημείο: τα command hooks δεν περνούν από το approval του μοντέλου. Αν τρέχεις unattended, διάβασε τον hook πριν τον αφήσεις ελεύθερο.

Codex CLI

Το Codex δεν έχει /prompts: εντολές. Το Impeccable μπαίνει ως skill. Μετά την εγκατάσταση άνοιξε το /skills ή γράψε $impeccable.

Υπάρχει ένα βήμα που δεν γίνεται μόνο του. Πήγαινε στο /hooks και ενέκρινε το project hook. Χωρίς έγκριση, δεν τρέχει.

Cursor

Ο installer φτιάχνει το .cursor/ και το .cursor/hooks.json. Στο Cursor ο hook δουλεύει αλλιώς. Μπλοκάρει την κακή αλλαγή πριν πέσει στο αρχείο. Στο Claude και στο Codex η ειδοποίηση έρχεται μετά.

Δεν θέλεις hook καθόλου; Βάλε –no-hooks και το προσπερνά.

Πού κερδίζει, πού χάνει

Το δυνατό σημείο είναι ότι οι έλεγχοι είναι deterministic. Ίδιο input, ίδιο finding. Κάθε φορά.

Το αδύναμο σημείο είναι η κάλυψη. Ο hook πιάνει μόνο απευθείας αλλαγές σε αρχεία UI. Αν το UI βγαίνει από component libraries ή templating, χάνει μεγάλο μέρος. Στο Codex θέλει χειροκίνητη έγκριση. Και ο αριθμός των detector rules αλλάζει από release σε release.

Δοκιμή

Έστησα ένα HTML αρχείο γεμάτο κλισέ. Inter, μωβ gradient, border-left accent, bounce easing, γκρι κείμενο με χαμηλή αντίθεση. Μετά έτρεξα:

npx impeccable detect slop.html

Επέστρεψε δέκα ευρήματα, το καθένα με την αιτιολόγησή του: γκρι κείμενο πάνω σε χρωματιστό φόντο, αντίθεση 1.3:1 αντί για 4.5:1, η Inter ως υπερχρησιμοποιημένη γραμματοσειρά, κάρτα μέσα σε κάρτα, μωβ παλέτα. Ο αριθμός εξαρτάται από το αρχείο — τα ίδια κλισέ σε άλλο HTML δίνουν άλλο πλήθος. Γρήγορα, χωρίς API key, σε Node 26.

Τι δεν έτρεξα: τις εντολές /impeccable μέσα σε harness. Θέλουν εγκατεστημένο εργαλείο. Δεν έτρεξα ούτε το npx impeccable install, γιατί είναι διαδραστικό και γράφει σε harness folders. Ό,τι λέω για αυτά προέρχεται από την τεκμηρίωση.

Ετυμηγορία

Αξίζει. Μην περιμένεις να σου φτιάξει design. Θα σου δώσει το λεξιλόγιο και ένα δίχτυ ασφαλείας. Το δίχτυ είναι το σημαντικό. Λίγα δευτερόλεπτα, μηδέν κόστος, και πιάνει το ίδιο μοτίβο που κάνει κάθε AI frontend να μοιάζει με το προηγούμενο.

Βαθμολογία: 8.5/10.

Πηγές: https://github.com/pbakaus/impeccable · https://raw.githubusercontent.com/pbakaus/impeccable/main/README.md · https://api.github.com/repos/pbakaus/impeccable · https://github.com/pbakaus/impeccable/releases/tag/skill-v4.5.0

Impeccable — σχεδιαστική κρίση για τον AI coding agent σου · ΑΠΟΤΕΛΕΣΜΑ
ΠΗΓΗ
github.com/pbakaus/impeccable