Μακροχρόνια ροή εργασίας αντιπροσώπου

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

Στόχοι

• Δώστε σε κάθε νέα συνεδρία έναν γρήγορο τρόπο για να ανακτήσετε το πλαίσιο
• Διατηρήστε την εργασία σταδιακά αντί να κάνετε μια μεγάλη αλλαγή
• Λάβετε μια σπασμένη τοπική γραμμή βάσης πριν προσθέσετε περισσότερο κώδικα
• Αφήστε ανθεκτικά αντικείμενα που μπορεί να εμπιστευτεί η επόμενη συνεδρία

Πού να κρατήσει το κράτος

• Χρησιμοποιήστε το docs/agent-runs/<slug>/ όταν οι άνθρωποι, τα ρομπότ κριτικής ή πολλές αλυσίδες εργαλείων χρειάζονται την ίδια κατάσταση εργασιών.
• Χρησιμοποιήστε έναν τοπικό κατάλογο εργαλείου, όπως ο .codex/runs/<slug>/, μόνο όταν η κατάσταση εργασίας είναι σκόπιμα τοπική σε έναν σταθμό εργασίας ή μια αλυσίδα εργαλείων.
• Μην αποκρύπτετε την κοινή κατάσταση πολλών περιόδων σύνδεσης σε ένα ιδιωτικό αρχείο scratch, εάν κάποιος άλλος συνεργάτης ή εκπρόσωπος θα το χρειαστεί αργότερα.

Απαιτούμενα Αρχεία

Δημιουργήστε αυτά τα αρχεία στην αρχή της μακροχρόνιας εργασίας:

• feature-list.json
• progress.md

Χρησιμοποιήστε τα πρότυπα στα docs/agent-playbooks/templates/feature-list.template.json και docs/agent-playbooks/templates/progress.template.md.

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

Λίστα ελέγχου έναρξης συνεδρίας

1. Εκτελέστε το pwd.
2. Διαβάστε το progress.md.
3. Διαβάστε το feature-list.json.
4. Εκτελέστε το git log --oneline -20.
5. Εκτελέστε το ./scripts/agent-init.sh --smoke.
6. Επιλέξτε ακριβώς ένα στοιχείο υψηλότερης προτεραιότητας που εξακολουθεί να είναι το pending, το in_progress ή το blocked.

Εάν το βήμα καπνού αποτύχει, διορθώστε τη σπασμένη γραμμή βάσης πριν εφαρμόσετε ένα νέο τμήμα χαρακτηριστικών.

Κανόνες συνεδρίας

• Εργαστείτε σε ένα χαρακτηριστικό ή ένα τμήμα εργασίας τη φορά.
• Διατηρήστε τη λίστα χαρακτηριστικών ευανάγνωστη και σταθερή. Ενημερώστε την κατάσταση, τις σημειώσεις, τα αρχεία και τα πεδία επαλήθευσης αντί να ξαναγράψετε άσχετα στοιχεία.
• Επισημάνετε μόνο ένα στοιχείο που έχει επαληθευτεί μετά την εκτέλεση της εντολής ή της ροής χρήστη που αναφέρεται σε αυτό το στοιχείο.
• Χρησιμοποιήστε πράκτορες αναπαραγωγής για οριοθετημένες φέτες, όχι για τη συνολική ιδιοκτησία κατάστασης εργασιών.
• Όταν ένας θυγατρικός πράκτορας κατέχει ένα στοιχείο, δώστε του το ακριβές αναγνωριστικό στοιχείου, τα κριτήρια αποδοχής και τα αρχεία που μπορεί να αγγίξει.

Λίστα ελέγχου λήξης συνεδρίας

1. Προσθέστε μια σύντομη καταχώρηση προόδου στο progress.md.
2. Ενημερώστε το στοιχείο που αγγίξατε στο feature-list.json.
3. Καταγράψτε τις ακριβείς εντολές που εκτελούνται για επαλήθευση.
4. Καταγράψτε τους αποκλειστές, τις επόμενες ενέργειες και το επόμενο καλύτερο στοιχείο για συνέχιση.

Προτεινόμενο σχήμα εισαγωγής προόδου

Χρησιμοποιήστε μια σύντομη δομή όπως:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.