ΤΕΥΧΟΣ 088  ·  18 ΝΟΕΜΒΡΙΟΥ 2026 ELEN RSS
CodeCity
ΑΝΑΠΤΥΞΗ № 0087

Modern Web Guidance

Το Modern Web Guidance είναι ένα πακέτο γνώσης για πράκτορες κώδικα. Τους δίνει οδηγούς για σύγχρονο web πριν γράψουν κώδικα, ώστε να δουλεύουν με σημερινές πρακτικές σε προσβασιμότητα, φόρμες, απόδοση, ασφάλεια και εμπειρία χρήσης.

Modern Web Guidance

Δύο λέξεις πρώτα

Το πρώτο που μετρά εδώ είναι η πρόθεση. Δεν παίρνεις μια βιβλιοθήκη για να την κάνεις import. Παίρνεις υλικό που αλλάζει τι σκέφτεται ο πράκτορας πριν γράψει κώδικα. Και αυτό φαίνεται από την αρχή: ο οδηγός δεν πετάει γενικότητες, αλλά στήνει κανόνες που ακουμπούν πάνω στο πραγματικό πρόβλημα, από το αν ένα skip link υπάρχει μέχρι το αν ένα modal παγιδεύει σωστά την εστίαση. Εκεί ακριβώς είναι η αξία του. Δεν μιλά θεωρητικά για ποιότητα. Τη μεταφράζει σε μικρές αποφάσεις που μπορούν να ελεγχθούν πριν γραφτεί ο κώδικας.

Το δεύτερο που μετρά είναι το εύρος. Δεν μιλά για ένα στενό πρόβλημα. Πιάνει πολλά κομμάτια του web που επηρεάζουν τον τρόπο που σχεδιάζεται και γράφεται ο κώδικας.

Αυτό το κάνει να μοιάζει αλλιώς από ένα συνηθισμένο πακέτο. Εδώ το πακέτο δεν παράγει εφαρμογή. Παράγει πλαίσιο.

Τι κάνει

Το Modern Web Guidance φορτώνει οδηγούς που προηγούνται της συγγραφής. Η ιδέα είναι απλή. Αν ο πράκτορας δει πρώτα τους σωστούς κανόνες, μειώνεται η πιθανότητα να γράψει παλιό ή πρόχειρο web code.

Ο κύριος κατάλογος του έργου είναι το https://github.com/GoogleChrome/modern-web-guidance και ο κώδικας είναι στο https://github.com/GoogleChrome/modern-web-guidance-src. Το πακέτο στο npm λέγεται modern-web-guidance.

Δεν μιλάμε για μία μοναδική οδηγία. Μιλάμε για σύνολο υλικού. Στην εγκατάσταση μπαίνουν αρχεία SKILL.md και οδηγοί για accessibility, css, css-layout, forms, html, js, performance, privacy, pwa, security, ui-atoms, ui-behaviors, ui-components, user-experience, visual-design, wasm και webmcp.

Σημασία έχει και το τι υπάρχει μέσα σε έναν τέτοιο οδηγό. Ο οδηγός accessibility, που μετρήθηκε στα 51.734 bytes, ξεκινά με δύο αρχές που δίνουν τον τόνο όλου του υλικού: η προσβασιμότητα είναι το κατώτατο όριο, όχι το ταβάνι, και τα μοτίβα είναι ειδικά για κάθε περίπτωση· καμία λίστα ελέγχου δεν αντικαθιστά την πραγματική δοκιμή, μαζί και με ανθρώπους με αναπηρίες. Αυτό ακούγεται προφανές, αλλά στην πράξη κόβει πολλά λάθη πριν γίνουν κώδικας. Αν ο πράκτορας ξέρει ότι ένα checklist δεν αρκεί, θα κοιτάξει διαφορετικά ένα modal, ένα form ή μια πλοήγηση με πληκτρολόγιο. Και αν ο οδηγός έχει ενότητες για landmarks, επικεφαλίδες, λίστες, πίνακες, συνδέσμους παράλειψης, προσβάσιμα ονόματα, γλώσσα εγγράφου, εστίαση, alt text, φόρμες, live regions, χρώμα, τυπογραφία, κίνηση και modals, τότε δεν του λέει απλώς «κάνε το accessible». Του λέει πού ακριβώς σπάει η εμπειρία και πώς να την ξαναστήσει.

