feat(uk): translate P3 examples for modules 01, 02

01-slash-commands: 7 slash command examples 02-memory: 3 CLAUDE.md examples Progress: 25/67 files Ref: luongnv89/claude-howto#63
2026-06-05 22:36:34 +02:00 · 2026-04-09 22:31:43 +03:00
parent 2a27614770
commit 6172aacfd5
12 changed files with 1717 additions and 0 deletions
@@ -0,0 +1,29 @@
+---
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git diff:*)
+argument-hint: [message]
+description: Створити git-коміт з контекстом
+---
+
+## Контекст
+
+- Поточний статус git: !`git status`
+- Поточний git diff: !`git diff HEAD`
+- Поточна гілка: !`git branch --show-current`
+- Останні коміти: !`git log --oneline -10`
+
+## Ваше завдання
+
+На основі наведених вище змін створіть один git-коміт.
+
+Якщо повідомлення було передано через аргументи, використовуйте його: $ARGUMENTS
+
+Інакше проаналізуйте зміни та створіть відповідне повідомлення коміту відповідно до формату conventional commits:
+- `feat:` для нових функцій
+- `fix:` для виправлення помилок
+- `docs:` для змін документації
+- `refactor:` для рефакторингу коду
+- `test:` для додавання тестів
+- `chore:` для задач обслуговування
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,27 @@
+---
+name: Documentation Refactor
+description: Реструктуризація документації проєкту для ясності та доступності
+tags: documentation, refactoring, organization
+---
+
+# Рефакторинг документації
+
+Рефакторинг структури документації проєкту з адаптацією до типу проєкту:
+
+1. **Аналіз проєкту**: Визначити тип (бібліотека/API/веб-додаток/CLI/мікросервіси), архітектуру та персони користувачів
+2. **Централізація документації**: Перемістити технічну документацію до `docs/` з належними перехресними посиланнями
+3. **Кореневий README.md**: Оптимізувати як точку входу з оглядом, швидким стартом, резюме модулів/компонентів, ліцензією, контактами
+4. **Документація компонентів**: Додати README файли на рівні модулів/пакетів/сервісів з інструкціями налаштування та тестування
+5. **Організація `docs/`** за відповідними категоріями:
+   - Архітектура, Довідник API, База даних, Дизайн, Усунення несправностей, Деплой, Контрибʼюція (адаптувати до потреб проєкту)
+6. **Створення посібників** (оберіть застосовні):
+   - Посібник користувача: Документація для кінцевих користувачів додатків
+   - Документація API: Ендпоінти, автентифікація, приклади для API
+   - Посібник розробника: Налаштування, тестування, процес контрибʼюції
+   - Посібник деплою: Деплой на продакшн для сервісів/додатків
+7. **Використання Mermaid** для всіх діаграм (архітектура, потоки, схеми)
+
+Тримайте документацію лаконічною, зручною для сканування та контекстно відповідною типу проєкту.
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,22 @@
+---
+description: Створення вичерпної документації API з вихідного коду
+---
+
+# Генератор документації API
+
+Генерація документації API шляхом:
+
+1. Сканування всіх файлів у `/src/api/`
+2. Витягу сигнатур функцій та коментарів JSDoc
+3. Організації за ендпоінтом/модулем
+4. Створення markdown з прикладами
+5. Включення схем запитів/відповідей
+6. Додавання документації помилок
+
+Формат виводу:
+- Markdown-файл у `/docs/api.md`
+- Включити приклади curl для всіх ендпоінтів
+- Додати типи TypeScript
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,22 @@
+---
+description: Аналіз коду на проблеми продуктивності та пропозиції оптимізацій
+---
+
+# Оптимізація коду
+
+Перегляньте наданий код на наявність таких проблем у порядку пріоритету:
+
+1. **Вузькі місця продуктивності** — виявлення операцій O(n²), неефективних циклів
+2. **Витоки памʼяті** — пошук невивільнених ресурсів, циклічних посилань
+3. **Покращення алгоритмів** — пропозиція кращих алгоритмів або структур даних
+4. **Можливості кешування** — виявлення повторюваних обчислень
+5. **Проблеми конкурентності** — пошук станів гонки (race conditions) або проблем з потоками
+
+Формат відповіді:
+- Серйозність проблеми (Критична/Висока/Середня/Низька)
+- Місце в коді
+- Пояснення
+- Рекомендоване виправлення з прикладом коду
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,29 @@
+---
+description: Очистити код, підготувати зміни та створити pull request
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git diff:*), Bash(npm test:*), Bash(npm run lint:*)
+---
+
+# Контрольний список підготовки Pull Request
+
+Перед створенням PR виконайте ці кроки:
+
+1. Запустити лінтинг: `prettier --write .`
+2. Запустити тести: `npm test`
+3. Переглянути git diff: `git diff HEAD`
+4. Додати зміни до індексу: `git add .`
+5. Створити повідомлення коміту відповідно до conventional commits:
+   - `fix:` для виправлення помилок
+   - `feat:` для нових функцій
+   - `docs:` для документації
+   - `refactor:` для реструктуризації коду
+   - `test:` для додавання тестів
+   - `chore:` для обслуговування
+
+6. Згенерувати опис PR, що включає:
+   - Що змінилося
+   - Чому змінилося
+   - Проведене тестування
+   - Потенційні наслідки
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,155 @@
+---
+description: Додати всі зміни до індексу, створити коміт та відправити на віддалений сервер (використовуйте з обережністю)
+allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git push:*), Bash(git diff:*), Bash(git log:*), Bash(git pull:*)
+---
+
+# Коміт та Push усього
+
+⚠️ **УВАГА**: Додає ВСІ зміни до індексу, створює коміт та відправляє на віддалений сервер. Використовуйте лише коли впевнені, що всі зміни належать разом.
+
+## Робочий процес
+
+### 1. Аналіз змін
+Запустити паралельно:
+- `git status` — показати змінені/додані/видалені/невідстежувані файли
+- `git diff --stat` — показати статистику змін
+- `git log -1 --oneline` — показати останній коміт для стилю повідомлення
+
+### 2. Перевірки безпеки
+
+**❌ ЗУПИНИТИ та ПОПЕРЕДИТИ при виявленні:**
+- Секрети: `.env*`, `*.key`, `*.pem`, `credentials.json`, `secrets.yaml`, `id_rsa`, `*.p12`, `*.pfx`, `*.cer`
+- API-ключі: Будь-які змінні `*_API_KEY`, `*_SECRET`, `*_TOKEN` з реальними значеннями (не заповнювачі типу `your-api-key`, `xxx`, `placeholder`)
+- Великі файли: `>10MB` без Git LFS
+- Артефакти збірки: `node_modules/`, `dist/`, `build/`, `__pycache__/`, `*.pyc`, `.venv/`
+- Тимчасові файли: `.DS_Store`, `thumbs.db`, `*.swp`, `*.tmp`
+
+**Валідація API-ключів:**
+Перевірити змінені файли на патерни:
+```bash
+OPENAI_API_KEY=sk-proj-xxxxx  # ❌ Виявлено реальний ключ!
+AWS_SECRET_KEY=AKIA...         # ❌ Виявлено реальний ключ!
+STRIPE_API_KEY=sk_live_...    # ❌ Виявлено реальний ключ!
+
+# ✅ Допустимі заповнювачі:
+API_KEY=your-api-key-here
+SECRET_KEY=placeholder
+TOKEN=xxx
+API_KEY=<your-key>
+SECRET=${YOUR_SECRET}
+```
+
+**✅ Перевірити:**
+- `.gitignore` правильно налаштований
+- Немає конфліктів злиття
+- Правильна гілка (попередити якщо main/master)
+- API-ключі є лише заповнювачами
+
+### 3. Запит підтвердження
+
+Представити резюме:
+```
+📊 Резюме змін:
+- X файлів змінено, Y додано, Z видалено
+- Загалом: +AAA вставок, -BBB видалень
+
+🔒 Безпека: ✅ Без секретів | ✅ Без великих файлів | ⚠️ [попередження]
+🌿 Гілка: [назва] → origin/[назва]
+
+Я виконаю: git add . → commit → push
+
+Введіть 'yes' для продовження або 'no' для скасування.
+```
+
+**ЧЕКАТИ явного "yes" перед продовженням.**
+
+### 4. Виконання (після підтвердження)
+
+Запустити послідовно:
+```bash
+git add .
+git status  # Перевірка індексу
+```
+
+### 5. Генерація повідомлення коміту
+
+Проаналізувати зміни та створити conventional commit:
+
+**Формат:**
+```
+[тип]: Короткий опис (макс. 72 символи)
+
+- Ключова зміна 1
+- Ключова зміна 2
+- Ключова зміна 3
+```
+
+**Типи:** `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf`, `build`, `ci`
+
+**Приклад:**
+```
+docs: Update concept README files with comprehensive documentation
+
+- Add architecture diagrams and tables
+- Include practical examples
+- Expand best practices sections
+```
+
+### 6. Коміт та Push
+
+```bash
+git commit -m "$(cat <<'EOF'
+[Згенероване повідомлення коміту]
+EOF
+)"
+git push  # Якщо невдача: git pull --rebase && git push
+git log -1 --oneline --decorate  # Перевірка
+```
+
+### 7. Підтвердження успіху
+
+```
+✅ Успішно відправлено на віддалений сервер!
+
+Коміт: [хеш] [повідомлення]
+Гілка: [гілка] → origin/[гілка]
+Змінено файлів: X (+вставок, -видалень)
+```
+
+## Обробка помилок
+
+- **git add невдача**: Перевірити дозволи, заблоковані файли, переконатися що репо ініціалізовано
+- **git commit невдача**: Виправити pre-commit хуки, перевірити git config (user.name/email)
+- **git push невдача**:
+  - Non-fast-forward: `git pull --rebase && git push`
+  - Немає віддаленої гілки: `git push -u origin [гілка]`
+  - Захищена гілка: Використати PR-процес замість цього
+
+## Коли використовувати
+
+✅ **Доцільно:**
+- Оновлення документації в кількох файлах
+- Функція з тестами та документацією
+- Виправлення помилок у кількох файлах
+- Форматування/рефакторинг всього проєкту
+- Зміни конфігурації
+
+❌ **Уникати:**
+- Невпевненість у тому, що комітиться
+- Містить секрети/чутливі дані
+- Захищені гілки без рев'ю
+- Присутні конфлікти злиття
+- Потрібна гранулярна історія комітів
+- Pre-commit хуки не проходять
+
+## Альтернативи
+
+Якщо користувач хоче більше контролю, запропонувати:
+1. **Вибіркове додавання**: Переглянути/додати конкретні файли
+2. **Інтерактивне додавання**: `git add -p` для вибору патчів
+3. **PR-процес**: Створити гілку → push → PR (використати команду `/pr`)
+
+**⚠️ Памʼятайте**: Завжди переглядайте зміни перед push. Якщо сумніваєтесь, використовуйте окремі git-команди для більшого контролю.
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,28 @@
+---
+name: Setup CI/CD Pipeline
+description: Реалізація pre-commit хуків та GitHub Actions для забезпечення якості
+tags: ci-cd, devops, automation
+---
+
+# Налаштування CI/CD пайплайну
+
+Реалізація комплексних шлюзів якості DevOps з адаптацією до типу проєкту:
+
+1. **Аналіз проєкту**: Визначити мову(и), фреймворк, систему збірки та наявний інструментарій
+2. **Налаштування pre-commit хуків** з інструментами для конкретної мови:
+   - Форматування: Prettier/Black/gofmt/rustfmt/тощо
+   - Лінтинг: ESLint/Ruff/golangci-lint/Clippy/тощо
+   - Безпека: Bandit/gosec/cargo-audit/npm audit/тощо
+   - Перевірка типів: TypeScript/mypy/flow (якщо застосовно)
+   - Тести: Запуск відповідних тестових наборів
+3. **Створення GitHub Actions workflows** (.github/workflows/):
+   - Дзеркалювання pre-commit перевірок на push/PR
+   - Матриця версій/платформ (якщо застосовно)
+   - Верифікація збірки та тестів
+   - Кроки деплою (за потреби)
+4. **Верифікація пайплайну**: Тестування локально, створення тестового PR, підтвердження проходження всіх перевірок
+
+Використовуйте безкоштовні/відкриті інструменти. Поважайте існуючі конфігурації. Тримайте виконання швидким.
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,28 @@
+---
+name: Expand Unit Tests
+description: Збільшення покриття тестами шляхом тестування невідстежених гілок та граничних випадків
+tags: testing, coverage, unit-tests
+---
+
+# Розширення юніт-тестів
+
+Розширення існуючих юніт-тестів з адаптацією до тестового фреймворку проєкту:
+
+1. **Аналіз покриття**: Запустити звіт покриття для виявлення неперевірених гілок, граничних випадків та зон з низьким покриттям
+2. **Виявлення прогалин**: Переглянути код на предмет логічних гілок, шляхів помилок, граничних умов, null/порожніх вхідних даних
+3. **Написання тестів** з використанням фреймворку проєкту:
+   - Jest/Vitest/Mocha (JavaScript/TypeScript)
+   - pytest/unittest (Python)
+   - Go testing/testify (Go)
+   - Rust test framework (Rust)
+4. **Цільові сценарії**:
+   - Обробка помилок та виключень
+   - Граничні значення (мін/макс, порожні, null)
+   - Крайні та кутові випадки (edge/corner cases)
+   - Переходи станів та побічні ефекти
+5. **Верифікація покращення**: Запустити покриття повторно, підтвердити вимірюване збільшення
+
+Представляти лише нові блоки тестового коду. Дотримуватися існуючих патернів та конвенцій іменування тестів.
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,64 @@
+# Стандарти модуля API
+
+Цей файл перевизначає кореневий CLAUDE.md для всього у /src/api/
+
+## Специфічні стандарти API
+
+### Валідація запитів
+- Використовувати Zod для валідації схем
+- Завжди валідувати вхідні дані
+- Повертати 400 з помилками валідації
+- Включати деталі помилок на рівні полів
+
+### Автентифікація
+- Усі ендпоінти вимагають JWT-токен
+- Токен у заголовку Authorization
+- Токен закінчується через 24 години
+- Реалізувати механізм refresh-токенів
+
+### Формат відповіді
+
+Усі відповіді мають дотримуватися цієї структури:
+
+```json
+{
+  "success": true,
+  "data": { /* фактичні дані */ },
+  "timestamp": "2025-11-06T10:30:00Z",
+  "version": "1.0"
+}
+```
+
+Відповіді з помилками:
+```json
+{
+  "success": false,
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Повідомлення для користувача",
+    "details": { /* помилки полів */ }
+  },
+  "timestamp": "2025-11-06T10:30:00Z"
+}
+```
+
+### Пагінація
+- Використовувати пагінацію на основі курсора (не зсуву/offset)
+- Включати булеве поле `hasMore`
+- Максимальний розмір сторінки: 100
+- Розмір сторінки за замовчуванням: 20
+
+### Обмеження частоти запитів (Rate Limiting)
+- 1000 запитів на годину для автентифікованих користувачів
+- 100 запитів на годину для публічних ендпоінтів
+- Повертати 429 при перевищенні
+- Включати заголовок retry-after
+
+### Кешування
+- Використовувати Redis для кешування сесій
+- Тривалість кешу: 5 хвилин за замовчуванням
+- Інвалідувати при операціях запису
+- Тегувати ключі кешу типом ресурсу
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,63 @@
+# Мої уподобання розробки
+
+## Про мене
+- **Рівень досвіду**: 8 років full-stack розробки
+- **Бажані мови**: TypeScript, Python
+- **Стиль комунікації**: Прямий, з прикладами
+- **Стиль навчання**: Візуальні діаграми з кодом
+
+## Уподобання коду
+
+### Обробка помилок
+Я віддаю перевагу явній обробці помилок з блоками try-catch та змістовними повідомленнями.
+Уникайте загальних помилок. Завжди логуйте помилки для налагодження.
+
+### Коментарі
+Коментарі для ЧОМУ, а не ЩО. Код має бути самодокументованим.
+Коментарі мають пояснювати бізнес-логіку або неочевидні рішення.
+
+### Тестування
+Я віддаю перевагу TDD (розробка через тестування).
+Спочатку писати тести, потім реалізацію.
+Фокус на поведінці, а не деталях реалізації.
+
+### Архітектура
+Я віддаю перевагу модульному, слабкоповʼязаному дизайну.
+Використовувати впровадження залежностей (dependency injection) для тестовності.
+Розділення відповідальностей (Controllers, Services, Repositories).
+
+## Уподобання налагодження
+- Використовувати console.log з префіксом: `[DEBUG]`
+- Включати контекст: назву функції, відповідні змінні
+- Використовувати стеки викликів (stack traces), коли доступні
+- Завжди включати мітки часу в журналах
+
+## Комунікація
+- Пояснювати складні концепції діаграмами
+- Показувати конкретні приклади перед поясненням теорії
+- Включати фрагменти коду до/після
+- Підсумовувати ключові моменти наприкінці
+
+## Організація проєкту
+Я організовую проєкти так:
+```
+project/
+  ├── src/
+  │   ├── api/
+  │   ├── services/
+  │   ├── models/
+  │   └── utils/
+  ├── tests/
+  ├── docs/
+  └── docker/
+```
+
+## Інструментарій
+- **IDE**: VS Code з vim-клавішами
+- **Термінал**: Zsh з Oh-My-Zsh
+- **Форматування**: Prettier (довжина рядка 100 символів)
+- **Лінтер**: ESLint з конфігурацією airbnb
+- **Тестовий фреймворк**: Jest з React Testing Library
+
+---
+**Останнє оновлення**: 9 квітня 2026
@@ -0,0 +1,91 @@
+# Конфігурація проєкту
+
+## Огляд проєкту
+- **Назва**: Платформа електронної комерції
+- **Технологічний стек**: Node.js, PostgreSQL, React 18, Docker
+- **Розмір команди**: 5 розробників
+- **Дедлайн**: Q4 2025
+
+## Архітектура
+@docs/architecture.md
+@docs/api-standards.md
+@docs/database-schema.md
+
+## Стандарти розробки
+
+### Стиль коду
+- Використовувати Prettier для форматування
+- Використовувати ESLint з конфігурацією airbnb
+- Максимальна довжина рядка: 100 символів
+- Використовувати відступ 2 пробіли
+
+### Конвенції іменування
+- **Файли**: kebab-case (user-controller.js)
+- **Класи**: PascalCase (UserService)
+- **Функції/Змінні**: camelCase (getUserById)
+- **Константи**: UPPER_SNAKE_CASE (API_BASE_URL)
+- **Таблиці БД**: snake_case (user_accounts)
+
+### Git-процес
+- Назви гілок: `feature/description` або `fix/description`
+- Повідомлення комітів: дотримуватися conventional commits
+- PR обовʼязковий перед злиттям
+- Усі CI/CD перевірки мають пройти
+- Мінімум 1 затвердження (approval) обовʼязкове
+
+### Вимоги до тестування
+- Мінімум 80% покриття коду
+- Усі критичні шляхи мають мати тести
+- Використовувати Jest для юніт-тестів
+- Використовувати Cypress для E2E-тестів
+- Назви тестових файлів: `*.test.ts` або `*.spec.ts`
+
+### Стандарти API
+- Лише RESTful ендпоінти
+- JSON запит/відповідь
+- Правильно використовувати HTTP-статус-коди
+- Версіонування API-ендпоінтів: `/api/v1/`
+- Документувати всі ендпоінти з прикладами
+
+### База даних
+- Використовувати міграції для змін схеми
+- Ніколи не зашивати облікові дані в код
+- Використовувати пул зʼєднань (connection pooling)
+- Увімкнути логування запитів у середовищі розробки
+- Регулярне резервне копіювання обовʼязкове
+
+### Деплой
+- Деплой на основі Docker
+- Оркестрація Kubernetes
+- Стратегія blue-green деплою
+- Автоматичний відкат при невдачі
+- Міграції БД виконуються перед деплоєм
+
+## Типові команди
+
+| Команда | Призначення |
+|---------|-------------|
+| `npm run dev` | Запуск сервера розробки |
+| `npm test` | Запуск тестового набору |
+| `npm run lint` | Перевірка стилю коду |
+| `npm run build` | Збірка для продакшну |
+| `npm run migrate` | Запуск міграцій БД |
+
+## Контакти команди
+- Техлід: Sarah Chen (@sarah.chen)
+- Продакт-менеджер: Mike Johnson (@mike.j)
+- DevOps: Alex Kim (@alex.k)
+
+## Відомі проблеми та обхідні рішення
+- Пул зʼєднань PostgreSQL обмежений до 20 у пікові години
+- Обхідне рішення: реалізувати чергу запитів
+- Проблеми сумісності Safari 14 з async generators
+- Обхідне рішення: використовувати транспілятор Babel
+
+## Повʼязані проєкти
+- Аналітична панель: `/projects/analytics`
+- Мобільний додаток: `/projects/mobile`
+- Адмін-панель: `/projects/admin`
+
+---
+**Останнє оновлення**: 9 квітня 2026