# Το AGENTS.md λέει στο Codex πώς να δουλέψει. Όχι τι υπάρχει εκεί.

Canonical source: https://maguyva.ai/el/for-codex

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).

Το AGENTS.md ορίζει τη συμφωνία εργασίας. Το MCP επιτρέπει στο Codex να χρησιμοποιεί εργαλεία. Το Maguyva είναι ο διακομιστής MCP που δίνει στο Codex έναν χάρτη του αποθετηρίου σας με δυνατότητα ερωτημάτων, ώστε η πρώτη επεξεργασία να μην είναι μαντεψιά για τη δομή των αρχείων.

> Το AGENTS.md είναι η συμφωνία. Το MCP είναι το κανάλι. Το Maguyva είναι ο χάρτης.

## Η στοίβα επιπέδων

Τέσσερις ιδέες. Η καθεμία κάνει μία δουλειά.

### AGENTS.md

Πώς πρέπει να συμπεριφέρεται το Codex σε αυτό το αποθετήριο.

### MCP

Πώς αποκτά το Codex πρόσβαση σε εξωτερικά εργαλεία και πλαίσιο.

### Maguyva

Ο διακομιστής MCP που επιστρέφει τεκμηριωμένα δεδομένα αποθετηρίου.

### Χώροι εργασίας, όχι χρήστες