Στο ίδιο βάθος φαίνονται και τα παραδείγματα των 209 περιπτώσεων χρήσης. Το ime-safe-enter-submit λύνει το πρόβλημα της υποβολής με Enter χωρίς να σπάει τη σύνθεση κειμένου για όποιον γράφει με IME. Το validate-input-after-interaction αποφεύγει το άκαιρο μήνυμα λάθους πριν ο χρήστης ακουμπήσει το πεδίο. Το fluid-scaling δένει μέγεθος γραμμάτων και αποστάσεων με το ίδιο το πλαίσιο που τα περιέχει, όχι με σταθερά σημεία αλλαγής. Το animate-to-intrinsic-sizes δίνει ομαλό άνοιγμα και κλείσιμο στο φυσικό μέγεθος ενός στοιχείου, όπως ένα αναδιπλούμενο μενού. Το autofill-payment-form φτιάχνει φόρμα κάρτας με τα σωστά πεδία ώστε ο browser να τη συμπληρώνει μόνος του. Το webmcp εκθέτει λειτουργίες της σελίδας σε πράκτορες τεχνητής νοημοσύνης με τυποποιημένο τρόπο. Αυτά δεν είναι συμβουλές γενικής αρχής. Είναι συγκεκριμένα σφάλματα που διορθώνονται πριν γραφτούν.

Ο οδηγός δεν είναι θεωρία για το ράφι. Είναι εργαλειοθήκη που κατεβαίνει στη λεπτομέρεια. Ένας πράκτορας που τον διαβάζει πριν γράψει ένα page structure ή μια φόρμα, θα σκεφτεί αλλιώς για το τι είναι πραγματικός έλεγχος και τι είναι απλώς οπτική απομίμηση.

Το πακέτο είναι γραμμένο για πράκτορες κώδικα. Δεν το διαβάζει ο άνθρωπος σαν βιβλίο αναφοράς και δεν το χρησιμοποιεί ο browser σαν εξάρτηση. Το φορτώνει ο πράκτορας, και το κάνει για να αλλάξει τον τρόπο που αποφασίζει.

Τι δεν κάνει

Δεν είναι MCP server. Αυτό έχει σημασία, γιατί εύκολα το περνάς για υπηρεσία που σερβίρει εργαλεία από δίκτυο. Εδώ μιλάμε για CLI που εγκαθιστά γνώση, όχι για endpoints.

Δεν είναι βιβλιοθήκη εφαρμογής. Δεν τη βάζεις στο project για να χτίσεις features με συναρτήσεις. Δεν εισάγεις APIs. Δεν σου δίνει runtime συμπεριφορά.

Δεν αντικαθιστά την κρίση του ανθρώπου ή του πράκτορα. Αν ο πράκτορας δεν ξέρει να εφαρμόσει καλά έναν οδηγό, το υλικό μόνο του δεν τον σώζει. Του δίνει καλύτερη αφετηρία, όχι αυτοματισμό σκέψης.

Δεν περιορίζεται σε ένα framework, και αυτό είναι ταυτόχρονα δύναμη και όριο. Δύναμη, γιατί το υλικό πιάνει όλο το web. Όριο, γιατί δεν θα σου λύσει ειδικά προβλήματα ενός προϊόντος αν η βασική αρχιτεκτονική του ήδη χωλαίνει.

Η δοκιμή μας με τα χέρια

Σήμερα, 18/11/2026, το δοκιμάσαμε σε καθαρό φάκελο. Εκεί φαίνεται αν ένα εργαλείο στέκεται στα πόδια του ή αν θέλει έτοιμο περιβάλλον για να δείξει ωραίο.

Η εντολή npx -y modern-web-guidance@latest install κατέβασε το αποθετήριο, βρήκε 2 skills, εγκατέστησε 1 με όνομα modern-web-guidance και άφησε 2,5 MB στον φάκελο .agents/skills/modern-web-guidance.

