Βαθμονόμηση των Agents

Γιατί το Vibe Coding Χρειάζεται Βαθμονομημένα Εργαλεία

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

Οι coding agents είναι το νέο εργαλείο στον πάγκο, και οι περισσότεροι τους χρησιμοποιούν αβαθμονόμητους. Χωρίς κανόνες έργου, ένας agent καταφεύγει στον μέσο όρο του διαδικτύου. Η συνεδρία της Δευτέρας αποθηκεύει τις ημερομηνίες ως κείμενο, της Τετάρτης ως timestamps. Ένα route ελέγχει την είσοδο, το επόμενο την εμπιστεύεται. Ένας κωδικός καταλήγει στο Git. Ένας developer βλέπει την απόκλιση. Ένας μη τεχνικός ιδρυτής δεν τη βλέπει, μέχρι ο πρώτος επαγγελματίας που θα προσλάβει να πει «από την αρχή».

Δύο Όργανα

Η βαθμονόμηση ζει μέσα στο repository, όχι σε ένα chat. Δύο είδη αρχείων κάνουν τη δουλειά:

• AGENTS.md στη ρίζα: τι είναι το έργο, πού βρίσκεται το καθετί, οι κανόνες που ισχύουν παντού. Οι περισσότεροι agents το διαβάζουν στην αρχή κάθε συνεδρίας.
• Skills, ένα SKILL.md ανά ρόλο (βάση δεδομένων, ασφάλεια, deploy). Ο agent φορτώνει ένα skill μόνο όταν η εργασία αγγίζει τη συγκεκριμένη περιοχή.

Ένα παράδειγμα για ένα site κρατήσεων ραντεβού σε φυσικοθεραπευτήριο:

## Conventions

- Store dates in UTC (ISO 8601). Show them in Europe/Athens.
- Validate every request body with Zod before other logic.
- Secrets are in `.env`. Do not commit or print them.
- Warn before you delete files, run a migration or deploy.
- After each change, run `bun test`. Report what passed and what you did not verify.

Και το τμήμα του έργου σε ένα skill db-engineer:

## Project Instructions

- SQLite through `bun:sqlite`. The file is `data/clinic.db`.
- Do not delete appointments. Set `cancelled_at`. The clinic needs the history for insurance claims.

Τώρα το αίτημα «άφησε τους ασθενείς να ακυρώνουν ένα ραντεβού» δίνει ένα POST route με έλεγχο εισόδου, soft delete και μια ερώτηση πριν από το migration. Χωρίς τα αρχεία, το αποτέλεσμα είναι συχνά ένα GET /cancel?id=42 που σβήνει τη γραμμή.

Συμβουλές

• Γράψε τους κανόνες σε ASD-STE100. Το Simplified Technical English φτιάχτηκε για τα εγχειρίδια συντήρησης αεροσκαφών: μία σημασία ανά λέξη, σύντομες προτάσεις, ενεργητική φωνή, μία οδηγία ανά πρόταση. Ένας agent ακολουθεί το «Do not delete appointments» πιο αξιόπιστα από μια παράγραφο που εξηγεί γιατί η διαγραφή είναι συνήθως κακή ιδέα. Γι' αυτό οι κανόνες μένουν στα αγγλικά.
• Όρισε όριο σε tokens. Κάθε token πληρώνεται σε κάθε αίτημα, και τα μεγάλα αρχεία διαβάζονται βιαστικά. Κρατάω το AGENTS.md κάτω από 1.024 tokens και κάθε skill κάτω από 512.
• Κοινές κεφαλίδες, μικρά overlays. Ένα skill έχει μια γενική κεφαλίδα (ίδια σε κάθε έργο) και περίπου έξι κουκκίδες για το έργο. Γράψε την κεφαλίδα μία φορά, αντίγραψέ την παντού, μην την αλλάζεις επί τόπου.
• Γράψε τον έναν κανόνα που ξέρεις μόνο εσύ. Ένας κανονισμός, αρχεία που πρέπει να κρατάς, μια μορφή τιμολογίου. Είναι η πιο πολύτιμη γραμμή του κιτ.
• Βάλε τους κανόνες του σπιτιού μία φορά στο AGENTS.md. Χωρίς em-dashes, χωρίς emojis, μια λίστα με απαγορευμένα κλισέ, προειδοποίηση πριν από καταστροφικές ενέργειες. Μην τους επαναλαμβάνεις στα skills.
• Ζήτα από τον agent να λέει τι δεν επαλήθευσε. Ένα σιωπηλό κενό είναι χειρότερο από ένα γνωστό.
• Διόρθωσε το αρχείο, όχι το chat. Μια διόρθωση στο chat κρατάει μία συνεδρία. Μια διόρθωση στο AGENTS.md κρατάει όσο ζει το έργο.
• Έλεγχε για απόκλιση. Κρατάω τις κοινές κεφαλίδες σε ένα repository agents με ένα script που αναφέρει τα αρχεία πάνω από το όριο και τις κεφαλίδες που διαφέρουν από την πηγή. Αυτό είναι το αυτοκόλλητο της βαθμονόμησης.

Η Βαθμονόμηση Είναι η Παράδοση

Ένας επαγγελματίας που αναλαμβάνει ένα έργο περνάει την πρώτη εβδομάδα ψάχνοντας ποιες συμβάσεις υπάρχουν και ποιες είναι τυχαίες. Ένα βαθμονομημένο έργο το απαντά από την πρώτη μέρα. Το stack, η δομή και οι κανόνες βρίσκονται στο AGENTS.md και σε λίγα σύντομα αρχεία skills, και ο κώδικας γράφτηκε με βάση αυτά, άρα είναι συνεπής.

Ένας μη τεχνικός ιδρυτής δεν χρειάζεται να ξέρει κάθε κανόνα. Χρειάζεται οι κανόνες να υπάρχουν πριν από τον κώδικα. Μία ώρα με έναν developer για να γραφτούν το AGENTS.md και λίγα skills κοστίζει λιγότερο από το ξαναγράψιμο.