Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 7.27 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 7.27 KB
Raw

CLAUDE.md (Polski)

🌐 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 · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇹 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

Wszystkie reguły projektu znajdują się w AGENTS.md — jedynym źródle prawdy dla każdego asystenta AI (architektura, konwencje, testowanie, bramki jakości, przepływ pracy z git, 23 Twarde Reguły, wnioski dotyczące PII). Przeczytaj go w całości; nie dodawaj tutaj ponownie reguł projektu. Wszystko poniżej dotyczy WYŁĄCZNIE Claude Code — są to operacyjne doprecyzowania reguł już zdefiniowanych w AGENTS.md.

Izolacja worktree — specyfika Claude Code

Pełny obowiązkowy protokół worktree (potwierdzenie gałęzi bazowej, kanoniczna ścieżka .claude/worktrees/, cp -al dla node_modules, zasady usuwania) znajduje się w docs/ops/WORKTREE_ISOLATION.md (streszczony w AGENTS.md → Git Workflow → "Worktree isolation"). Kwestie specyficzne dla Claude Code:

  • Potwierdź gałąź bazową z operatorem za pomocą AskUserQuestion (Hard Rule #19), chyba że już ci ją podał.
  • Preferuj natywne narzędzie EnterWorktree — tworzy ono worktree już w katalogu .claude/worktrees/ (kanoniczna ścieżka). Utwórz worktree udokumentowanym poleceniem git worktree add, a następnie wywołaj EnterWorktree z jego path.

Bezpieczeństwo między sesjami — szczegóły dotyczące Claude Code

Twarde Reguły #19/#21/#22 (w AGENTS.md) regulują sesje równoległe. Przypomnienia operacyjne dla tego środowiska:

  • Powiel dosłownie zakaz używania git stash w prompcie każdego subagenta, który korzysta z git (narzędzie Agent / skrypty przepływu pracy) — subagenci nie dziedziczą tego pliku, a odnotowane ponowne wystąpienie incydentu ze stash nastąpiło za pośrednictwem subagenta.
  • Przed scaleniem lub wypchnięciem zmian do dowolnego PR, którego nie utworzono w tej sesji, uruchom git worktree list i ponownie sprawdź gh pr view <N> --json state,headRefOid (Twarda Reguła #22b).
  • Zakończ każdą sesję z głównym checkoutem na gałęzi, na której się rozpoczęła.

Superpowers / artefakty planowania — nadpisania ścieżek

Konwencję _tasks/ zdefiniowano w AGENTS.md → „Planning & Research Artifacts”. Umiejętności superpowers są dostarczane z domyślnymi ustawieniami wskazującymi na docs/… — te ustawienia domyślne są tutaj nadpisane. Gdy umiejętność superpowers wskaże ścieżkę w rodzaju „zapisano w docs/superpowers/plans/…”, przed zapisem zamień ją na odpowiednik w _tasks/…:

Artefakt (umiejętność) Domyślna lokalizacja (NIE używać) Zapisuj zamiast tego tutaj
Plany (writing-plans) docs/superpowers/plans/ _tasks/superpowers/plans/YYYY-MM-DD-<feature>.md
Specyfikacje / projekt (brainstorming) docs/superpowers/specs/ _tasks/superpowers/specs/YYYY-MM-DD-<topic>-design.md
Badania (deep-research, ad-hoc) docs/research/ _tasks/research/…
Przekazania (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

Commituj te artefakty wewnątrz repozytorium _tasks/ (git -C _tasks …), nigdy w głównym repozytorium.

Pliki robocze / tymczasowe — używaj _artifacts/, a nie /tmp

Ten projekt nadpisuje domyślny notatnik roboczy sesji tego środowiska (/tmp/claude-*/…). Zapisuj pliki tymczasowe/robocze — eksporty, wygenerowane archiwa zip, jednorazowe wyniki pośrednie i wszystko, co w przeciwnym razie trafiłoby do /tmp — w /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/.

  • _artifacts/ jest ścieżką główną _*: jest już ignorowana przez git (AGENTS.md → „Root _* paths”), istnieje wyłącznie na dysku i nigdy nie jest śledzona.
  • Powód: przechowywanie wyników roboczych wewnątrz projektu (zamiast w /tmp) pozwala operatorowi łatwo znaleźć i usunąć wszystkie pliki tymczasowe w jednym miejscu, zamiast szukać w efemerycznych, specyficznych dla sesji katalogach /tmp, które znikają lub gromadzą nieśledzone pliki.
  • Nie myl tego z _tasks/ (Twarda Reguła #23, osobne prywatne repozytorium git na trwałe plany/specyfikacje/badania/przekazania) — _artifacts/ służy wyłącznie do jednorazowych plików roboczych; nic tutaj nie musi przetrwać ani podlegać wersjonowaniu.

Zielona baza przed otwieraniem PR

Przed utworzeniem gałęzi lub otwarciem PR uruchom kontrolę zielonej bazy (AGENTS.md → Git Workflow → „Base-green check”; umiejętności projektu odwołują się do niej jako .agents/skills/_shared/base-green.md). PR otwarty, gdy końcówka bazy jest czerwona, musi zawierać w treści ⚠️ base-red inherited: #<issue>. Aby usunąć nagromadzony czerwony stan (końcówka bazy + czerwone PR), użyj umiejętności /sweep-reds.