Στην ίδια εγκατάσταση γράφτηκαν 17 οδηγοί και ένα SKILL.md μεγέθους 9.891 bytes. Έγραψε επίσης .claude/skills/ ως σύνδεσμο και skills-lock.json. Το lock κλείδωσε την εγκατάσταση σε συγκεκριμένη υποχώρηση, στο commit 64a6d708…. Αυτό είναι καλό σημάδι. Ξέρεις τι πήρες.

Το αρχείο που αφήνει πίσω του είναι το αρχείο της συνήθειας. Οι 17 οδηγοί μένουν στον φάκελο .agents/skills/, το SKILL.md μένει ως κεντρική είσοδος των 9.891 bytes, και ο σύνδεσμος .claude/skills/ δείχνει ότι το ίδιο υλικό μπορεί να φανεί σε διαφορετικό client χωρίς να αντιγραφεί. Το skills-lock.json είναι το κομμάτι που μετρά περισσότερο. Κλειδώνει τα πάντα σε μία συγκεκριμένη υποχώρηση. Χωρίς αυτό, το ίδιο εργαλείο θα μπορούσε να συμπεριφερθεί αλλιώς σε δύο μηχανήματα την ίδια μέρα. Με αυτό, ξέρεις ότι παίρνεις το ίδιο υλικό και όχι μια μετακινούμενη εκδοχή του.

Στο ίδιο πέρασμα δήλωσε υποστήριξη για Claude Code, Codex CLI, Cursor, Antigravity, Gemini CLI, Amp, Cline και άλλα. Το εργαλείο έστησε το skill universal για 21 πράκτορες και συνδεσμικό για Claude Code.

Η list γυρίζει 209 περιπτώσεις χρήσης. Η search "form validation" γυρίζει 1.983 bytes. Η retrieve accessibility γυρίζει οδηγό 51.734 bytes. Η legacy-scan . σε φάκελο χωρίς παλιό κώδικα γυρίζει 0 ευρήματα. Το ίδιο πέρασμα λέει και κάτι ακόμη: οι έλεγχοι παλιών μοτίβων καλύπτουν 38 οδηγούς, περίπου το 20% του υλικού. Αυτό είναι όριο. Το legacy-scan δεν κρίνει όλο το πακέτο. Κρίνει ένα πέμπτο του.

Και οι αριθμοί που μετρήθηκαν γύρω από το έργο είναι καθαροί. Οι λήψεις είναι 261.186 την τελευταία εβδομάδα και 554.305 τον τελευταίο μήνα. Το κύριο αποθετήριο έχει 22.335 αστέρια και 889 forks, ενώ ο κατάλογος του κώδικα έχει 8.559 αστέρια. Το έργο δημιουργήθηκε στις 23/03/2026.

Η τελευταία έκδοση στο npm είναι η 1.0.1 και δημοσιεύτηκε στις 16/11/2026. Το πακέτο ζητά Node >= 22. Και ο εγκαταστάτης λέει ότι η Google συλλέγει ανώνυμα στοιχεία χρήσης για τη βελτίωση του εργαλείου και ότι η τηλεμετρία απενεργοποιείται πλήρως με DISABLE_TELEMETRY=1.

Από τη δοκιμή, το δυνατό σημείο είναι καθαρό. Το εργαλείο εγκαθίσταται μόνο του, κουβαλά πολλούς οδηγούς και κλειδώνει την έκδοση. Δεν φτιάχνει φασαρία. Απλώς αφήνει υλικό που μπορεί να χρησιμοποιήσει ο πράκτορας.

Χρήση από το κέλυφος

Αν το δεις πρακτικά, η ροή είναι απλή. Πρώτα εγκαθιστάς. Μετά ρωτάς. Μετά φέρνεις τον οδηγό που θες. Αυτό είναι όλο το νόημα του CLI εδώ.

Η βασική εγκατάσταση είναι αυτή:

npx modern-web-guidance@latest install

Αν θες να ψάξεις μια χρήση:

npx modern-web-guidance@latest search "form validation"

Αν θες να φέρεις συγκεκριμένο οδηγό:

npx modern-web-guidance@latest retrieve accessibility

Αν θες να μετρήσεις τι υπάρχει πριν μπεις βαθύτερα:

npx modern-web-guidance@latest list

Η list γυρίζει 209 περιπτώσεις χρήσης. Αυτό σου δίνει το εύρος με μια ματιά, πριν διαλέξεις δρόμο.

