diff --git a/uk/CLAUDE.md b/uk/CLAUDE.md new file mode 100644 index 0000000..fbdd141 --- /dev/null +++ b/uk/CLAUDE.md @@ -0,0 +1,161 @@ + + + + +# CLAUDE.md + +Цей файл надає настанови для Claude Code (claude.ai/code) при роботі з кодом у цьому репозиторії. + +## Огляд проєкту + +Claude How To — це навчальний репозиторій з функцій Claude Code. Це **документація-як-код** — основний продукт — markdown-файли, організовані в пронумеровані навчальні модулі, а не виконуваний додаток. + +**Архітектура**: Кожен модуль (01-10) охоплює конкретну функцію Claude Code з готовими шаблонами для копіювання, Mermaid-діаграмами та прикладами. Система збірки валідує якість документації та генерує EPUB-книгу. + +## Типові команди + +### Перевірки якості pre-commit + +Уся документація повинна пройти чотири перевірки якості перед комітами (запускаються автоматично через pre-commit хуки): + +```bash +# Install pre-commit hooks (runs on every commit) +pre-commit install + +# Run all checks manually +pre-commit run --all-files +``` + +П'ять перевірок: +1. **markdown-lint** — Структура та форматування Markdown через `markdownlint` +2. **cross-references** — Внутрішні посилання, якорі, синтаксис блоків коду (Python-скрипт) +3. **mermaid-syntax** — Валідація коректного парсингу всіх Mermaid-діаграм (Python-скрипт) +4. **link-check** — Доступність зовнішніх URL (Python-скрипт) +5. **build-epub** — EPUB генерується без помилок (при змінах `.md`) + +### Налаштування середовища розробки + +```bash +# Install uv (Python package manager) +pip install uv + +# Create virtual environment and install Python dependencies +uv venv +source .venv/bin/activate +uv pip install -r scripts/requirements-dev.txt + +# Install Node.js tools (markdown linter and Mermaid validator) +npm install -g markdownlint-cli +npm install -g @mermaid-js/mermaid-cli + +# Install pre-commit hooks +uv pip install pre-commit +pre-commit install +``` + +### Тестування + +Python-скрипти в `scripts/` мають юніт-тести: + +```bash +# Run all tests +pytest scripts/tests/ -v + +# Run with coverage +pytest scripts/tests/ -v --cov=scripts --cov-report=html + +# Run specific test +pytest scripts/tests/test_build_epub.py -v +``` + +### Якість коду + +```bash +# Lint and format Python code +ruff check scripts/ +ruff format scripts/ + +# Security scan +bandit -c scripts/pyproject.toml -r scripts/ --exclude scripts/tests/ + +# Type checking +mypy scripts/ --ignore-missing-imports +``` + +### Збірка EPUB + +```bash +# Generate ebook (renders Mermaid diagrams via Kroki.io API) +uv run scripts/build_epub.py + +# With options +uv run scripts/build_epub.py --verbose --output custom-name.epub --max-concurrent 5 +``` + +## Структура каталогів + +``` +├── 01-slash-commands/ # Ярлики, ініційовані користувачем +├── 02-memory/ # Приклади постійного контексту +├── 03-skills/ # Повторно використовувані можливості +├── 04-subagents/ # Спеціалізовані AI-асистенти +├── 05-mcp/ # Приклади Model Context Protocol +├── 06-hooks/ # Автоматизація на основі подій +├── 07-plugins/ # Пакетні функції +├── 08-checkpoints/ # Знімки сесій +├── 09-advanced-features/ # Планування, мислення, фони +├── 10-cli/ # Довідник CLI +├── scripts/ +│ ├── build_epub.py # Генератор EPUB (рендерить Mermaid через Kroki API) +│ ├── check_cross_references.py # Валідація внутрішніх посилань +│ ├── check_links.py # Перевірка зовнішніх URL +│ ├── check_mermaid.py # Валідація синтаксису Mermaid +│ └── tests/ # Юніт-тести для скриптів +├── .pre-commit-config.yaml # Визначення перевірок якості +└── README.md # Основний довідник (також індекс модулів) +``` + +## Настанови щодо контенту + +### Структура модуля +Кожна пронумерована папка дотримується патерну: +- **README.md** — Огляд функції з прикладами +- **Файли прикладів** — Готові шаблони для копіювання (`.md` для команд, `.json` для конфігурацій, `.sh` для хуків) +- Файли організовані за складністю функцій та залежностями + +### Mermaid-діаграми +- Усі діаграми повинні успішно парситися (перевіряється pre-commit хуком) +- Збірка EPUB рендерить діаграми через Kroki.io API (потрібен інтернет) +- Використовуйте Mermaid для блок-схем, діаграм послідовностей та архітектурних візуалізацій + +### Перехресні посилання +- Використовуйте відносні шляхи для внутрішніх посилань (напр., `(01-slash-commands/README.md)`) +- Блоки коду повинні вказувати мову (напр., ` ```bash `, ` ```python `) +- Якірні посилання використовують формат `#heading-name` + +### Валідація посилань +- Зовнішні URL повинні бути доступні (перевіряється pre-commit хуком) +- Уникайте посилань на тимчасовий контент +- Використовуйте пермалінки де можливо + +## Ключові архітектурні рішення + +1. **Пронумеровані папки вказують порядок навчання** — Префікс 01-10 відображає рекомендовану послідовність вивчення функцій Claude Code. Ця нумерація навмисна; не реорганізовуйте за алфавітом. + +2. **Скрипти — утиліти, а не продукт** — Python-скрипти в `scripts/` підтримують якість документації та генерацію EPUB. Фактичний контент — у пронумерованих папках модулів. + +3. **Pre-commit — привратник** — Усі перевірки якості повинні пройти перед прийняттям PR. CI-конвеєр запускає ці ж перевірки як другий прохід. + +4. **Рендеринг Mermaid потребує мережі** — Збірка EPUB викликає Kroki.io API для рендерингу діаграм. Помилки збірки тут зазвичай пов'язані з мережею або невалідним синтаксисом Mermaid. + +5. **Це туторіал, а не бібліотека** — При додаванні контенту зосереджуйтесь на чітких поясненнях, готових прикладах та візуальних діаграмах. Цінність — у навчанні концепцій, а не у наданні повторно використовуваного коду. + +## Конвенції комітів + +Дотримуйтесь формату conventional commits: +- `feat(slash-commands): Add API documentation generator` +- `docs(memory): Improve personal preferences example` +- `fix(README): Correct table of contents link` +- `refactor(hooks): Simplify hook configuration examples` + +Скоуп повинен відповідати назві папки де можливо. diff --git a/uk/LICENSE b/uk/LICENSE new file mode 100644 index 0000000..cf8db6a --- /dev/null +++ b/uk/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2024 luongnv89 + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/uk/RELEASE_NOTES.md b/uk/RELEASE_NOTES.md new file mode 100644 index 0000000..0055ec6 --- /dev/null +++ b/uk/RELEASE_NOTES.md @@ -0,0 +1,11 @@ +## v2.2.0 — 2026-03-26 + +### Bug Fixes + +- Remove dead marketplace link failing CI link checks (3fdf0d6) +- Add `sandboxed` and `pycache` to cSpell dictionary (dc64618) + +**Full Changelog**: https://github.com/luongnv89/claude-howto/compare/v2.1.0...v2.1.1 + +--- +**Last Updated**: April 9, 2026 diff --git a/uk/claude-howto-logo.png b/uk/claude-howto-logo.png new file mode 100644 index 0000000..94d34a4 Binary files /dev/null and b/uk/claude-howto-logo.png differ diff --git a/uk/clean-code-rules.md b/uk/clean-code-rules.md new file mode 100644 index 0000000..1514691 --- /dev/null +++ b/uk/clean-code-rules.md @@ -0,0 +1,115 @@ + + + + +# Правила чистого коду для AI-генерації коду + +Ці правила спрямовують генерацію коду для створення підтримуваного, професійної якості коду. + +## Змістовні назви +- Використовуйте назви, що розкривають намір та пояснюють чому щось існує +- Уникайте дезінформації та безглуздих розрізнень (напр., `data`, `info`, `manager`) +- Використовуйте вимовні, такі що легко шукаються назви +- Назви класів: іменники (напр., `UserAccount`, `PaymentProcessor`) +- Назви методів: дієслова (напр., `calculateTotal`, `sendEmail`) +- Уникайте ментального маппінгу та кодувань (Угорська нотація, префікси) + +## Функції +- Тримайте функції маленькими (< 20 рядків ідеально) +- Робіть лише одну річ — Принцип єдиної відповідальності +- Один рівень абстракції на функцію +- Обмежуйте аргументи: 0-2 ідеально, 3 максимум, уникайте аргументів-прапорців +- Без побічних ефектів — функція повинна робити те, що каже її назва +- Розділяйте команди (зміна стану) від запитів (повернення інформації) +- Надавайте перевагу виключенням над кодами помилок + +## Коментарі +- Код повинен бути самопояснювальним — уникайте коментарів коли можливо +- Корисні коментарі: юридична інформація, попередження, TODO, документація публічного API +- Погані коментарі: надлишкові, що вводять в оману, або пояснюють поганий код +- Ніколи не коментуйте код — видаляйте його (система контролю версій зберігає історію) +- Якщо потрібен коментар, подумайте про рефакторинг коду + +## Форматування +- Тримайте файли маленькими та зосередженими +- Вертикальне форматування: пов'язані концепції поруч, порожні рядки розділяють концепції +- Горизонтальне форматування: обмежуйте довжину рядка (80-120 символів) +- Використовуйте консистентні відступи та командний стиль +- Групуйте пов'язані функції разом + +## Об'єкти та структури даних +- Об'єкти: ховають дані за абстракціями, відкривають поведінку через методи +- Структури даних: відкривають дані, мають мінімальну поведінку +- Закон Деметри: спілкуйтесь тільки з безпосередніми друзями, уникайте `a.getB().getC().doSomething()` +- Не відкривайте внутрішню структуру через геттери/сеттери наосліп + +## Обробка помилок +- Використовуйте виключення, а не коди повернення або прапорці помилок +- Пишіть `try-catch-finally` першим, коли код може не виконатись +- Надавайте контекст у повідомленнях виключень +- Не повертайте `null` — повертайте порожні колекції або використовуйте Optional/Maybe +- Не передавайте `null` як аргументи + +## Класи +- Маленькі класи: вимірюються відповідальностями, а не рядками +- Принцип єдиної відповідальності: одна причина для зміни +- Висока зв'язність (cohesion): змінні класу використовуються багатьма методами +- Низька зв'язаність (coupling): мінімальні залежності між класами +- Принцип відкритості/закритості: відкритий для розширення, закритий для модифікації + +## Юніт-тести +- Швидкі, Незалежні, Повторювані, Самоперевіряючі, Своєчасні (F.I.R.S.T.) +- Один assert на тест (або одна концепція) +- Якість тестового коду дорівнює якості продакшен-коду +- Читабельні назви тестів, що описують що тестується +- Патерн Arrange-Act-Assert + +## Принципи якості коду +- **DRY (Don't Repeat Yourself)**: Без дублювання +- **YAGNI (You Aren't Gonna Need It)**: Не будуйте для гіпотетичного майбутнього +- **KISS (Keep It Simple)**: Уникайте зайвої складності +- **Правило скаута**: Залишайте код чистішим, ніж ви його знайшли + +## Code Smells, яких варто уникати +- Довгі функції або класи +- Дублювання коду +- Мертвий код (невикористані змінні, функції, параметри) +- Feature envy (метод більше цікавиться іншим класом) +- Inappropriate intimacy (класи знають занадто багато один про одного) +- Довгі списки параметрів +- Primitive obsession (надмірне використання примітивів замість маленьких об'єктів) +- Switch/case (розгляньте поліморфізм) +- Тимчасові поля (змінні класу використовуються лише іноді) + +## Конкурентність +- Тримайте конкурентний код окремо від іншого коду +- Обмежуйте область синхронізованих/заблокованих даних +- Використовуйте потокобезпечні колекції +- Тримайте синхронізовані секції маленькими +- Знайте свої моделі виконання та примітиви + +## Проєктування систем +- Відокремлюйте конструювання від використання (впровадження залежностей) +- Використовуйте фабрики, будівельники для складного створення об'єктів +- Програмуйте на інтерфейси, а не на реалізації +- Надавайте перевагу композиції над успадкуванням +- Застосовуйте патерни проєктування коли вони спрощують, а не для демонстрації + +## Рефакторинг +- Рефакторіть безперервно, а не великими порціями +- Завжди майте тести, що проходять, до та після +- Маленькі кроки: одна зміна за раз +- Поширені рефакторинги: Витягнути метод, Перейменувати, Перемістити, Вбудувати + +## Документація +- Самодокументований код > коментарі > зовнішня документація +- Публічні API потребують чіткої документації +- Включайте приклади в документацію +- Тримайте документацію близько до коду (ідеально — в коді) + +--- + +**Основна філософія**: Код читається в 10 разів частіше, ніж пишеться. Оптимізуйте для читабельності та підтримуваності, а не для хитрості. + +--- +**Останнє оновлення**: Квітень 2026 diff --git a/uk/resources.md b/uk/resources.md new file mode 100644 index 0000000..66ecd13 --- /dev/null +++ b/uk/resources.md @@ -0,0 +1,255 @@ + + + + + + + Claude How To + + +# Список корисних ресурсів + +## Офіційна документація + +| Ресурс | Опис | Посилання | +|--------|------|-----------| +| Claude Code Docs | Офіційна документація Claude Code | [code.claude.com/docs/en/overview](https://code.claude.com/docs/en/overview) | +| Anthropic Docs | Повна документація Anthropic | [docs.anthropic.com](https://docs.anthropic.com) | +| MCP Protocol | Специфікація Model Context Protocol | [modelcontextprotocol.io](https://modelcontextprotocol.io) | +| MCP Servers | Офіційні реалізації MCP-серверів | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) | +| Anthropic Cookbook | Приклади коду та туторіали | [github.com/anthropics/anthropic-cookbook](https://github.com/anthropics/anthropic-cookbook) | +| Claude Code Skills | Репозиторій навичок спільноти | [github.com/anthropics/skills](https://github.com/anthropics/skills) | +| Agent Teams | Координація та співпраця кількох агентів | [code.claude.com/docs/en/agent-teams](https://code.claude.com/docs/en/agent-teams) | +| Scheduled Tasks | Повторювані завдання з /loop та cron | [code.claude.com/docs/en/scheduled-tasks](https://code.claude.com/docs/en/scheduled-tasks) | +| Chrome Integration | Автоматизація браузера | [code.claude.com/docs/en/chrome](https://code.claude.com/docs/en/chrome) | +| Keybindings | Налаштування клавіатурних скорочень | [code.claude.com/docs/en/keybindings](https://code.claude.com/docs/en/keybindings) | +| Desktop App | Нативний десктопний додаток | [code.claude.com/docs/en/desktop](https://code.claude.com/docs/en/desktop) | +| Remote Control | Віддалене управління сесіями | [code.claude.com/docs/en/remote-control](https://code.claude.com/docs/en/remote-control) | +| Auto Mode | Автоматичне управління дозволами | [code.claude.com/docs/en/permissions](https://code.claude.com/docs/en/permissions) | +| Channels | Багатоканальна комунікація | [code.claude.com/docs/en/channels](https://code.claude.com/docs/en/channels) | +| Voice Dictation | Голосовий ввід для Claude Code | [code.claude.com/docs/en/voice-dictation](https://code.claude.com/docs/en/voice-dictation) | + +## Інженерний блог Anthropic + +| Стаття | Опис | Посилання | +|--------|------|-----------| +| Code Execution with MCP | Як вирішити проблему роздування контексту MCP за допомогою виконання коду — 98.7% зменшення токенів | [anthropic.com/engineering/code-execution-with-mcp](https://www.anthropic.com/engineering/code-execution-with-mcp) | + +--- + +## Опанування Claude Code за 30 хвилин + +_Відео_: https://www.youtube.com/watch?v=6eBSHbLKuN0 + +_**Усі поради**_ +- **Досліджуйте просунуті функції та скорочення** + - Регулярно перевіряйте нові функції редагування коду та контексту Claude в їхніх нотатках до випусків. + - Вивчіть клавіатурні скорочення для швидкого перемикання між чатом, файлами та редактором. + +- **Ефективне налаштування** + - Створюйте проєктно-специфічні сесії з чіткими назвами/описами для легкого пошуку. + - Закріпіть найчастіше використовувані файли або папки, щоб Claude мав до них доступ у будь-який час. + - Налаштуйте інтеграції Claude (напр., GitHub, популярні IDE) для оптимізації процесу кодування. + +- **Ефективне Q&A по кодовій базі** + - Ставте Claude детальні запитання про архітектуру, патерни проєктування та конкретні модулі. + - Використовуйте посилання на файли та рядки у запитаннях (напр., "Що робить логіка в `app/models/user.py`?"). + - Для великих кодових баз надайте резюме або маніфест, щоб допомогти Claude зосередитись. + - **Приклад промпту**: _"Can you explain the authentication flow implemented in src/auth/AuthService.ts:45-120? How does it integrate with the middleware in src/middleware/auth.ts?"_ + +- **Редагування та рефакторинг коду** + - Використовуйте інлайн-коментарі або запити в блоках коду для отримання цілеспрямованих правок ("Refactor this function for clarity"). + - Запитуйте порівняння до/після. + - Дозвольте Claude генерувати тести або документацію після значних правок для забезпечення якості. + - **Приклад промпту**: _"Refactor the getUserData function in api/users.js to use async/await instead of promises. Show me a before/after comparison and generate unit tests for the refactored version."_ + +- **Управління контекстом** + - Обмежуйте вставлений код/контекст лише тим, що стосується поточного завдання. + - Використовуйте структуровані промпти ("Here's file A, here's function B, my question is X") для найкращої продуктивності. + - Видаляйте або згортайте великі файли у вікні промпту, щоб не перевищувати ліміти контексту. + - **Приклад промпту**: _"Here's the User model from models/User.js and the validateUser function from utils/validation.js. My question is: how can I add email validation while maintaining backward compatibility?"_ + +- **Інтеграція командних інструментів** + - Підключайте сесії Claude до репозиторіїв та документації вашої команди. + - Використовуйте вбудовані шаблони або створюйте власні для повторюваних інженерних завдань. + - Співпрацюйте, діляться стенограмами сесій та промптами з колегами. + +- **Підвищення продуктивності** + - Давайте Claude чіткі, цілеорієнтовані інструкції (напр., "Summarize this class in five bullet points"). + - Видаляйте зайві коментарі та шаблонний код з вікон контексту. + - Якщо вивід Claude збився з курсу, скиньте контекст або переформулюйте запитання. + - **Приклад промпту**: _"Summarize the DatabaseManager class in src/db/Manager.ts in five bullet points, focusing on its main responsibilities and key methods."_ + +- **Практичні приклади використання** + - Дебаг: Вставте помилки та стек-трейси, потім запитайте можливі причини та виправлення. + - Генерація тестів: Запитайте property-based, юніт або інтеграційні тести для складної логіки. + - Код-рев'ю: Попросіть Claude виявити ризиковані зміни, граничні випадки або code smells. + - **Приклади промптів**: + - _"I'm getting this error: 'TypeError: Cannot read property 'map' of undefined at line 42 in components/UserList.jsx'. Here's the stack trace and the relevant code. What's causing this and how can I fix it?"_ + - _"Generate comprehensive unit tests for the PaymentProcessor class, including edge cases for failed transactions, timeouts, and invalid inputs."_ + - _"Review this pull request diff and identify potential security issues, performance bottlenecks, and code smells."_ + +- **Автоматизація робочих процесів** + - Скриптуйте повторювані завдання (форматування, очищення, перейменування) за допомогою промптів Claude. + - Використовуйте Claude для створення описів PR, нотаток до релізів або документації на основі git diff. + - **Приклад промпту**: _"Based on the git diff, create a detailed PR description with a summary of changes, list of modified files, testing steps, and potential impacts. Also generate release notes for version 2.3.0."_ + +**Порада**: Для найкращих результатів комбінуйте кілька цих практик — почніть з закріплення критичних файлів та резюмування цілей, потім використовуйте цілеспрямовані промпти та інструменти рефакторингу Claude для поступового покращення кодової бази та автоматизації. + + +**Рекомендований робочий процес з Claude Code** + +### Рекомендований робочий процес з Claude Code + +#### Для нового репозиторію + +1. **Ініціалізація репо та інтеграція Claude** + - Налаштуйте новий репозиторій з базовою структурою: README, LICENSE, .gitignore, кореневі конфіги. + - Створіть файл `CLAUDE.md` з описом архітектури, високорівневих цілей та настанов кодування. + - Встановіть Claude Code та підключіть до репозиторію для пропозицій коду, створення тестів та автоматизації. + +2. **Використовуйте режим плану та специфікації** + - Використовуйте режим плану (`shift-tab` або `/plan`) для створення детальної специфікації перед реалізацією. + - Запитайте Claude про пропозиції архітектури та початкове компонування проєкту. + - Тримайте чітку, цілеорієнтовану послідовність промптів — запитуйте контури компонентів, основні модулі та відповідальності. + +3. **Ітеративна розробка та рев'ю** + - Реалізуйте основні функції маленькими частинами, запитуючи Claude про генерацію коду, рефакторинг та документацію. + - Запитуйте юніт-тести та приклади після кожного інкременту. + - Підтримуйте поточний список завдань у CLAUDE.md. + +4. **Автоматизація CI/CD та деплою** + - Використовуйте Claude для створення каркасу GitHub Actions, npm/yarn скриптів або робочих процесів деплою. + - Легко адаптуйте конвеєри, оновлюючи CLAUDE.md та запитуючи відповідні команди/скрипти. + +```mermaid +graph TD + A[Start New Repository] --> B[Initialize Repository Structure] + B --> C[Create README, LICENSE, .gitignore] + C --> D[Create CLAUDE.md] + D --> E[Document Architecture & Guidelines] + E --> F[Install & Link Claude Code] + + F --> G[Enter Plan Mode] + G --> H[Draft Feature Specification] + H --> I[Get Architecture Suggestions] + I --> J[Define Components & Modules] + + J --> K[Implement Feature Chunk] + K --> L[Generate Code with Claude] + L --> M[Request Unit Tests] + M --> N[Review & Refactor] + N --> O{More Features?} + O -->|Yes| K + O -->|No| P[Update Task List in CLAUDE.md] + + P --> Q[Setup CI/CD Pipeline] + Q --> R[Scaffold GitHub Actions] + R --> S[Create Deployment Scripts] + S --> T[Test Automation] + T --> U[Repository Ready] + + style A fill:#e1f5ff + style G fill:#fff4e1 + style K fill:#f0ffe1 + style Q fill:#ffe1f5 + style U fill:#90EE90 +``` + +#### Для існуючого репозиторію + +1. **Налаштування репо та контексту** + - Додайте або оновіть `CLAUDE.md` з документацією структури репо, патернів кодування та ключових файлів. Для legacy-репозиторіїв використовуйте `CLAUDE_LEGACY.md` з описом фреймворків, карт версій, інструкцій, багів та нотаток оновлення. + - Закріпіть або виділіть основні файли, які Claude повинен використовувати для контексту. + +2. **Контекстне Q&A по коду** + - Запитуйте Claude про код-рев'ю, пояснення багів, рефакторинг або плани міграції з посиланням на конкретні файли/функції. + - Давайте Claude чіткі межі (напр., "modify only these files" або "no new dependencies"). + +3. **Управління гілками, worktree та кількома сесіями** + - Використовуйте кілька git worktree для ізольованих функцій або виправлень та запускайте окремі сесії Claude на кожен worktree. + - Тримайте вкладки/вікна терміналу організованими за гілкою або функцією для паралельних робочих процесів. + +4. **Командні інструменти та автоматизація** + - Синхронізуйте власні команди через `.claude/commands/` для крос-командної консистентності. + - Автоматизуйте повторювані завдання, створення PR та форматування коду через слеш-команди або хуки Claude. + - Діліться сесіями та контекстом з членами команди для спільного усунення проблем та рев'ю. + +```mermaid +graph TD + A[Start with Existing Repository] --> B{Legacy Codebase?} + B -->|Yes| C[Create CLAUDE_LEGACY.md] + B -->|No| D[Create/Update CLAUDE.md] + C --> E[Document Frameworks & Version Maps] + D --> F[Document Structure & Patterns] + E --> G[Pin Key Files for Context] + F --> G + + G --> H[Identify Task Type] + H --> I{Task Category} + I -->|Bug Fix| J[Ask Claude for Bug Analysis] + I -->|Code Review| K[Request Code Review] + I -->|Refactor| L[Plan Refactoring Strategy] + I -->|Migration| M[Create Migration Plan] + + J --> N[Set Explicit Boundaries] + K --> N + L --> N + M --> N + + N --> O{Multiple Features?} + O -->|Yes| P[Create Git Worktrees] + O -->|No| Q[Work on Main Branch] + P --> R[Launch Separate Claude Sessions] + R --> S[Organize Terminal Tabs] + Q --> S + + S --> T[Setup Team Automation] + T --> U[Sync .claude/commands/] + U --> V[Configure Slash Commands] + V --> W[Setup Hooks for Automation] + W --> X[Share Session Context with Team] + + X --> Y{More Tasks?} + Y -->|Yes| H + Y -->|No| Z[Workflow Complete] + + style A fill:#e1f5ff + style C fill:#ffecec + style D fill:#fff4e1 + style P fill:#f0ffe1 + style T fill:#ffe1f5 + style Z fill:#90EE90 +``` + +**Поради**: +- Починайте кожну нову функцію або виправлення зі специфікації та промпту в режимі плану. +- Для legacy та складних репозиторіїв зберігайте детальні настанови в CLAUDE.md/CLAUDE_LEGACY.md. +- Давайте чіткі, зосереджені інструкції та розбивайте складну роботу на багатофазні плани. +- Регулярно очищайте сесії, обрізайте контекст та видаляйте завершені worktree, щоб уникнути безладу. + +Ці кроки описують основні рекомендації для плавних робочих процесів з Claude Code як у нових, так і в існуючих кодових базах. + +--- + +## Нові функції та можливості (Березень 2026) + +### Ключові ресурси функцій + +| Функція | Опис | Дізнатися більше | +|---------|------|------------------| +| **Auto Memory** | Claude автоматично вивчає та запам'ятовує ваші уподобання між сесіями | [Посібник з пам'яті](02-memory/) | +| **Remote Control** | Програмне управління сесіями Claude Code із зовнішніх інструментів та скриптів | [Просунуті функції](09-advanced-features/) | +| **Web Sessions** | Доступ до Claude Code через браузерні інтерфейси для віддаленої розробки | [Довідник CLI](10-cli/) | +| **Desktop App** | Нативний десктопний додаток Claude Code з покращеним UI | [Claude Code Docs](https://code.claude.com/docs/en/desktop) | +| **Extended Thinking** | Перемикання глибокого мислення через `Alt+T`/`Option+T` або змінну `MAX_THINKING_TOKENS` | [Просунуті функції](09-advanced-features/) | +| **Permission Modes** | Тонке управління: default, acceptEdits, plan, auto, dontAsk, bypassPermissions | [Просунуті функції](09-advanced-features/) | +| **7-Tier Memory** | Managed Policy, Project, Project Rules, User, User Rules, Local, Auto Memory | [Посібник з пам'яті](02-memory/) | +| **Hook Events** | 25 подій: PreToolUse, PostToolUse, PostToolUseFailure, Stop, StopFailure, SubagentStart, SubagentStop, Notification, Elicitation та інші | [Посібник з хуків](06-hooks/) | +| **Agent Teams** | Координація кількох агентів для складних завдань | [Посібник з субагентів](04-subagents/) | +| **Scheduled Tasks** | Налаштування повторюваних завдань з `/loop` та cron | [Просунуті функції](09-advanced-features/) | +| **Chrome Integration** | Автоматизація браузера з headless Chromium | [Просунуті функції](09-advanced-features/) | +| **Keyboard Customization** | Налаштування клавіатурних скорочень включаючи chord-послідовності | [Просунуті функції](09-advanced-features/) | + +--- +**Останнє оновлення**: Квітень 2026