i18n(uk): add missing root files (CLAUDE.md, clean-code-rules, resources, etc.)

- Translate CLAUDE.md, clean-code-rules.md, resources.md - Translate pr-review plugin (README, commands, agents) - Translate documentation templates (ADR, api-endpoint, function-docs) - Copy RELEASE_NOTES.md, LICENSE, claude-howto-logo.png as-is - Update TRANSLATION_QUEUE.md to 100% Ref: luongnv89/claude-howto#63
2026-06-05 22:36:34 +02:00 · 2026-04-10 00:34:08 +03:00
parent 8438a0378a
commit 3f11521fcc
6 changed files with 563 additions and 0 deletions
@@ -0,0 +1,161 @@
+<!-- i18n-source: CLAUDE.md -->
+<!-- i18n-source-sha: 63a1416 -->
+<!-- i18n-date: 2026-04-10 -->
+
+# 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`
+
+Скоуп повинен відповідати назві папки де можливо.
@@ -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.
@@ -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
@@ -0,0 +1,115 @@
+<!-- i18n-source: clean-code-rules.md -->
+<!-- i18n-source-sha: 63a1416 -->
+<!-- i18n-date: 2026-04-10 -->
+
+# Правила чистого коду для 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
@@ -0,0 +1,255 @@
+<!-- i18n-source: resources.md -->
+<!-- i18n-source-sha: 63a1416 -->
+<!-- i18n-date: 2026-04-10 -->
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="resources/logos/claude-howto-logo-dark.svg">
+  <img alt="Claude How To" src="resources/logos/claude-howto-logo.svg">
+</picture>
+
+# Список корисних ресурсів
+
+## Офіційна документація
+
+| Ресурс | Опис | Посилання |
+|--------|------|-----------|
+| 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