Αν θες να ψάξεις αν ένα μοτίβο ταιριάζει σε παλιό κώδικα:

npx modern-web-guidance@latest legacy-scan .

Η legacy-scan . γυρίζει 0 ευρήματα όταν ο φάκελος δεν έχει παλιό κώδικα. Και μαζί σου λέει και το όριο: οι έλεγχοι παλιών μοτίβων καλύπτουν 38 οδηγούς, περίπου το 20% του υλικού. Δεν είναι πλήρης κρίση του πακέτου. Είναι έλεγχος ενός μέρους του.

legacy-scan είναι το πιο χρήσιμο όταν έχεις ήδη κώδικα και θέλεις να δεις πού μυρίζει παλιό μοτίβο. Σε κενό φάκελο δεν λέει πολλά. Σε πραγματικό codebase δείχνει αν το υλικό του πιάνει τόπο.

Εγκατάσταση

Το σημαντικό εδώ είναι ότι η εγκατάσταση δεν είναι ένα αόριστο «τρέξε κάτι». Είναι συγκεκριμένο βήμα που γράφει skills στον δίσκο και τα δένει σε συγκεκριμένη έκδοση.

Η εντολή είναι αυτή:

npx modern-web-guidance@latest install

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

Το πακέτο επίσης δηλώνει ότι θέλει Node 22 ή νεότερο. Αυτό δεν είναι δική μας εκτίμηση. Είναι απαίτηση του ίδιου του πακέτου. Όποιος έχει παλιότερο Node δεν το σηκώνει έτσι απλά.

Το πακέτο επίσης λέει ότι δουλεύει με πολλούς πράκτορες. Αυτό έχει σημασία, γιατί δεν σε κλειδώνει σε ένα μόνο client. Το ίδιο skill μπορεί να γίνει κοινό υπόβαθρο για διαφορετικά εργαλεία συγγραφής κώδικα.

Πότε σου λύνει τα χέρια

Σε λύνει όταν γράφεις το πρώτο σου site και δεν ξέρεις ακόμα ποια λάθη επαναλαμβάνονται. Ένας οδηγός για accessibility ή φόρμες δίνει στον πράκτορα ακριβή σχήματα σκέψης πριν γράψει τον κώδικα. Έτσι δεν χρειάζεται να ανακαλύπτεις κάθε φορά από την αρχή ότι ένα label λείπει ή ότι το πληκτρολόγιο δεν φτάνει εκεί που πρέπει.

Σε λύνει όταν μια ομάδα θέλει τα bots της να μη γράφουν με δέκα διαφορετικά ύφη. Το υλικό κρατά κοινή γραμμή. Αν ο ένας πράκτορας κάνει normalize ένα form και ο άλλος ξαναγεννά ίδιο UI αλλά με άλλο τρόπο, το αποτέλεσμα φαίνεται μπαλωμένο. Εδώ η κοινή γνώση κόβει τη διαφορά πριν μπει στον κώδικα.

Σε λύνει επίσης όταν συντηρείς παλιό site και θέλεις να δεις πού μυρίζει παλιό μοτίβο. Εκεί ακριβώς αξίζει ο legacy-scan. Δεν τον θες για να σου χαϊδέψει το αυτί. Τον θες για να σου δείξει πού έχουν μείνει συμπεριφορές ή δομές που δεν στέκουν πια. Σε legacy codebase, αυτή η ευθεία ματιά γλιτώνει χρόνο.

Πότε να το αποφύγεις

Να το αποφύγεις όταν ψάχνεις άμεση εκτέλεση features και όχι καθοδήγηση. Αν θέλεις απλώς να προσθέσεις μια λειτουργία, το εργαλείο αυτό δεν είναι shortcut. Είναι πλαίσιο.

Να το αποφύγεις και όταν δεν έχεις διαδικασία για agents. Αν ο τρόπος δουλειάς σου δεν περνά από πράκτορα που διαβάζει skills πριν γράψει, το πακέτο χάνει το νόημά του.

Να το αποφύγεις και όταν τρέχεις παλιότερο Node από το 22. Το πακέτο το θέλει ρητά, και εκεί δεν χωράει ωραιοποίηση.