Οι πράκτορες δεν επιβαρύνονται με χρεώσεις ανά χρήστη. [Δείτε τις τιμές](https://maguyva.ai/el/pricing)

## Το AGENTS.md είναι μια συμφωνία εργασίας. Χρησιμοποιήστε το.

Οι μόνιμες οδηγίες ανήκουν στο [`AGENTS.md`](https://developers.openai.com/codex/guides/agents-md). Είναι το σωστό μέρος για:

- Εντολές κατασκευής, δοκιμών και λίντινγκ που πρέπει να τρέχει το Codex.
- Κανόνες “πάντα κάνε X / ποτέ μην κάνεις Y” με εμβέλεια έναν φάκελο.
- Συμβάσεις ονοματοδοσίας και προτιμήσεις αναδιαμόρφωσης.
- Παραπομπές στα κανονικά αρχεία αποφάσεων και τις σημειώσεις αρχιτεκτονικής.

Κρατήστε το συνοπτικό. Δώστε του εμβέλεια. Κάντε υποβολή του.

Όμως το `AGENTS.md` δεν σχεδιάστηκε ποτέ για να είναι ένα ευρετήριο με δυνατότητα ερωτημάτων για κάθε σύμβολο, αρχείο και σημείο κλήσης στο αποθετήριό σας.

## Πού το AGENTS.md από μόνο του γίνεται στατικό σε μεγάλη κλίμακα

Τέσσερις τρόποι αστοχίας, ένας ανά κάρτα.

### // οι συμφωνίες δεν είναι ευρετήριο

Το να λέτε στο Codex *πώς να δουλέψει* δεν του λέει *τι υπάρχει*. Η πρώτη επεξεργασία σε ένα άγνωστο πακέτο είναι μαντεψιά για διαδρομές αρχείων και ονόματα συναρτήσεων. Το AGENTS.md δεν μπορεί να απαριθμήσει κάθε σύμβολο, και δεν θα το θέλατε ούτως ή άλλως.

### // το έγγραφο ξεπερνιέται από τον κώδικα

Ένα τμήμα του AGENTS.md που περιγράφει την τοπολογία της ουράς σας είναι σωστό μέχρι κάποιος να προσθέσει έναν νέο καταναλωτή. Ο κώδικας είναι πλέον η πηγή αλήθειας και το έγγραφο είναι με σιγουριά ξεπερασμένο. Το Codex διαβάζει το λάθος.

### // η μετονομασία είναι πρόβλημα γραφήματος

Το «Ποιος αναφέρεται σε αυτή την κλάση;» δεν απαντιέται από ένα αρχείο markdown. Το Codex είτε κάνει grep-και-εύχεται σε όλο το ενιαίο αποθετήριο, είτε σας ζητά να επικολλήσετε σημεία κλήσης στη συνομιλία.

### // τα παράθυρα πλαισίου δεν είναι δωρεάν

Το να παραγεμίζετε το AGENTS.md μέχρι το Codex να «ξέρει αρκετά» καταναλώνει τόκενς που θα έπρεπε να πληρώνουν τη συλλογιστική. Πέρα από λίγα KB, ανταλλάσσετε ποιότητα απάντησης με στατικό όγκο πλαισίου.

## Πώς ταιριάζουν τα τρία επίπεδα μεταξύ τους

Οι χρήστες του Codex ήδη σκέφτονται με αυτό το σχήμα. Η σελίδα πρέπει να το κάνει προφανές.

- **AGENTS.md**: συμφωνίες (πώς συμπεριφέρεται το Codex)
- **MCP**: το κανάλι (πώς αποκτά πρόσβαση)
- **Maguyva**: δεδομένα βάσης κώδικα (τι βλέπει)

- **AGENTS.md**: πώς συμπεριφέρεται το Codex σε αυτό το αποθετήριο.
- **MCP**: πώς αποκτά το Codex πρόσβαση σε εργαλεία και πλαίσιο. [(προδιαγραφή)](https://modelcontextprotocol.io/docs/getting-started/intro)
- **Maguyva**: τι βλέπει το Codex όταν κάνει μια ερώτηση στη βάση κώδικα. Σημασιολογική, AST, γραφήματος και αναζήτηση κειμένου, επιστρεφόμενες με διαδρομές αρχείων και αριθμούς γραμμών.

> Το AGENTS.md λέει στο Codex *πώς να δουλέψει*.
> Το Maguyva δίνει στο Codex *κάτι από το οποίο να ξεκινήσει*.

## Τρεις ροές εργασίας

Ειδικά για το Codex. Τεκμηριωμένο πάνω στο πραγματικό γράφημα κλήσεων, όχι στο grep του Codex.

### 01. Μετονομάστε μια κοινόχρηστη κλάση, βρείτε πρώτα κάθε εξαρτημένο στοιχείο

```text
codex> μετονόμασε το PaymentClient → BillingClient

graph::callers(PaymentClient)            12 αναφορές σε 7 πακέτα
graph::importers(src/payments/client.ts)  9 εισαγωγείς
graph::extends(PaymentClient)             2 υποκλάσεις (RetryClient, MockClient)

→ Το Codex προτείνει μια μετάβαση 21 επεξεργασιών με τη λίστα αρχείων ενσωματωμένη.
[exit 0]
```

Το Codex ζητά από το Maguyva τα εξαρτημένα στοιχεία *πριν* αρχίσει να επεξεργάζεται. Η λίστα μετάβασης επιστρέφει τεκμηριωμένη στο πραγματικό γράφημα, όχι στην ανάμνηση του Codex.

### 02. Βρείτε την πραγματική υλοποίηση, όχι την ψευδοϋλοποίηση δοκιμής

```text
codex> πώς χειρίζεται η 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
codex> τι καλεί το QueueDispatcher.publish;

graph::callers(QueueDispatcher.publish)
  3 σε src/billing/*    1 σε src/audit/*    1 σε src/notifications/*
[exit 0]
```

Τα διαπακετικά σημεία κλήσης αναδεικνύονται άμεσα. Η διαφορά είναι τεκμηριωμένη πάνω σε πραγματικούς εισαγωγείς, όχι στο grep του Codex.

## Ρύθμιση στο Codex CLI

Τρία βήματα. Επίπεδο Free: 3 αποθετήρια, Έως 50K ευρετηριασμένες γραμμές αποθετηρίου, χωρίς πιστωτική κάρτα.

### 01. Ευρετηριάστε ένα αποθετήριο στο maguyva.ai

Επιλέξτε ένα που γνωρίζετε καλά, ώστε να μπορείτε να επαληθεύσετε τις απαντήσεις.

### 02. Προσθέστε το Maguyva ως διακομιστή MCP στις ρυθμίσεις του Codex

`~/.codex/config.toml`

```text
export MAGUYVA_API_KEY=mgv_xxxx
codex mcp add maguyva --url https://maguyva.tools/mcp --bearer-token-env-var MAGUYVA_API_KEY
```

```toml
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
bearer_token_env_var = "MAGUYVA_API_KEY"
```

### 03. Κάντε μία ερώτηση της οποίας την απάντηση ήδη γνωρίζετε

Μην ξεκινήσετε με ολόκληρη την εταιρεία σας. Ξεκινήστε με ένα αποθετήριο και μία επαληθεύσιμη ερώτηση.

## Ευρετηριάστε ένα αποθετήριο που ήδη γνωρίζετε.

Συνδέστε το Codex μέσω MCP. Κάντε μία ερώτηση της οποίας την απάντηση μπορείτε να επαληθεύσετε.