Skip to content

CLAUDE.md

Latest commit

 

History

History
70 lines (52 loc) · 9.5 KB

CLAUDE.md

File metadata and controls

70 lines (52 loc) · 9.5 KB
Raw

CLAUDE.md (Ελληνικά)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

Όλοι οι κανόνες του έργου βρίσκονται στο AGENTS.md — η μοναδική πηγή αλήθειας για κάθε AI βοηθό (αρχιτεκτονική, συμβάσεις, δοκιμές, πύλες ποιότητας, ροή εργασίας git, οι 23 Σκληροί Κανόνες, μαθήματα PII). Διαβάστε το ολόκληρο· μην ξαναπροσθέτετε κανόνες έργου εδώ. Τα παρακάτω ισχύουν ΜΟΝΟ για το Claude Code — επιχειρησιακές βελτιώσεις κανόνων που ορίζονται ήδη στο AGENTS.md.

Απομόνωση Worktree — Ειδικά για Claude Code

Το πλήρες υποχρεωτικό πρωτόκολλο worktree (επιβεβαίωση βασικού κλάδου, κανονική διαδρομή .claude/worktrees/, cp -al node_modules, κανόνες αποσυναρμολόγησης) βρίσκεται στο AGENTS.md → Git Workflow → "Worktree isolation". Σημεία ειδικά για το Claude Code:

  • Επιβεβαιώστε τον βασικό κλάδο με τον χειριστή μέσω AskUserQuestion (Σκληρός Κανόνας #19) εκτός εάν σας το έχουν ήδη πει.
  • Προτιμήστε το εγγενές εργαλείο EnterWorktree — δημιουργεί ήδη worktrees κάτω από .claude/worktrees/ (η κανονική διαδρομή). Δημιουργήστε το worktree με την τεκμηριωμένη εντολή git worktree add, στη συνέχεια καλέστε το EnterWorktree με τη path του.

Ασφάλεια μεταξύ συνεδριών — Ειδικά για Claude Code

Οι Σκληροί Κανόνες #19/#21/#22 (στο AGENTS.md) διέπουν τις παράλληλες συνεδρίες. Επιχειρησιακές υπενθυμίσεις για αυτό το σύστημα:

  • Αναπαράγετε αυτολεξεί την απαγόρευση του git stash στην προτροπή κάθε υποπράκτορα που αγγίζει το git (εργαλείο Agent / σενάρια Workflow) — οι υποπράκτορες δεν κληρονομούν αυτό το αρχείο, και το καταγεγραμμένο επανάληψη του περιστατικού stash προήλθε από υποπράκτορα.
  • Πριν συγχωνεύσετε ή ωθήσετε σε οποιοδήποτε PR που δεν δημιουργήσατε σε αυτή τη συνεδρία, εκτελέστε git worktree list και ελέγξτε εκ νέου gh pr view <N> --json state,headRefOid (Σκληρός Κανόνας #22b).
  • Τερματίστε κάθε συνεδρία με το κύριο checkout στον κλάδο που ξεκίνησε.

Υπερδυνάμεις / τεχνουργήματα σχεδιασμού — παρακάμψεις διαδρομών

Η σύμβαση _tasks/ ορίζεται στο AGENTS.md → "Planning & Research Artifacts". Οι δεξιότητες υπερδυνάμεων αποστέλλονται με προεπιλογές που δείχνουν σε docs/… — αυτές οι προεπιλογές παρακάμπτονται εδώ. Όταν μια δεξιότητα υπερδυνάμεων ανακοινώνει μια διαδρομή όπως "αποθηκεύτηκε σε docs/superpowers/plans/…", ξαναγράψτε την στο αντίστοιχο _tasks/… πριν γράψετε:

Τεχνούργημα (δεξιότητα) Προεπιλογή (ΜΗΝ χρησιμοποιείτε) Αποθηκεύστε εδώ αντ' αυτού
Σχέδια (writing-plans) docs/superpowers/plans/ _tasks/superpowers/plans/YYYY-MM-DD-<feature>.md
Προδιαγραφές / σχεδιασμός (brainstorming) docs/superpowers/specs/ _tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md
Έρευνα (deep-research, ad-hoc) docs/research/ _tasks/research/…
Παραδόσεις (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

Δεσμεύστε αυτά τα τεχνουργήματα μέσα στο repo _tasks/ (git -C _tasks …), ποτέ στο κύριο repo.

Προσωρινά αρχεία / scratch — χρησιμοποιήστε _artifacts/, όχι /tmp

Αυτό το έργο παρακάμπτει το προεπιλεγμένο scratchpad συνεδρίας του συστήματος (/tmp/claude-*/…). Γράψτε προσωρινά/εργασιακά αρχεία — εξαγωγές, παραγόμενα zip, εφάπαξ ενδιάμεσες εξόδους, οτιδήποτε θα βάζατε αλλιώς στο /tmp — στο /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/ αντ' αυτού.

  • Το _artifacts/ είναι μια ριζική διαδρομή _*: ήδη αγνοείται από gitignore (AGENTS.md → "Root _* paths"), ζει μόνο στο δίσκο, δεν παρακολουθείται ποτέ.
  • Αιτιολογία: η διατήρηση της εξόδου scratch μέσα στο έργο (αντί για /tmp) κάνει τετριμμένη για τον χειριστή την εύρεση και διαγραφή όλων των προσωρινών σε ένα μέρος, αντί να κυνηγά σε εφήμερους συγκεκριμένους ανά συνεδρία /tmp καταλόγους που εξαφανίζονται ή συσσωρεύονται χωρίς παρακολούθηση.
  • Μην μπερδεύετε αυτό με το _tasks/ (Σκληρός Κανόνας #23, το δικό του ιδιωτικό git repo για ανθεκτικά σχέδια/προδιαγραφές/έρευνα/παραδόσεις) — το _artifacts/ είναι μόνο για αναλώσιμα εργασιακά αρχεία, τίποτα εδώ δεν χρειάζεται να επιβιώσει ή να εκδοθεί.

Πράσινη βάση πριν το άνοιγμα PRs

Πριν κόψετε έναν κλάδο ή ανοίξετε ένα PR, εκτελέστε τον έλεγχο base-green (AGENTS.md → Git Workflow → "Base-green check"· οι δεξιότητες έργου το αναφέρουν ως .agents/skills/_shared/base-green.md). Ένα PR που ανοίχτηκε ενώ η κορυφή της βάσης είναι κόκκινη πρέπει να φέρει ⚠️ base-red inherited: #<issue> στο σώμα του. Για να εκκαθαρίσετε μια συσσωρευμένη κόκκινη κατάσταση (κορυφή βάσης + κόκκινα PRs), χρησιμοποιήστε τη δεξιότητα /sweep-reds.