Το AGENTS.md είναι η είσοδος
Κάθε πακέτο, δέντρο αρχείων ή προφίλ βάσης δεδομένων ξεκινά με ένα AGENTS.md στη ρίζα. Ονομάζει τη Διάσταση, την αρμοδιότητά της, τις πολιτικές της και τη διαδικασία του Composer.
Ο κόσμος σας παίρνει
ό,τι χρειάζεται.
Μια Διάσταση δεν ξεκινά με ένα ράφι μετα-μοντέλων επιλεγμένων εκ των προτέρων. Ξεκινά με ένα αρχείο. Καθώς προχωρά η δουλειά, ο πράκτορας που διαβάζει αυτό το αρχείο εντοπίζει τι δεν μπορεί ακόμη να περιγράψει ο κόσμος, βρίσκει την προδιαγραφή που το καλύπτει, σας ρωτά και την εγκαθιστά σε καρφιτσωμένη έκδοση.
Πώς λειτουργεί
Η ανάγκη εντοπίζεται, δεν προγραμματίζεται
Ο πράκτορας παρακολουθεί όρους που δεν χωρούν στα εγκατεστημένα μοντέλα και αναφορές που δείχνουν εκτός τους. Και τα δύο είναι σήματα ζήτησης.
Εσείς εγκρίνετε
Ο πράκτορας προτείνει ένα συγκεκριμένο μοντέλο σε συγκεκριμένη έκδοση, εξηγεί τι απαντά και τι σέρνει μαζί του. Τίποτα δεν εγκαθίσταται χωρίς την έγκρισή σας.
Η εγκατάσταση καρφιτσώνεται
Η προδιαγραφή κατεβαίνει, επαληθεύεται το digest της, γράφεται στο meta-models/, προστίθεται στο vercy.lock και καταγράφεται στο μητρώο συμβάντων.
Τι δείχνει στον πράκτορα ότι χρειάζεται άλλο μοντέλο
Ένας ακάλυπτος όρος
Αναφέρετε μια οντότητα, απόφαση, συμβάν ή έγγραφο που δεν χωρά σε κανένα εγκατεστημένο μοντέλο. Ο Composer αντιπαραβάλλει τα λόγια σας με το λεξιλόγιο ενεργοποίησης που δημοσιεύει κάθε μοντέλο.
Μια μετέωρη αναφορά
Μια εγκατεστημένη προδιαγραφή δηλώνει τι σκόπιμα δεν περιέχει και πού βρίσκεται αυτό. Το να ακολουθήσεις τον δείκτη είναι φθηνότερο και ασφαλέστερο από το να διευρύνεις ένα μοντέλο πέρα από τον σκοπό του.
Ένα εύρημα χωρίς στέγη
Πριν γράψει, ο πράκτορας ελέγχει ότι η πληροφορία ανήκει σε μοντέλο που πράγματι διαθέτει. Αν όχι, επιλύει πρώτα αντί να της αυτοσχεδιάσει θέση.
Ένα κενό κάλυψης
Στην αρχή κάθε συνεδρίας ο πράκτορας συγκρίνει το μητρώο αντικειμένων με το εγκατεστημένο σύνολο, ώστε ένας κόσμος που ξεπέρασε τα μοντέλα του να το πει αντί να παρασυρθεί.
Τι ακριβώς εγκαθίσταται
Μια εγκατάσταση είναι τέσσερις εγγραφές και καμία έκπληξη: ο κατάλογος της προδιαγραφής με δικό του AGENTS.md, ξεχωριστό αρχείο σύνδεσης για αποθήκευση και διεπαφή, μια καρφιτσωμένη εγγραφή στο vercy.lock και μια εγγραφή στο μητρώο συμβάντων. Η μορφή και ο φορέας δεν μπαίνουν ποτέ στη λογική προδιαγραφή, ώστε το ίδιο μοντέλο να μπορεί αργότερα να μετακινηθεί από το Git σε βάση δεδομένων χωρίς να αλλάξει το νόημά του.
Ο Composer προτείνει. Ο ιδιοκτήτης αποφασίζει. An agent may read the catalogue freely, but it may not install, upgrade, replace or remove a specification without explicit approval, and it may never silently move a pinned version.
Σημεία πρόσβασης για μηχανές
/models/composer-index.json
/models/catalog-index.json
/models/<id>/spec.yaml
/models/<id>/AGENTS.md
/llms.txt
Το ευρετήριο επίλυσης δημοσιεύει, για κάθε μοντέλο: ταυτότητα και κανονικό σημασιολογικό όνομα, έκδοση, URL προδιαγραφής, digest, συμμόρφωση, το λεξιλόγιο ενεργοποίησης που το προτείνει και τις δηλωμένες αναφορές σε άλλα μοντέλα με το αναγνωριστικό καταλόγου στο οποίο επιλύεται καθεμία. Οι ανεπίλυτες αναφορές παραμένουν ορατές στο ευρετήριο αντί να απορρίπτονται, ώστε τα κενά του σώματος να παραμένουν ελέγξιμα.
Ξεκινήστε εδώ
Ο οδηγός πέντε βημάτων παράγει το Πακέτο Ιδιοκτήτη, μαζί με τη διαδικασία Composer που θα ακολουθεί από εκεί και πέρα ο πράκτοράς σας.