# Το GEMINI.md λέει στο Gemini τους κανόνες σας. Όχι τον κώδικά σας. Canonical source: https://maguyva.ai/el/for-gemini License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). Το GEMINI.md ορίζει το πλαίσιο εργασίας. Το MCP επιτρέπει στο Gemini να χρησιμοποιεί εργαλεία. Το Maguyva είναι ο διακομιστής MCP που δίνει στο Gemini έναν χάρτη του αποθετηρίου σας με δυνατότητα ερωτημάτων, ώστε η πρώτη επεξεργασία να μην είναι μαντεψιά για τη δομή των αρχείων. > Το GEMINI.md είναι το πλαίσιο. Το MCP είναι το κανάλι. Το Maguyva είναι ο χάρτης. ## Η στοίβα επιπέδων Τέσσερις ιδέες. Η καθεμία κάνει μία δουλειά. ### GEMINI.md Πώς πρέπει να συμπεριφέρεται το Gemini σε αυτό το αποθετήριο. ### MCP Πώς αποκτά το Gemini πρόσβαση σε εξωτερικά εργαλεία και πλαίσιο. ### Maguyva Ο διακομιστής MCP που επιστρέφει τεκμηριωμένα δεδομένα αποθετηρίου. ### Χώροι εργασίας, όχι χρήστες Οι πράκτορες δεν επιβαρύνονται με χρεώσεις ανά χρήστη. [Δείτε τις τιμές](https://maguyva.ai/el/pricing) ## Το GEMINI.md είναι πλαίσιο εργασίας. Χρησιμοποιήστε το. Οι μόνιμες οδηγίες ανήκουν στο `GEMINI.md`. Είναι το σωστό μέρος για: - Εντολές κατασκευής, δοκιμών και λίντινγκ που πρέπει να τρέχει το Gemini. - Κανόνες “πάντα κάνε X / ποτέ μην κάνεις Y” με εμβέλεια έναν φάκελο. - Συμβάσεις ονοματοδοσίας και προτιμήσεις αναδιαμόρφωσης. - Παραπομπές στα κανονικά αρχεία αποφάσεων και τις σημειώσεις αρχιτεκτονικής. Κρατήστε το συνοπτικό. Δώστε του εμβέλεια. Κάντε υποβολή του. Όμως το `GEMINI.md` δεν σχεδιάστηκε ποτέ για να είναι ένα ευρετήριο με δυνατότητα ερωτημάτων για κάθε σύμβολο, αρχείο και σημείο κλήσης στο αποθετήριό σας. ## Πού το GEMINI.md από μόνο του δεν αρκεί πια Τέσσερις τρόποι αστοχίας, ένας ανά κάρτα. ### // το πλαίσιο δεν είναι ευρετήριο Το να λέτε στο Gemini *πώς να δουλέψει* δεν του λέει *τι υπάρχει*. Η πρώτη επεξεργασία σε ένα άγνωστο πακέτο είναι μαντεψιά για διαδρομές αρχείων και ονόματα συναρτήσεων. Το GEMINI.md δεν μπορεί να απαριθμήσει κάθε σύμβολο, και δεν θα το θέλατε ούτως ή άλλως. ### // το έγγραφο ξεπερνιέται από τον κώδικα Ένα τμήμα του GEMINI.md που περιγράφει την τοπολογία της ουράς σας είναι σωστό μέχρι κάποιος να προσθέσει έναν νέο καταναλωτή. Ο κώδικας είναι πλέον η πηγή αλήθειας και το έγγραφο είναι με σιγουριά ξεπερασμένο. Το Gemini διαβάζει το λάθος. ### // η μετονομασία είναι πρόβλημα γραφήματος Το «Ποιος αναφέρεται σε αυτή την κλάση;» δεν απαντιέται από ένα αρχείο markdown. Το Gemini είτε κάνει grep-και-εύχεται σε όλο το ενιαίο αποθετήριο, είτε σας ζητά να επικολλήσετε σημεία κλήσης στη συνομιλία. ### // τα παράθυρα πλαισίου δεν είναι δωρεάν Ένα μεγάλο παράθυρο δεν είναι το ίδιο με ένα ευρετήριο με δυνατότητα ερωτημάτων. Το να φορτώνετε το GEMINI.md μέχρι το Gemini να «ξέρει αρκετά» εξακολουθεί να ανταλλάσσει προϋπολογισμό συλλογιστικής με στατικό όγκο πλαισίου. ## Πώς ταιριάζουν τα τρία επίπεδα μεταξύ τους Οι χρήστες του Gemini ήδη σκέφτονται με αυτό το σχήμα. Η σελίδα πρέπει να το κάνει προφανές. - **GEMINI.md**: πλαίσιο (πώς συμπεριφέρεται το Gemini) - **MCP**: το κανάλι (πώς αποκτά πρόσβαση) - **Maguyva**: δεδομένα βάσης κώδικα (τι βλέπει) - **GEMINI.md**: πώς συμπεριφέρεται το Gemini σε αυτό το αποθετήριο. - **MCP**: πώς αποκτά το Gemini πρόσβαση σε εργαλεία και πλαίσιο. [(προδιαγραφή)](https://modelcontextprotocol.io/docs/getting-started/intro) - **Maguyva**: τι βλέπει το Gemini όταν κάνει μια ερώτηση στη βάση κώδικα. Σημασιολογική, AST, γραφήματος και αναζήτηση κειμένου, επιστρεφόμενες με διαδρομές αρχείων και αριθμούς γραμμών. > Το GEMINI.md λέει στο Gemini *πώς να δουλέψει*. > Το Maguyva δίνει στο Gemini *κάτι από το οποίο να ξεκινήσει*. ## Τρεις ροές εργασίας Ειδικά για το Gemini. Τεκμηριωμένο πάνω στο πραγματικό γράφημα κλήσεων, όχι στο grep του Gemini. ### 01. Μετονομάστε μια κοινόχρηστη κλάση, βρείτε πρώτα κάθε εξαρτημένο στοιχείο ```text gemini> μετονόμασε το PaymentClient → BillingClient graph::callers(PaymentClient) 12 αναφορές σε 7 πακέτα graph::importers(src/payments/client.ts) 9 εισαγωγείς graph::extends(PaymentClient) 2 υποκλάσεις (RetryClient, MockClient) → Το Gemini προτείνει μια μετάβαση 21 επεξεργασιών με τη λίστα αρχείων ενσωματωμένη. [exit 0] ``` Το Gemini ζητά από το Maguyva τα εξαρτημένα στοιχεία *πριν* αρχίσει να επεξεργάζεται. Η λίστα μετάβασης επιστρέφει τεκμηριωμένη στο πραγματικό γράφημα, όχι στην ανάμνηση του Gemini. ### 02. Βρείτε την πραγματική υλοποίηση, όχι την ψευδοϋλοποίηση δοκιμής ```text gemini> πώς χειρίζεται η normalizePhoneNumber το E.164; semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← πραγματική υλοποίηση test/util/phone.spec.ts:14 jest.mock(...) ← ψευδοϋλοποίηση [exit 0] ``` Τα ονόματα ψεύδονται. Τα ψευδο-αντικείμενα επισκιάζουν τον πραγματικό κώδικα. Το Maguyva κατατάσσει την πραγματική υλοποίηση πάνω από την ψευδοϋλοποίηση δοκιμής. ### 03. Ελέγξτε την ακτίνα επίδρασης πριν από μια αναδιαμόρφωση ```text gemini> τι καλεί το QueueDispatcher.publish; graph::callers(QueueDispatcher.publish) 3 σε src/billing/* 1 σε src/audit/* 1 σε src/notifications/* [exit 0] ``` Τα διαπακετικά σημεία κλήσης αναδεικνύονται άμεσα. Η διαφορά είναι τεκμηριωμένη πάνω σε πραγματικούς εισαγωγείς, όχι στο grep του Gemini. ## Ρύθμιση στο Gemini CLI Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα. ### 01. Ευρετηριάστε ένα αποθετήριο στο maguyva.ai Επιλέξτε ένα που γνωρίζετε καλά, ώστε να μπορείτε να επαληθεύσετε τις απαντήσεις. ### 02. Προσθέστε το Maguyva ως διακομιστή MCP στις ρυθμίσεις του Gemini CLI `~/.gemini/settings.json` ```json { "mcpServers": { "maguyva": { "httpUrl": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer ${MAGUYVA_API_KEY}" } } } } ``` ### 03. Κάντε μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε Μην ξεκινήσετε με ολόκληρη την εταιρεία σας. Ξεκινήστε με ένα αποθετήριο και μία επαληθεύσιμη ερώτηση. ## Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε. Συνδέστε το Gemini μέσω MCP. Κάντε μία ερώτηση της οποίας την απάντηση μπορείτε να επαληθεύσετε.