Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 7.47 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 7.47 KB
Raw

CLAUDE.md (Lietuvių)

🌐 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 · 🇱🇻 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

Visos projekto taisyklės pateiktos faile AGENTS.md — tai vienintelis tiesos šaltinis kiekvienam DI asistentui (architektūra, susitarimai, testavimas, kokybės patikros, git darbo eiga, 23 griežtosios taisyklės, su PII susijusios įžvalgos). Perskaitykite jį visą; projekto taisyklių čia iš naujo neįtraukite. Visa toliau pateikta informacija taikoma TIK Claude Code — tai AGENTS.md jau apibrėžtų taisyklių praktiniai patikslinimai.

Worktree izoliavimas — Claude Code specifika

Visas privalomas worktree protokolas (bazinės šakos patvirtinimas, kanoninis .claude/worktrees/ kelias, cp -al node_modules, išmontavimo taisyklės) pateiktas docs/ops/WORKTREE_ISOLATION.md (apibendrinta AGENTS.md → Git Workflow → "Worktree isolation"). Claude Code specifiniai punktai:

  • Patvirtinkite bazinę šaką su operatoriumi naudodami AskUserQuestion (Griežtoji taisyklė Nr. 19), nebent jis jau jums ją nurodė.
  • Pirmenybę teikite integruotajam EnterWorktree įrankiui — jis jau sukuria worktree katalogus .claude/worktrees/ kataloge (kanoninis kelias). Sukurkite worktree dokumentuota git worktree add komanda, tada iškvieskite EnterWorktree su atitinkamu path.

Saugumas tarp sesijų — Claude Code ypatumai

Griežtosios taisyklės Nr. 19, Nr. 21 ir Nr. 22 (faile AGENTS.md) reglamentuoja lygiagrečias sesijas. Praktiniai priminimai šiai vykdymo aplinkai:

  • Kiekvieno su git dirbančio pagalbinio agento užklausoje pažodžiui pakartokite draudimą naudoti git stash (Agent įrankis / darbo eigos scenarijai) — pagalbiniai agentai nepaveldi šio failo, o užfiksuotas stash incidento pasikartojimas įvyko būtent per pagalbinį agentą.
  • Prieš sujungdami ar išsiųsdami pakeitimus į bet kurį PR, kurio nesukūrėte šioje sesijoje, paleiskite git worktree list ir iš naujo patikrinkite gh pr view <N> --json state,headRefOid (griežtoji taisyklė Nr. 22b).
  • Kiekvienos sesijos pabaigoje pagrindinę darbinę kopiją palikite toje pačioje šakoje, kurioje ji buvo sesijos pradžioje.

Superpowers / planavimo artefaktai — kelių perrašymai

_tasks/ susitarimas apibrėžtas AGENTS.md → „Planavimo ir tyrimų artefaktai“. Su superpowers įgūdžiais pateikiamos numatytosios reikšmės, nukreipiančios į docs/… — šios numatytosios reikšmės čia yra perrašomos. Kai superpowers įgūdis paskelbia kelią, pavyzdžiui, „išsaugota į docs/superpowers/plans/…“, prieš įrašydami pakeiskite jį atitinkamu _tasks/… keliu:

Artefaktas (įgūdis) Numatytasis (NENAUDOTI) Vietoje jo išsaugoti čia
Planai (writing-plans) docs/superpowers/plans/ _tasks/superpowers/plans/YYYY-MM-DD-<feature>.md
Specifikacijos / dizainas (brainstorming) docs/superpowers/specs/ _tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md
Tyrimai (deep-research, ad-hoc) docs/research/ _tasks/research/…
Darbo perdavimai (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

Komituokite šiuos artefaktus _tasks/ saugykloje (git -C _tasks …), niekada ne pagrindinėje saugykloje.

Juodraščiai / laikinieji failai — naudokite _artifacts/, o ne /tmp

Šiame projekte perrašoma vykdymo aplinkos numatytoji sesijos juodraščių vieta (/tmp/claude-*/…). Laikinuosius / darbinius failus — eksportuotus duomenis, sugeneruotus zip archyvus, vienkartinius tarpinius rezultatus ir viską, ką kitu atveju įrašytumėte į /tmp — rašykite į /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/.

  • _artifacts/ yra šakninio lygmens _* kelias: jo git jau nepaiso (AGENTS.md → „Šakninio lygmens _* keliai“), jis egzistuoja tik diske ir niekada nėra sekamas.
  • Priežastis: laikant juodraštinius rezultatus projekte (o ne /tmp), operatoriui labai paprasta vienoje vietoje rasti ir ištrinti visus laikinuosius failus, užuot jų ieškojus trumpalaikiuose, konkrečioms sesijoms skirtuose /tmp kataloguose, kurie išnyksta arba kuriuose kaupiasi nesekami failai.
  • Nepainiokite šio katalogo su _tasks/ (griežtoji taisyklė Nr. 23, atskira privati git saugykla ilgalaikiams planams, specifikacijoms, tyrimams ir darbo perdavimams) — _artifacts/ skirtas tik vienkartiniams darbiniams failams; nieko iš čia nereikia išsaugoti ar versijuoti.

Žalia bazė prieš atidarant PR

Prieš sukurdami šaką ar atidarydami PR, atlikite žalios bazės patikrą (AGENTS.md → Git darbo eiga → „Žalios bazės patikra“; projekto įgūdžiuose ji nurodoma kaip .agents/skills/_shared/base-green.md). Jei PR atidaromas, kai bazinės šakos viršūnė yra raudona, jo apraše turi būti ⚠️ base-red inherited: #<issue>. Norėdami pašalinti susikaupusią raudoną būseną (bazinės šakos viršūnė + raudoni PR), naudokite /sweep-reds įgūdį.