Polylith: Η Αρχιτεκτονική που Χρειάζεται η Εποχή των AI Assistants

Θυμάμαι πριν από έναν χρόνο να λέμε "agent-friendly architecture" και ο κόσμος να κοιτάζει απορημένος. Σήμερα είναι απαραίτητο να το συζητάμε.

Οι AI coding assistants έχουν περάσει από το στάδιο του πειραματισμού στο καθημερινό μας toolchain. Και κάτι που συνειδητοποιούμε όλο και περισσότερο: το πόσο αποτελεσματικοί είναι αυτοί οι agents dipende από το πώς είναι δομημένο το codebase μας.

Δώσε σε ένα AI ένα μπάλωμα από scattered services, κυκλικές εξαρτήσεις και μεταβλητές με ονόματα όπως temp2_final_REAL, και θα περάσεις τη μισή μέρα κάνοντας clarify τι εννοείς. Δώσε του όμως ένα καθαρό codebase όπου το context ρέει φυσικά—εκεί συμβαίνει η μαγεία.

Τι Είναι το Polylith

Polylith: microservices benefits με monorepo simplicity. Παίρνεις τη modularity και την απομόνωση των microservices, αλλά τα έχεις όλα σε ένα repository.

Η βασική ιδέα είναι ότι ο κώδικάς σου αποτελείται από building blocks—σαν LEGO. Κάποια μικρά και focused, κάποια μεγαλύτερα aggregates, αλλά όλα σχεδιασμένα να ταιριάζουν μεταξύ τους.

Στο Polylith αυτά τα blocks ονομάζονται bricks και χωρίζονται σε δύο κατηγορίες:

• Components: Το κέντρο της εφαρμογής. Εδώ μένει το business logic, οι λειτουργίες, η ουσία.
• Bases: Τα entry points. Στην ιδανική περίπτωση είναι thin—κάνουν delegate σε components αντί να περιέχουν δική τους λογική.

Γιατί έχει σημασία αυτό; Γιατί σε αναγκάζει να σκέφτεσαι τα boundaries από νωρίς. Ένα base δεν χρειάζεται να ξέρει τι γίνεται μέσα σε ένα component—απλά ξέρει πώς να το καλέσει. Clean, predictable, και εύκολο να το πλοηγηθεί κανείς—ανθρώπινο ή AI.

Γιατί Πρέπει να Νοιαζόμαστε για την Αρχιτεκτονική

Εδώ γίνεται ενδιαφέρον από τη σκοπιά της ανάπτυξης με AI.

Τα παραδοσιακά microservices φέρνουν complexity που μπερδεύει ακόμα και τους πιο έξυπνους agents:

• Code scattered σε πολλαπλά repositories
• Duplicate logic σε διαφορετικά services
• Shared code σε libraries (άρα ακόμα περισσότερα repositories)
• Version mismatches

Ένας agent που προσπαθεί να καταλάβει ή να τροποποιήσει τέτοιο σύστημα πρέπει να κάνει hop μεταξύ repositories, να βρει πού μένει η λειτουργικότητα, να untangle dependencies—όλα αυτά πριν γράψει μια χρήσιμη γραμμή κώδικα. Είναι cognitive overhead που δεν θέλεις.

Το Polylith λύνει αυτό κρατώντας τα πάντα σε ένα μέρος. Το context είναι πάντα διαθέσιμο. Οι agents δεν χρειάζεται να πλοηγούνται σε labirinth από interconnected repositories—η πλήρης εικόνα υπάρχει σε ένα workspace.

Το Tooling

Αυτό που κάνει το Polylith ιδιαίτερα ελκυστικό είναι το tooling ecosystem του. Τα καλά εργαλεία επιβάλλουν τους κανόνες της αρχιτεκτονικής αυτόματα. Σε προειδοποιούν όταν παραβιάζονται boundaries, εντοπίζουν circular dependencies, κρατάνε το codebase honest.

Για Python developers, υπάρχει tooling που ενσωματώνεται με τους αγαπημένους σας package managers—uv, poetry, pdm, pixi. Υπάρχει ακόμα built-in support για agent skills, ουσιαστικά διδάσκοντας τα AI assistants πώς να δουλεύουν μέσα στο framework.

Το όφελος για τα prompts είναι επίσης σημαντικό. Όταν ένα AI agent καταλαβαίνει τις συμβάσεις της αρχιτεκτονικής μέσω του tooling, ξοδεύεις λιγότερα tokens στο να εξηγήσεις context και περισσότερα στο να δημιουργήσεις αξία.

Τι Παραμένει Σταθερό

Κάτι καθησυχαστικό: πολλές αρχές καλής αρχιτεκτονικής δεν αλλάζουν ανεξάρτητα από το αν άνθρωπος ή AI διαβάζει τον κώδικα.

Simple > complex. Clear boundaries > tangled dependencies. Context matters. Αυτές οι αλήθειες ίσχυαν πριν την agentic era και θα ισχύουν μετά. Η διαφορά είναι ότι τώρα έχουμε μεγαλύτερο κίνητρο να τις εφαρμόζουμε πραγματικά—γιατί τα οφέλη επεκτείνονται και στους AI assistants μας.

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

Μπαίνουμε σε μια εποχή όπου η ανάπτυξη γίνεται σε συνεργασία με AI. Αυτό αλλάζει την εξίσωση για τις αρχιτεκτονικές αποφάσεις. Δεν πρόκειται πια μόνο για developer experience—πρόκειται και για agent experience.

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

Αν χτίζεις νέα projects ή σκέφτεσαι restructuring σε υπάρχοντα, αξίζει να το έχεις στο μυαλό σου. Τα εργαλεία που επιλέγουμε και οι αρχιτεκτονικές αποφάσεις που παίρνουμε θα καθορίσουν πόσο αποτελεσματικά μπορούν οι AI assistants να μας βοηθήσουν.

Η agentic era δεν έρχεται—είναι εδώ. Το ερώτημα είναι αν οι αρχιτεκτονικές μας είναι έτοιμες να την υποδεχτούν.

Ποιες αρχιτεκτονικές patterns έχεις βρει ότι δουλεύουν καλά με AI coding assistants; Γράψε τα σχόλιά σου—πάντα ενδιαφέρομαι να ακούσω πώς πλοηγείται ο καθένας σε αυτή την αλλαγή.