Impeccable — ένα layer σχεδιαστικής καθοδήγησης για AI coding agents
Ένα layer σχεδιαστικής καθοδήγησης για AI coding agents, με εξήντα ντετερμινιστικούς κανόνες που πιάνουν τα σημάδια του αυτόματου σχεδιασμού. Το δοκιμάσαμε σε πραγματικό αρχείο.
Ρεπο: github.com/pbakaus/impeccable · Άδεια: Apache-2.0 · Τελευταίο skill release: skill-v4.5.0 (2026-10-02) Συντάκτης: Paul Bakaus (πρώην Google/Amplitude)
Τι κάνει
Το Impeccable είναι ένα skill — όχι plugin, όχι framework — που μπαίνει δίπλα στον AI coding agent σου και του δίνει σχεδιαστική κρίση. Εγκαθίσταται ως ένα skill με ένα τραπέζι 24 εντολών, προσθέτει live iteration μέσα στον browser, και τρέχει 60 deterministic detector rules που πιάνουν τα tells του AI-generated frontend. Οι κανόνες τρέχουν χωρίς LLM και χωρίς API key, οπότε δουλεύουν και σε CI.
Ο λόγος που υπάρχει είναι απλός: τα μοντέλα εκπαιδεύτηκαν στα ίδια SaaS templates. Το README το λέει ευθέως, και το αποτέλεσμα είναι το γνωστό: Inter παντού, purple-to-blue gradients, cards μέσα σε cards, γκρι κείμενο πάνω σε χρωματιστό φόντο. Το Impeccable δεν αφαιρεί τη δημιουργικότητα του μοντέλου — του δίνει λεξιλόγιο και όρια, ώστε να μην καταλήγει κάθε project στο ίδιο template.
Γιατί αξίζει
Το ύψος της υιοθέτησης λέει κάτι: 77.891 stars και 4.634 forks όταν τα μετρήσαμε (GitHub API, 2026-10-07), από ένα repo που άνοιξε μόλις τον Νοέμβριο του 2025. Είναι Apache-2.0, δεν κλειδώνει σε κανέναν provider, και το ίδιο το CLI είναι standalone — μπορείς να σκανάρεις χωρίς καθόλου agent.
Το πιο χρήσιμο κομμάτι για μένα δεν είναι οι εντολές. Είναι ότι οι έλεγχοι είναι deterministic: ίδιο input, ίδιο finding. Δεν εξαρτάσαι από το αν το μοντέλο «θυμήθηκε» να κοιτάξει την αντίθεση του κειμένου.
Εγκατάσταση
npx impeccable install
Από τη ρίζα του project. Ο installer εντοπίζει τα harness folders που βρίσκει (π.χ. ~/.claude, ~/.codex, .cursor), σε ρωτάει αν θέλεις project-local ή global, και γράφει τα σωστά skill files για κάθε εργαλείο. Για non-interactive: –providers=claude,codex,cursor,… και –scope=project|global.
Εναλλακτικά: git submodule + npx impeccable link, plugin install για Claude Code (/plugin marketplace add pbakaus/impeccable), ή κατέβασμα ZIP από το impeccable.style.
Μετά την εγκατάσταση τρέξε μέσα στο εργαλείο:
/impeccable init
Το init γράφει το PRODUCT.md — ποιοι είναι οι χρήστες, τι κάνει το προϊόν, τι δεν είναι. Χωρίς αυτό κάθε εντολή παράγει generic αποτέλεσμα. Προαιρετικά συμπληρώνεις DESIGN.md με npx impeccable document, για τα χρώματα, τη τυπογραφία και τα components που ήδη έχεις.
Χρήση σε κάθε LLM
Claude Code
Η καθαρότερη διαδρομή. Ή npx impeccable install –providers=claude, ή plugin: /plugin marketplace add pbakaus/impeccable και μετά εγκατάσταση από το /plugin. Ο installer γράφει και hook manifest στο .claude/settings.local.json, που τρέχει τον detector πάνω σε κάθε edit αρχείου UI και σου πετάει τα findings πίσω. Προσοχή: τα command hooks τρέχουν ανεξάρτητα από το model-tool approval — αν κάνεις unattended runs, δες το hook πριν το αφήσεις ελεύθερο, ή πέρνα –settings ‘{“disableAllHooks”:true}’.
Codex CLI
Εδώ δεν υπάρχουν /prompts: εντολές — το Impeccable μπαίνει ως skill. Μετά την εγκατάσταση άνοιξε το /skills ή πληκτρολόγησε $impeccable. Repo-local installs πάνε σε .agents/skills/, user-wide σε ~/.agents/skills/. Υπάρχει ένα βήμα που δεν γίνεται αυτόματα: μετά το install ή update, άνοιξε το /hooks και ενέκρινε το project hook. Χωρίς αυτό ο hook δεν τρέχει.
Cursor
Ο installer γράφει .cursor/ e .cursor/hooks.json. Εδώ ο hook είναι προληπτικός: μπλοκάρει κακές προτάσεις πριν πέσουν στο αρχείο (hook-before-edit), σε αντίθεση με Claude και Codex που ενημερώνουν μετά το edit. Αν δεν θέλεις hooks, –no-hooks το παραλείπει χωρίς να θυμηθεί τίποτα.
Windsurf
Εδώ χρειάζεται ειλικρίνεια: το Windsurf δεν εμφανίζεται στη λίστα supported tools του repo. Αυτό είναι δική μου εκτίμηση, όχι τεκμηριωμένος ισχυρισμός, αλλά δεν βρήκα Windsurf folder στο auto-detect ούτε hook manifest για αυτό. Η λογική διαδρομή είναι το universal build — κατέβασε το ZIP από το impeccable.style ή αντέγραψε το skill folder στη διαδρομή skills του Windsurf και τρέξε τις εντολές χειροκίνητα, χωρίς automatic hook. Ο standalone detector δουλεύει ανεξάρτητα σε κάθε περίπτωση.
Δοκιμή και ετυμηγορία
Το δοκίμασα. Έφτιαξα ένα HTML αρχείο με τα κλασικά tells — Inter, purple gradient, border-left accent, bounce easing, low-contrast γκρι κείμενο — και έτρεξα:
npx impeccable detect slop.html
Επέστρεψε έξι anti-patterns με το καθένα και την αιτιολόγησή του: side-tab border, low contrast 2.5:1 (χρειάζεται 4.5:1), bounce easing, overused font Inter, και purple/violet palette. Γρήγορο, ντετερμινιστικό, χωρίς API key. Έτρεξε σε Node 26.
Τι δεν δοκίμασα: τις εντολές /impeccable μέσα σε harness (Claude, Codex, Cursor) — αυτές θέλουν εγκατεστημένο εργαλείο και δεν τις εκτέλεσα εδώ. Και δεν έτρεξα το npx impeccable install, γιατί είναι διαδραστικό και γράφει σε harness folders. Ό,τι γράφω για αυτά είναι από την τεκμηρίωση, όχι από δική μου εκτέλεση.
Πού σπάει ή λείπει: ο hook μπλοκάρει/προειδοποιεί μόνο σε direct UI file edits — αν παράγεις UI μέσα από component libraries ή templating, το coverage πέφτει. Στο Codex απαιτείται το χειροκίνητο /hooks approve. Το Windsurf δεν υποστηρίζεται officially. Και ο αριθμός των detector rules κινείται ανάμεσα στα releases (το README αναγράφει 60 με 61 σε διαφορετικά σημεία), οπότε μη δένεσαι σε νούμερο.
Ετυμηγορία: αξίζει τον κόπο. Δεν είναι μαγικό — δεν φτιάχνει καλό design από μόνο του, σου δίνει το λεξιλόγιο και το δίχτυ ασφαλείας. Το δίχτυ είναι το σημαντικό κομμάτι: λίγα δευτερόλεπτα, μηδέν κόστος, deterministic findings, και πιάνει ακριβώς αυτό που κάνει κάθε AI frontend να μοιάζει με το προηγούμενο. Σε ομάδα που παραδίδει UI με AI, αυτό είναι η διαφορά ανάμεσα σε «έτοιμο» και «σωστό». Η δεξιά χρήση είναι ως init + audit + polish σε κάθε surface, όχι ως διακόσμηση σε όλη τη ροή.
—
Πηγές
Source: https://github.com/pbakaus/impeccable License: Apache-2.0 Release: skill-v4.5.0, published 2026-10-02 (https://github.com/pbakaus/impeccable/releases/tag/skill-v4.5.0) Stars/forks: 77,891 / 4,634 — GitHub API, 2026-10-07 (https://api.github.com/repos/pbakaus/impeccable)
Score: 8.5/10
Δοκιμασμένα βήματα εγκατάστασης / Tested steps: 1. npx impeccable detect slop.html (TESTED, works — Node 26.7.0) 2. npx impeccable install (NOT tested — interactive, writes to harness folders) 3. /impeccable init (NOT tested — needs a harness)
Supported LLMs (from repo README): Cursor, Claude Code, GitHub Copilot, DeepSeek Harness, Gemini CLI, Codex CLI, Grok Build, Hermes Agent, OpenCode, Pi, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Veto, Google Antigravity. Not supported / unconfirmed: Windsurf (my assessment — not listed, no hook manifest found).
Notes on accuracy: the given brief listed 60 detector rules and 24 commands — both match the current README. The star/fork counts in the brief (77,983 / 4,636) differ slightly from the live API reading (77,891 / 4,634); I used the live figures.