Skip to content

CLAUDE.md

Latest commit

 

History

History
74 lines (55 loc) · 7.15 KB

CLAUDE.md

File metadata and controls

74 lines (55 loc) · 7.15 KB
Raw

CLAUDE.md (Latviešu)

🌐 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 · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇮🇳 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

Visi projekta noteikumi atrodas AGENTS.md — tas ir vienīgais patiesības avots ikvienam AI asistentam (arhitektūrai, konvencijām, testēšanai, kvalitātes vārtejām, git darbplūsmai, 23 stingrajiem noteikumiem un PII atziņām). Izlasiet to pilnībā; nepievienojiet projekta noteikumus šeit atkārtoti. Viss tālāk minētais attiecas TIKAI uz Claude Code — tās ir jau AGENTS.md definēto noteikumu operatīvās precizēšanas.

Darba koka izolācija — Claude Code specifika

Pilns obligātais darba koka protokols (bāzes zara apstiprināšana, .claude/worktrees/ kanoniskais ceļš, cp -al node_modules, nojaukšanas noteikumi) ir aprakstīts AGENTS.md → Git darbplūsma → "Darba koka izolācija". Claude Code specifiskie punkti:

  • Apstipriniet bāzes zaru ar operatoru, izmantojot AskUserQuestion (stingrais noteikums Nr. 19), ja vien viņš to jau nav norādījis.
  • Dodiet priekšroku vietējam EnterWorktree rīkam — tas jau izveido darba kokus zem .claude/worktrees/ (kanoniskais ceļš). Izveidojiet darba koku ar dokumentēto git worktree add komandu, pēc tam izsauciet EnterWorktree, norādot tā path.

Drošība starp sesijām — Claude Code specifika

Stingrie noteikumi Nr. 19/21/22 (sadaļā AGENTS.md) regulē paralēlās sesijas. Operatīvie atgādinājumi šai videi:

  • Atkārtojiet git stash aizliegumu burtiski katra apakšaģenta uzvednē, kas mijiedarbojas ar git (Agent rīks / darbplūsmas skripti) — apakšaģenti šo failu nepārmanto, un reģistrētais incidenta atkārtošanās gadījums notika caur apakšaģentu.
  • Pirms sapludināšanas vai nosūtīšanas uz jebkuru PR, ko šajā sesijā neesat izveidojis, izpildiet git worktree list un atkārtoti pārbaudiet gh pr view <N> --json state,headRefOid (stingrais noteikums Nr. 22b).
  • Katru sesiju pabeidziet ar galveno checkout uz tā zara, kurā tā sākās.

Superpowers / plānošanas artefakti — ceļu pārrakstīšana

Konvencija _tasks/ ir definēta AGENTS.md → "Plānošanas un izpētes artefakti". Superpowers prasmes tiek piegādātas ar noklusējumiem, kas norāda uz docs/… — šie noklusējumi šeit tiek pārrakstīti. Kad Superpowers prasme paziņo par ceļu, piemēram, "saglabāts šeit: docs/superpowers/plans/…", pirms rakstīšanas pārrakstiet to uz atbilstošo _tasks/… ekvivalentu:

Artefakts (prasme) Noklusējums (NELIETOT) Saglabāt šeit
Plāni (writing-plans) docs/superpowers/plans/ _tasks/superpowers/plans/YYYY-MM-DD-<feature>.md
Specifikācijas / dizains (brainstorming) docs/superpowers/specs/ _tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md
Izpēte (deep-research, ad-hoc) docs/research/ _tasks/research/…
Nodošana (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

Iesniedziet šos artefaktus _tasks/ repozitorijā (git -C _tasks …), nekad galvenajā repozitorijā.

Melnraksti / pagaidu faili — izmantojiet _artifacts/, nevis /tmp

Šis projekts pārraksta vides noklusēto sesijas pagaidu vietu (/tmp/claude-*/…). Rakstiet pagaidu/darba failus — eksportus, ģenerētus zip arhīvus, vienreizējus starpposma failus un visu pārējo, ko citādi ievietotu /tmp — uz /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/ tā vietā.

  • _artifacts/ ir saknes _* ceļš: tas jau ir ignorēts ar git (AGENTS.md → "Saknes _* ceļi"), atrodas tikai diskā un nekad netiek izsekojams.
  • Iemesls: pagaidu izvades saglabāšana projektā (nevis /tmp) ļauj operatoram viegli atrast un izdzēst visu pagaidu saturu vienuviet, nevis meklēt pa īslaicīgām sesiju /tmp direktorijām, kas pazūd vai uzkrājas kā neizsekoti faili.
  • Nejauciet to ar _tasks/ (stingrais noteikums Nr. 23, tā ir atsevišķa privāta git repozitorija ilglaicīgiem plāniem/specifikācijām/izpētei/nodošanas materiāliem) — _artifacts/ ir paredzēts tikai vienreiz lietojamiem darba failiem; nekas tajā nav jāsaglabā vai jāversijē.

Bāzes stāvoklim jābūt zaļam pirms PR atvēršanas

Pirms zara izveides vai PR atvēršanas palaidiet bāzes stāvokļa pārbaudi (AGENTS.md → Git darbplūsma → "Bāzes stāvokļa pārbaude"; projekta prasmes uz to atsaucas kā uz .agents/skills/_shared/base-green.md). PR, kas atvērts, kamēr bāzes galapunkts ir sarkans, savā aprakstā ir jānorāda ⚠️ base-red inherited: #<issue>. Lai novērstu uzkrājušos sarkano stāvokli (bāzes galapunkts un sarkanie PR), izmantojiet prasmi /sweep-reds.