# Κανόνες εγγραφής

*Το Vercy για πράκτορες ΤΝ · ενότητα 2 από 4 · ~12 λεπτά*

## Τι θα μάθετε

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

## Η πρώτη εντολή: γράψτε στον κύριο

Πριν από οποιαδήποτε εγγραφή, βρείτε το σύνολο δεδομένων στο `sources.yaml`:

- **Κύριος το μοντέλο** → επεξεργαστείτε την εγγραφή επιτόπου, ακολουθώντας τις συμβάσεις του μοντέλου (ονοματοδοσία, front matter, `kind_class`), και σημειώστε τίμια την παραγωγή αν φτιάξατε περιεχόμενο από πηγές.
- **Κύριος εξωτερικός** → η διόρθωση ανήκει στο εξωτερικό σύστημα. Αν δεν το φτάνετε, δώστε τη διόρθωση σε κάποιον που το φτάνει, ή καταγράψτε την ως σαφώς σημασμένο σχόλιο με κύριο το μοντέλο *σχετικά με* το κάτοπτρο. Μην επεξεργάζεστε ποτέ τα byte του κατόπτρου: η ευκολία δεν είναι αρμοδιότητα.

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

## Σεβαστείτε τις προελεύσεις

- Μην επεξεργάζεστε ποτέ με το χέρι το `raw/` (το τεκμήριο χάνει την αξία του μόλις το αγγίξεις) ούτε το `artifacts/` (η αναπαραγωγή θα σας σβήσει).
- Μη "βελτιώνετε" ποτέ γεγονότα κατά τη συλλογή: οι μετασχηματισμοί αναδιαρθρώνουν· ο εμπλουτισμός είναι ξεχωριστό επίπεδο με κύριο το μοντέλο και με δική του προέλευση.
- Αν μια παραγόμενη προβολή είναι λάθος, διορθώστε τη γεννήτρια ή τις εγγραφές-πηγές και μετά αναπαραγάγετε.

## Αφήστε τη διαδρομή πράσινη

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

Η ίδια πειθαρχία για τα μητρώα: νέο σύνολο δεδομένων, αλλαγμένος αγωγός, αλλαγμένη κυριότητα → το `sources.yaml` ενημερώνεται στην ίδια αλλαγή. Οι αλλαγές κυριότητας είναι εκδόσιμα συμβάντα, όχι σιωπηλές επεξεργασίες.

## Κλείστε τον κύκλο στις προβολές

Αν το μοντέλο τροφοδοτεί προβολές εγγραφής προς τα πίσω (έναν ιστότοπο, μια σελίδα wiki, ένα endpoint γεγονότων), η επεξεργασία σας μπορεί να τις άφησε μπαγιάτικες. Τρέξτε τον έλεγχο απόκλισης του μοντέλου· αναδημοσιεύστε αν αναφέρει απόκλιση. Σε ώριμες εγκαταστάσεις ένας προγραμματισμένος επόπτης ειδοποιεί άνθρωπο ούτως ή άλλως: η δουλειά σας είναι να μη βασίζεστε σε αυτόν.

## Πότε να αρνηθείτε

Ένας συμμορφούμενος πράκτορας αρνείται την εγγραφή, και λέει γιατί, όταν:

- ο κύριος του συνόλου δεδομένων δεν προσδιορίζεται (εγγραφή μητρώου απούσα ή διφορούμενη)·
- του ζητείται να επεξεργαστεί επιτόπου κάτοπτρο, ακατέργαστη αποτύπωση ή παραγόμενο τεκμήριο·
- του ζητείται να κρύψει περιεχόμενο από την ταξινόμηση ή να παρακάμψει τη διαδρομή·
- ο έλεγχος κάλυψης αποτυγχάνει και η ζητούμενη αλλαγή στηρίζεται στην αταξινόμητη περιοχή·
- ο κανόνας σύγκρουσης ενός συνόλου δεδομένων απαγορεύει τη γνωστοποίηση ή την αλλαγή (ιδιόκτητο, ποτέ δημοσίευση).

Η διατύπωση του προτύπου είναι κοφτή: *πράκτορας που δεν μπορεί να πει τι του επιτρέπεται να επεξεργαστεί δεν πρέπει να επεξεργάζεται*. Η άρνηση με αιτιολόγηση είναι χαρακτηριστικό· η εναλλακτική είναι δύο αλήθειες με το όνομά σας στο commit.

## Εθιμοτυπία σε μεικτές ομάδες

- Προτιμήστε να προσθέσετε εγγραφή αντί να ξαναγράψετε κάποια· κρατήστε σταθερά τα αναγνωριστικά εγγραφών.
- Η γνώση για τη δομή και την αρμοδιότητα πηγαίνει στο BOOTSTRAP, στο manifest και στο μητρώο, όχι σε logs συνομιλίας.
- Η παράγωγη εργασία φέρει προέλευση: από τι, με ποιο εργαλείο, πότε: από αυτό εξαρτάται ο μηχανισμός εμπιστοσύνης του μοντέλου (κατάσταση επικύρωσης, έλεγχος ιδιοκτήτη).
- Παραδώστε πράσινο: μην τελειώνετε ποτέ μια συνεδρία με κόκκινη διαδρομή ή με μητρώο που δεν λέει την αλήθεια.

## Βασικά σημεία

- Βρείτε τον κύριο και γράψτε μόνο εκεί· σεβαστείτε τα όρια συγγραφικού, συλλεγμένου και παραγόμενου.
- Οι δομικές αλλαγές και οι ενημερώσεις μητρώου ταξιδεύουν στην ίδια αλλαγή· η διαδρομή μένει πράσινη.
- Η άρνηση μιας μη ασφαλούς εγγραφής, με την αιτία, είναι συμμορφούμενη συμπεριφορά, όχι αποτυχία.

## Πηγαίνετε βαθύτερα

- [Λειτουργίες πράκτορα: συνταγές και αρνήσεις](/spec/#07-guides/Agent-Operations.md)
- [Κυριότητα δεδομένων (ARCH-018)](/spec/#02-architecture/Data-Mastership.md)

Επόμενο: [Ο κόμβος για μηχανές](03-machine-hub.md)