Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 11.7 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 11.7 KB
Raw

CLAUDE.md (ქართული)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇰🇭 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

პროექტის ყველა წესი თავმოყრილია AGENTS.md-ში — ეს არის ჭეშმარიტების ერთადერთი წყარო ყველა AI ასისტენტისთვის (არქიტექტურა, შეთანხმებები, ტესტირება, ხარისხის საკონტროლო ეტაპები, git-ის სამუშაო პროცესი, 23 მკაცრი წესი, PII-სთან დაკავშირებული მიგნებები). სრულად წაიკითხეთ; პროექტის წესები აქ ხელახლა არ დაამატოთ. ქვემოთ მოცემული ყველაფერი ვრცელდება მხოლოდ Claude Code-ზე — AGENTS.md-ში უკვე განსაზღვრული წესების საოპერაციო დაზუსტებები.

Worktree იზოლაცია — Claude Code-ის სპეციფიკა

სრული სავალდებულო worktree პროტოკოლი (საბაზო ბრენჩის დადასტურება, .claude/worktrees/ კანონიკური გზა, cp -al node_modules, დაშლის წესები) მოცემულია docs/ops/WORKTREE_ISOLATION.md-ში (შეჯამებულია AGENTS.md-ში → Git Workflow → "Worktree isolation"). Claude Code-ის სპეციფიკური პუნქტები:

  • დაადასტურეთ საბაზო ბრენჩი ოპერატორთან AskUserQuestion-ით (მკაცრი წესი #19), თუ მან უკვე არ გითხრათ.
  • უპირატესობა მიანიჭეთ ჩაშენებულ EnterWorktree ინსტრუმენტს — ის უკვე ქმნის worktree-ებს .claude/worktrees/-ქვეშ (კანონიკური გზა). შექმენით worktree დოკუმენტირებული git worktree add ბრძანებით, შემდეგ გამოიძახეთ EnterWorktree მისი path-ით.

სესიებს შორის უსაფრთხოება — Claude Code-ის სპეციფიკა

მკაცრი წესები #19/#21/#22 (AGENTS.md-ში) მართავს პარალელურ სესიებს. საოპერაციო შეხსენებები ამ გარემოსთვის:

  • სიტყვასიტყვით გაიმეორეთ git stash-ის აკრძალვა ყოველი იმ ქვეაგენტის prompt-ში, რომელიც git-ს ეხება (Agent tool / Workflow scripts) — ქვეაგენტები ამ ფაილს არ მემკვიდრეობენ, ხოლო stash-თან დაკავშირებული ინციდენტის დაფიქსირებული განმეორება სწორედ ქვეაგენტის მეშვეობით მოხდა.
  • ნებისმიერი PR-ის merge-მდე ან push-მდე, რომელიც ამ სესიაში არ შეგიქმნიათ, გაუშვით git worktree list და ხელახლა შეამოწმეთ gh pr view <N> --json state,headRefOid (მკაცრი წესი #22b).
  • ყოველი სესია დაასრულეთ ისე, რომ მთავარი checkout იმ branch-ზე იყოს, რომელზეც სესიის დასაწყისში იყო.

Superpowers / დაგეგმვის არტეფაქტები — path-ების ჩანაცვლებები

_tasks/-ის შეთანხმება განსაზღვრულია AGENTS.md → "Planning & Research Artifacts"-ში. superpowers-ის skills-ს მოჰყვება ნაგულისხმევი მნიშვნელობები, რომლებიც docs/…-ზე მიუთითებს — ეს ნაგულისხმევი მნიშვნელობები აქ ჩანაცვლებულია. როდესაც superpowers-ის skill აცხადებს path-ს, მაგალითად "შენახულია docs/superpowers/plans/…-ში", ჩაწერამდე ის _tasks/…-ის შესაბამისი ვარიანტით ჩაანაცვლეთ:

არტეფაქტი (skill) ნაგულისხმევი (არ გამოიყენოთ) ამის ნაცვლად შეინახეთ აქ
გეგმები (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>/

დააკომიტეთ ეს არტეფაქტები _tasks/ repo-ში (git -C _tasks …), არასოდეს — მთავარ repo-ში.

მონახაზი / დროებითი ფაილები — გამოიყენეთ _artifacts/, არა /tmp

ეს პროექტი ცვლის გარემოს სესიის მონახაზების ნაგულისხმევ ადგილს (/tmp/claude-*/…). დროებითი/სამუშაო ფაილები — exports, გენერირებული zip-ები, ერთჯერადი შუალედური შედეგები და ყველაფერი, რასაც სხვა შემთხვევაში /tmp-ში მოათავსებდით — ამის ნაცვლად ჩაწერეთ /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/-ში.

  • _artifacts/ არის root-ის _* path: ის უკვე gitignore-შია (AGENTS.md → "Root _* paths"), მხოლოდ დისკზე ინახება და არასოდეს ტრეკდება.
  • მიზეზი: მონახაზის შედეგების პროექტის შიგნით შენახვა (/tmp-ის ნაცვლად) ოპერატორს საშუალებას აძლევს მარტივად იპოვოს და ერთ ადგილას წაშალოს ყველაფერი დროებითი, ნაცვლად იმისა, რომ ეძებოს ეფემერულ, კონკრეტული სესიის /tmp დირექტორიებში, რომლებიც ქრება ან დაუტრეკავ ფაილებს აგროვებს.
  • ეს არ აგერიოთ _tasks/-ში (მკაცრი წესი #23, მისი საკუთარი private git repo მდგრადი გეგმებისთვის/სპეციფიკაციებისთვის/კვლევისთვის/გადაბარებებისთვის) — _artifacts/ განკუთვნილია მხოლოდ ერთჯერადი სამუშაო ფაილებისთვის და აქ არაფერს სჭირდება შენარჩუნება ან ვერსირება.

Base-green PR-ების გახსნამდე

Branch-ის შექმნამდე ან PR-ის გახსნამდე გაუშვით base-green შემოწმება (AGENTS.md → Git Workflow → "Base-green check"; პროექტის skills მას მოიხსენიებს, როგორც .agents/skills/_shared/base-green.md). თუ PR გახსნილია მაშინ, როცა base tip წითელია, მის body-ში უნდა ეწეროს ⚠️ base-red inherited: #<issue>. დაგროვილი წითელი მდგომარეობის (base tip + წითელი PR-ები) აღმოსაფხვრელად გამოიყენეთ /sweep-reds skill.