Skip to content

CLAUDE.md

Latest commit

 

History

History
75 lines (56 loc) · 9.52 KB

CLAUDE.md

File metadata and controls

75 lines (56 loc) · 9.52 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 · 🇬🇪 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 · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

@AGENTS.md

Усі правила проєкту містяться в AGENTS.md — єдиному джерелі істини для кожного ШІ-асистента (архітектура, домовленості, тестування, перевірки якості, робочий процес 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 → «Ізоляція worktree»). Специфічні для Claude Code моменти:

  • Підтвердьте базову гілку в оператора через AskUserQuestion (Жорстке правило №19), якщо він її ще не вказав.
  • Надавайте перевагу вбудованому інструменту EnterWorktree — він уже створює worktree в .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 на тій гілці, з якої він почався.

Superpowers / артефакти планування — перевизначення шляхів

Домовленість щодо _tasks/ визначено в AGENTS.md → "Planning & Research Artifacts". Навички superpowers постачаються зі стандартними значеннями, що вказують на docs/… — ці значення перевизначено тут. Коли навичка superpowers оголошує шлях на кшталт "saved to 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, ситуативні) docs/research/ _tasks/research/…
Передавання контексту (/handoff) — _tasks/hands-off/<YYYY-MM-DD>_<branch>_v<versão>_sess-<id>/

Комітьте ці артефакти всередині репозиторію _tasks/ (git -C _tasks …), а не в основному репозиторії.

Чернеткові / тимчасові файли — використовуйте _artifacts/, а не /tmp

Цей проєкт перевизначає стандартне місце для чернеток сеансу в середовищі (/tmp/claude-*/…). Записуйте тимчасові/робочі файли — експорти, згенеровані zip-архіви, одноразові проміжні результати, усе, що ви інакше помістили б у /tmp, — натомість у /home/diegosouzapw/dev/proxys/OmniRoute/_artifacts/.

  • _artifacts/ — це кореневий шлях _*: він уже ігнорується git (AGENTS.md → "Root _* paths"), існує лише на диску й ніколи не відстежується.
  • Причина: зберігання чернеткових результатів усередині проєкту (а не в /tmp) дає оператору змогу легко знайти й видалити все тимчасове в одному місці, замість пошуку в ефемерних каталогах /tmp для окремих сеансів, які зникають або накопичують невідстежувані файли.
  • Не плутайте це з _tasks/ (жорстке правило №23, окремий приватний git-репозиторій для довготривалих планів/специфікацій/досліджень/передавань контексту) — _artifacts/ призначений лише для одноразових робочих файлів; нічого тут не має зберігатися надовго чи версіонуватися.

Зелена база перед відкриттям PR

Перед створенням гілки або відкриттям PR виконайте перевірку зеленої бази (AGENTS.md → Git Workflow → "Base-green check"; навички проєкту посилаються на неї як на .agents/skills/_shared/base-green.md). PR, відкритий тоді, коли останній коміт бази червоний, повинен містити ⚠️ base-red inherited: #<issue> у своєму описі. Щоб усунути накопичений червоний стан (останній коміт бази + червоні PR), скористайтеся навичкою /sweep-reds.