Τέλος, να το αποφύγεις αν δεν σε ενδιαφέρει η πειθαρχία στο web. Το υλικό είναι ευρύ, αλλά έχει άποψη. Αν θες να γράφεις όπως να ’ναι, θα το βρεις αυστηρό.

Τι κρατάω

Κρατάω ότι είναι νέο, συγκεκριμένο και πρακτικό. Δεν παριστάνει κάτι άλλο. Δεν προσποιείται ότι είναι framework. Δεν προσποιείται ότι είναι server. Είναι skill pack για πράκτορες κώδικα.

Κρατάω επίσης το lock σε συγκεκριμένη υποχώρηση. Αυτό δίνει εμπιστοσύνη. Δεν κοιτάς ένα κινούμενο στόχο. Βλέπεις τι εγκατέστησες.

Κρατάω ότι έχει πραγματικό εύρος. Οι 17 οδηγοί και οι 209 περιπτώσεις χρήσης δείχνουν ότι δεν είναι διακοσμητικό repo. Είναι υλικό με όγκο και σκοπό.

Κρατάω τέλος ότι η τηλεμετρία είναι δηλωμένη καθαρά. Δεν μου αρέσει να ψάχνω τι στέλνει ένα εργαλείο πίσω. Εδώ αυτό γράφτηκε ανοιχτά.

Τι κοστίζει

Σε χρήμα: μηδέν. Άδεια Apache-2.0, χωρίς κλειδί, χωρίς λογαριασμό, χωρίς συνδρομή, χωρίς δεύτερη υπηρεσία. Η εγκατάσταση άφησε 2,5 MB στον δίσκο — αυτό είναι όλο το αποτύπωμα.

Ο φόρος του πλαισίου δεν είναι σταθερός — πληρώνεται ανά οδηγό. Δεν είναι MCP server, άρα δεν δηλώνει εργαλεία που κάθονται σε κάθε κουβέντα: ο σταθερός φόρος είναι μηδέν. Το κόστος εμφανίζεται τη στιγμή που ζητάς κάτι. Το κεντρικό αρχείο SKILL.md είναι 9.891 bytes, δηλαδή περίπου 2.500 tokens σε εκτίμηση (bytes ÷ 4), και ένας οδηγός όπως το accessibility, στα 51.734 bytes, είναι περίπου 12.900 tokens. Για σύγκριση, ένας μέτριος MCP server με επτά εργαλεία φορτώνει περίπου 1.168 tokens σε κάθε κουβέντα ακόμη κι όταν δεν τον χρησιμοποιείς. Εδώ πληρώνεις μόνο ό,τι διαβάζεις.

Η μέτρηση και η εκτίμηση, χωριστά: τα μεγέθη σε bytes είναι δικές μας μετρήσεις από το τρέξιμο του εργαλείου· η μετατροπή σε tokens είναι εκτίμηση (χαρακτήρες διά τέσσερα), όχι μέτρηση. Το «μηδέν» στο χρήμα δεν είναι εκτίμηση: είναι η άδεια Apache-2.0 και η απουσία λογαριασμού, που τα ελέγξαμε στο μητρώο και στο αποθετήριο.

Σε τηλεμετρία: ο ίδιος ο εγκαταστάτης δηλώνει ότι η Google συλλέγει ανώνυμα στοιχεία χρήσης και ότι απενεργοποιείται πλήρως με DISABLE_TELEMETRY=1. Δηλαδή το μηδενικό κόστος δεν το πληρώνεις με τα δεδομένα σου, αν δεν το θέλεις.

Πηγές:
https://github.com/GoogleChrome/modern-web-guidance
https://github.com/GoogleChrome/modern-web-guidance-src
https://www.npmjs.com/package/modern-web-guidance
https://github.com/GoogleChrome/modern-web-guidance/releases
https://github.com/GoogleChrome/modern-web-guidance#readme
https://docs.npmjs.com/cli/v11/using-npm/config#engine-strict

Εγκατάσταση

1 ΒΗΜΑ
  1. npx modern-web-guidance@latest install
Modern Web Guidance · ΑΠΟΤΕΛΕΣΜΑ
ΠΗΓΗ
github.com/GoogleChrome/modern-web-guidance